← ClaudeAtlas

consolidate-specslisted

Run a `document` or `severance` consolidation pass over specs and design docs — realign each statement to the code by editing the sentence, relocate decision history to an ADR, strip stale fragments, condense under the owner's standing ruling, and hand every statement the code cannot settle to the owner through an in-session panel and a `## To be confirmed` section; or sever inbound references to a document being excluded. Script-owned record, script-applied edits, replay gates. Use at feature or epic completion, on entry into brainstorming on a previously-touched area, or as phase one of an exclusion.
StefanoZaghi1987/ClaudeSkills · ★ 2 · AI & Automation · score 73
Install: claude install-skill StefanoZaghi1987/ClaudeSkills
# Spec and design-doc consolidation **Pass kinds:** `document` and `severance`. **Truth source:** the code **plus** business rules outside the repository. External truth is work to be arbitrated: the pass classifies, rewrites what the code verifies, and hands the rest to the owner. **Single writer.** You own the baseline, the gates, the intake, the owner panel and every commit. The script owns unit identity, the record and every file edit, ADR files and `## To be confirmed` items included. You write judgement in *judgement files* (`.j`); `record-fill` writes it into the record, and the runner writes the files. Workers you dispatch only read and fill their own `.j` file. **Batch.** Every pass is a *batch*: one *master record* classified once, one owner panel, then review units the runner cuts under the caps and runs one at a time. A small pass is a batch of one unit; there is no second procedure. Runner: `python "<this skill's directory>/scripts/consolidate.py" <command>` — Python 3.12 or newer; where `python` is absent or older, `python3` on Linux and macOS, `py -3` on Windows. Run it, and every line it prints, with the Bash tool — Git Bash on Windows — never PowerShell or cmd; run from anywhere inside the repository. What the runner keeps never passes through the shell: it writes the target set itself, and the owner's words go in a file (ADR 0028). Below, `K` is the pass kind, `B` the batch id (`B-<n>`) and `T` the target-set file. `S…` citations point into `~/.claude/do