OlympHill
developer-documentation-instincts (Grade A) logo

developer-documentation-instincts (Grade A)Security-tested data-ai skill for Claude AI. Grade A. DOCUMENTATION INSTINCTS — extracted from roles.json deepPrompt for developer

(0)
Daniel NikulshynReviewed by Daniel Nikulshyn·Updated July 2026

Overview

This skill encodes a behavioral procedure for developers to follow when documenting code. It was extracted from the developer role's deepPrompt and aims to preserve the imperative voice and structure of the original content. The procedure emphasizes writing clear and concise documentation that explains the 'why' behind the code, not just what it does. It provides guidelines for writing effective README files, inline comments, and encourages a documentation-driven development approach.

Key features

  • Guidelines for writing effective README files
  • Best practices for inline comments
  • Emphasis on explaining the 'why' behind the code
  • Encourages a documentation-driven development approach

Pricing

Model
Free
Category
Skills
Rating
No reviews yet

Use cases

New Project Development

Write a clear README file before starting to code to ensure a well-defined project design and to surface potential problems early.

Code Review

Use the skill's guidelines to write effective inline comments that explain non-obvious decisions, such as performance trade-offs or security decisions.

Pros & Cons

Pros

  • Encourages writing clear and concise documentation
  • Emphasizes explaining the 'why' behind the code
  • Provides guidelines for effective README files and inline comments
  • Promotes a documentation-driven development approach

Cons

  • May require additional effort to write documentation upfront
  • Could be challenging to strike a balance between concise and detailed comments

Reviews

Sign in to leave a review.

No reviews yet. Be the first!

Q&A

Which local models should I run, and how does hardware affect SecureContext?

SecureContext degrades gracefully by hardware tier — every LLM-powered layer fails closed (the feature quietly contributes nothing) rather than breaking ingest or search. What changes with hardware is how much of the intelligence stack is active: | Tier | Hardware | Models that fit | What you get | |---|---|---|---| | Minimum | Any CPU, ~2 GB RAM free | nomic-embed-text (embeddings only) | Hybrid BM25+vector search, working memory, audit chain, skills gating — the core. LLM layers (event extraction, entity extraction, contradiction adjudication) stay dormant. | | Mid | 8–16 GB GPU (or Apple Silicon 16 GB+) | + qwen2.5-coder:14b or phi4:14b (one at a time) | + Event-fact extraction at ingest (temporal reasoning), LLM contradiction adjudication, entity extraction, L0/L1 semantic file summaries. | | Full | 24 GB+ GPU (e.g. RTX 4090/5090) | + phi4:14b and gpt-oss:20b resident together | Everything, concurrently, at interactive latency — plus a strong local generator for QA/benchmarks. This is the configuration our published benchmark deltas were measured on. Model-choice guidance (all measured, see bench/): Embeddings: nomic-embed-text — required, tiny, runs anywhere. Event extraction (ZCEVENTEXTRACTMODEL, default phi4:14b): our bakeoff scored phi4:14b at 100% event recall / 100% date accuracy, tying gpt-oss:20b at 2× the speed. On smaller GPUs qwen2.5-coder:14b is close behind (84.6% recall). Coder models ≠ better: qwen2.5-coder:32b scored worst (69.2%) despite being the large

Asked by Jovana Petrovic · Nov 16, 2025

What do I need to run it?

Node 20+ and (recommended) Docker for the bundled PostgreSQL + Ollama stack. The one-command installer does everything in about five minutes. A SQLite fallback runs with zero infrastructure.

Asked by Kenji Watanabe · Nov 9, 2025

Can multiple Claude Code sessions work on the same project without conflicts?

Yes — parallel sessions atomically claim tasks from a work-stealing queue (zero double-claims at 50 agents × 100 tasks in testing), coordinate through typed broadcasts (ASSIGN/STATUS/MERGE/REJECT), and keep private per-agent memory namespaces plus a shared pool. Department-style hierarchies (heads + workers, N-tier escalation) are supported for larger agent teams.

Asked by Tomáš Novák · Oct 31, 2025

Are Claude Code skills safe to install?

Filesystem skills bundle scripts that run with your permissions, and Claude Code's native loader does not scan them. SecureContext adds the missing gate: AST scan at admission, HMAC verification before every execution, automatic quarantine on failure or post-admission change, and a verifiable chained log of every admission decision.

Asked by Wolfgang Krause · Oct 24, 2025

Does SecureContext send my code or data to the cloud?

No. Memory, embeddings (Ollama nomic-embed-text), search, summarization, and the audit chain all run locally. It works fully offline (search degrades gracefully to keyword-only if Ollama is down) and costs $0 when idle.

Asked by Marcus Bell · Oct 19, 2025

Ask a question

Skills alternatives

Manage Headers (Grade A) logo

Manage Headers (Grade A)

Skills

Security-tested development skill for Claude AI. Grade A. Inspects and configures the security headers a Power Pages site sends to browsers — Content Security Policy, frame and clickjacking protection

(0)
Free
Using Git Worktrees (Grade A) logo

Using Git Worktrees (Grade A)

Skills

Security-tested data-ai skill for Claude AI. Grade A. Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktre

(0)
Free
Ga4 Bigquery Schema (Grade A) logo

Ga4 Bigquery Schema (Grade A)

Skills

Security-tested data-ai skill for Claude AI. Grade A. GA4 BigQuery Export Schema Reference — complete field reference, nested structures, query patterns, and performance tips

(0)
Free
Meta Capi (Grade A) logo

Meta Capi (Grade A)

Skills

Security-tested data-ai skill for Claude AI. Grade A. Meta Conversions API (CAPI) Setup Reference — architecture, event types, customer information hashing, deduplication, implementation examples, AEM

(0)
Free
Callees (Grade A) logo

Callees (Grade A)

Skills

Security-tested development skill for Claude AI. Grade A. Lista o que uma funcao/metodo chama (call graph direto)

(0)
Free
Test Module Name (Grade A) logo

Test Module Name (Grade A)

Skills

Security-tested data-ai skill for Claude AI. Grade A. Name Haskell test modules after the module under test with a Spec suffix in the same namespace. Use when writing or reviewing Haskell test module

(0)
Free
Board Of Directors (Grade A) logo

Board Of Directors (Grade A)

Skills

Security-tested data-ai skill for Claude AI. Grade A. Simulate a 5-member expert board deliberation for major decisions. Use when evaluating plans, architecture choices, feature designs, or any decisi

(0)
Free
Advpl Mvc Avancado (Grade A) logo

Advpl Mvc Avancado (Grade A)

Skills

Security-tested development skill for Claude AI. Grade A. MVC avançado via PE (Pontos de Entrada) — adicionar grids customizadas em telas MVC padrão (CNTA300/MATA070/MATA440/MATA460/FINA040 via *STRU)

(0)
Free