← ClaudeAtlas

vaultspec-adrlisted

Record a new or changed costly decision after checking accepted decision coverage and sufficient Research, Reference, or Audit evidence.
nevenincs/vaultspec-core · ★ 2 · Testing & QA · score 66
Install: claude install-skill nevenincs/vaultspec-core
# ADR (vaultspec-adr) Records one costly decision. Apply the coverage and approval contract in the vaultspec system section before creating a record. Reuse an accepted ADR unchanged when it covers the work, including across features; return its stem without drafting a duplicate. ## Steps - Discover governing decisions across features and read them whole, then their evidence. Classify the need as unchanged reuse, amendment, supersession, or a distinct decision. - Confirm sufficient Research, Reference, or Audit evidence. Gather missing evidence through `vaultspec-research` for option research or `vaultspec-code-research` for code patterns. Do not copy an adequate Audit into a new Research merely for its type. - For a new decision, scaffold: `vaultspec-core vault add adr --feature {feature} --related <evidence-stem>` (or `create`). Read `.vaultspec/templates/adr.md`. - Draft the decision, or dispatch `vaultspec-adr-researcher` with the existing evidence and requested decision scope; it returns content for persistence. - For an amendment, preserve accepted content while proposing the revision separately. Follow the system's pending-proposal procedure if it must survive handoff. - For a reversal, draft the successor first. After its content is authorized, set it `accepted`, then run `vaultspec-core vault adr supersede OLD --by NEW`. - Verify with `vaultspec-core vault check all`. Present the record and authorization basis. If authorization is missing, ask and