← ClaudeAtlas

consolidate-specslisted

Run a `document` or `severance` consolidation pass over specs and design docs — realign a document to the code it describes, relocate historical rationale to an ADR, hand unresolvable statements to a person through a `## To be confirmed` section, or sever inbound references to a document being excluded from retrieval. Use at feature or epic completion, on entry into brainstorming on a previously-touched area, or as phase one of an exclusion. Never mid-implementation.
StefanoZaghi1987/ClaudeSkills · ★ 1 · AI & Automation · score 72
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 produces the classification, rewrites what is verifiable, and hands over a `## To be confirmed` section (`S127`). Reasoning for every cited entry is in `~/.claude/documentation-lifecycle.md`. This file is procedure. It cites; it does not explain. **Read before running:** the preconditions `S1`–`S3` and the first-shipment prerequisite set `S167` are stated in the companion. `S3` is the one most likely to be silently assumed here: a `severance` pass requires a reviewer who is not its author, and where no second reviewer exists the `severance` half of this skill does not run at all. Where any prerequisite is absent, this pass runs with a named control missing and says which. --- ## Implementation — the best-effort runner This skill ships a runner: `scripts/consolidate_specs.py` (stdlib-only Python 3). Invoke any gate as `python "<this skill's directory>/scripts/consolidate_specs.py" <gate>`. If `python` is not on PATH (common on Linux), use `python3`. Each script the procedure names is a subcommand: `target-set`, `record-check`, `coverage-check`, `scope-cross-check`, `baseline-ancestry-check`, `bound-check`, `removal-authorization-check`, `floor-staleness-check`, `escalate`. `target-set` takes `--pass-kind document|severance`. Run `… self-test` to verify the install. The ga