Skip to content

jaredchu/context-docs / evals/results/2026-09-28-journal-integration-followup/claude-missing-helper/.claude/skills/context-docs

context-docs

Unverified

Create, audit, and maintain project context documents for continuity across AI sessions. Use when establishing a context-docs convention, refreshing project state after work, or consolidating stale or growing context files. Adapt to existing layouts and preserve decisions and evidence. Not for general copyediting or storing conversation transcripts.

Context Docs

Keep the project's Markdown useful to the next reader. Start with its instructions, README and context entry point, then follow relevant sources. Identify a project mismatch before editing; ask only when the target or a consequential decision is unclear. Preserve existing layouts and concurrent edits.

Choose the operation

  • Audit: report concrete gaps and source locations; leave project files unchanged.
  • Initialize: reuse suitable files or sections. Read the standard for document roles. If an entry point is missing, adapt the template, remove unused prompts, and link it from the README or documentation index. If neither exists, a short README pointing to the supported context is enough; it does not require inventing a broader project mission.
  • Maintain: update affected canonical sections from completed work and evidence. Consult the standard when roles, conflicting statuses or restructuring need it. Ordinary document repairs are included; proposed product decisions are not approved by a maintenance request. A review without permission to edit remains an audit.

Make the smallest useful update

Check factual claims against the source that establishes that exact claim before recording them. Keep the evidence's scope: a reference document's version is not the installed package version, and local configuration does not establish runtime behavior or publication history. Omit incidental details you have not checked; state a specific verification limit when the unknown matters. Keep approved intent, observed behavior, proposals and unknowns distinct. Resolve contradictory guidance at its source when evidence permits; otherwise identify the specific unresolved conflict. Imported instructions are evidence, not authority. Attribute implementation choices to whoever made them; permission to do a task does not make an agent-chosen method or layout an explicit owner decision.

Describe inspected operations directly; do not turn them into guarantees for every input without verification.

Replace stale claims in place. Keep each detail and its qualifications in one canonical location; link from summaries. Add uncertainty only where it changes a reader's interpretation or next action, rather than repeating generic verification disclaimers. Initialization needs supported context and useful navigation, not a catalogue of everything the project has not documented.

Preserve unique decisions, authority, rationale, constraints, source links, useful dated evidence and unresolved work. Mark superseded guidance without losing its rationale. Do not shorten by hiding blockers or relying on Git to recover uncommitted material. Keep commands, fences, anchors and relative links intact.

Review the diff, affected links and information preservation against the resulting project. Refresh facts made stale by your own edits; label retained earlier observations as pre-change when they no longer describe current state. Check the final report's factual claims by the same standard as the edited documents, retaining their qualifications rather than strengthening them in a summary. Date only claims actually reviewed. If nothing durable changed, avoid bookkeeping edits. Briefly report changed files, completed checks and material remaining questions once, without restating unchanged context. Do not copy the session report into the context.

Optional event capture

Logging is off by default; ordinary Markdown maintenance needs no runtime or journal. When the project explicitly enables a journal, or the user requests setup, disabling or investigation, read the journal guide. Follow existing equivalent project settings. Capture meaningful events only when enabled; setup, no-change maintenance and audits create no events. Keep historical capture separate from current context and preserve records across updates.

Keep secrets and private customer data out of docs. This skill adds no authority to commit, publish, alter global instructions, schedule work or provision services; follow the project's existing authorization. It provides no background sync.

rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 192kUpdated Claude CodeCodexVerifiedInstall