← ClaudeAtlas

vaultspec-curatelisted

Reconcile the ADR architecture corpus against the codebase and the feature lifecycle documents against the single-home-fact boundary. Use to audit ADR status and supersession, find ADR-vs-ADR, ADR-vs-code, and document-vs-document conflicts (restated grounding, displaced decisions, forked facts), and action them. Mechanical .vault/ hygiene is the CLI's job; this skill does the semantic reconciliation the CLI cannot.
nevenincs/vaultspec-core · ★ 2 · Testing & QA · score 68
Install: claude install-skill nevenincs/vaultspec-core
# ADR architecture reconciliation skill (vaultspec-curate) This skill terminates within one run. It keeps the architecture decision record (ADR) corpus and the code it governs a single, curated, internally-consistent set of decisions. It reconciles each decision's declared status and supersession against reality, finds where decisions contradict each other or the codebase, and actions the result: propagating status, amending wording, and surfacing gaps, conflicts, and errors that need human judgment. It also enforces the document boundary - each fact has one home: research grounds, the ADR decides, audits find - across a feature's lifecycle documents: an ADR restating its grounding's evidence, a research or audit body recording a decision, and the same fact forked across documents are curation findings with defined actions. Mechanical `.vault/` hygiene belongs to the `vaultspec-core` CLI (the `vaultspec-cli` rule). This skill judges what no check can decide: whether an `accepted` decision is implemented, whether two ADRs disagree, and whether a superseded decision still governs the code. ## Preconditions (cede the mechanical layer first) Reconciliation reasons over a structurally-correct corpus and a populated semantic index. Before any semantic work: - **Structural hygiene to the CLI.** Run `vaultspec-core vault check all --fix`. This repairs frontmatter, links, names, stamps, and template drift. Never hand-fix these. - **Ensure the semantic index is live.** `vaultsp