← 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 · ★ 1 · Testing & QA · score 67
Install: claude install-skill nevenincs/vaultspec-core
# ADR architecture reconciliation skill (vaultspec-curate) **Announce at start:** "I'm using the `vaultspec-curate` skill to reconcile the ADR architecture corpus against the codebase." This skill 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 - frontmatter, wiki-links, filenames, tag pairs, template compliance - is no longer this skill's work. The `vaultspec-core` CLI owns it deterministically. This skill spends its judgment on what no check can decide: whether an `accepted` decision is actually implemented, whether two ADRs disagree, and whether a superseded decision still governs the code. ## When to use - Periodically, to keep the ADR corpus a trustworthy map of the architecture. - After a feature lands, to confirm the decisions it claimed are reflected in the c