What problem does it solve? Project knowledge decays: session discoveries vanish when conversations end, documentation indexes drift as files move, and no single file reflects a component's current behavior after dozens of specs. This Skill keeps a project's durable knowledge healthy across four modes without polluting the repo with low-signal noise. ## Core Features & Use Cases - Capture mode: Converts ephemeral session discoveries into durable artifacts (docs-index entries, ADR drafts, rules.yml invariants, conventions patches) with a maximum of 3 drafts and granular Plan-mode approval; AI-drafted ADRs always stay Proposed. - Audit mode: Read-only periodic scan of docs-index.yml detecting orphans, stale entries, duplicates, and uncovered docs, producing a health score and reports. - Stats mode: Reads per-epic build metrics from build-metrics.jsonl and applies the Spec Planning Gate reading, with optional baseline reconstruction. - Reconcile/characterize mode: Lazily backfills one component's living-behavior file in docs/05-specs/_current/ from its completed specs, or characterizes it read-only from code for adopted projects. - Use Case: After closing an epic that revealed an undocumented invariant, run capture to draft a rules.yml entry and ADR, approve them in Plan mode, and have them committed with telemetry logged. ## Quick Start Ask the AI to run the knowledge skill in capture mode to turn this session's discoveries into durable documentation artifacts for review.
