← ClaudeAtlas

consolidate-commentslisted

Run a `comment` consolidation pass over in-code comments — delete what a stranger to the module could rebuild from the file, strip stale fragments (ticket ids, dates, chronicle), condense under the owner's standing ruling, freeze and escalate everything else — through a script-owned record, script-applied edits and replay gates. Use at feature or epic completion, or on entry into brainstorming on a previously-touched area, between implementation phases.
StefanoZaghi1987/ClaudeSkills · ★ 2 · AI & Automation · score 73
Install: claude install-skill StefanoZaghi1987/ClaudeSkills
# `comment` consolidation pass **Truth source:** the code in the repository. External truth is a stop condition: the unit is *frozen* byte-for-byte, escalated through the intake, and the pass moves on. **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 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, `B` is the batch id (`B-<n>`) and `T` the target-set file. `S…` citations point into `~/.claude/documentation-lifecycle.md`; read only the section cited. `ADR NNNN` is `~/.claude/documentation-lifecycle-adr/NNNN-*.md`. ## When