testsAndMisc/docs/superpowers/contracts/prose-files-under-cap-2026-08-16.json
Krzysztof kuhy Rudnicki 346eb1f00b Bring every markdown file under the cap
Twelve prose violations to zero. Eight files split into per-topic
subdirectories with the original left as an index; both SKILL.md files
keep their frontmatter so discovery still works, with detail moved to
references/.

Deleted docs/cleanup-2026-05/ (7 files) and linux_configuration/docs/
VERIFICATION.md on the user's ruling: unreferenced records of finished
work whose rules are now enforced by the polling, shellcheck and shfmt
hooks. PACMAN_WRAPPER_SECURITY.md was split instead - unlike those, it
documents live guarantees.

Every split verified by a sorted diff against HEAD: zero content lines
lost, only the new headings and index links added.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011w2Pj4Ek3ZNMQVYcFHgXDY
2026-08-16 19:25:59 +02:00

19 lines
1.6 KiB
JSON

{
"title": "Bring every markdown file under the 250-line cap",
"objective": "Clear all twelve over-cap prose files, by splitting genuine reference material and deleting completion reports whose guidance is now enforced by hooks, per decision 5.",
"acceptance_criteria": [
"bash ~/utils/scripts/check_file_length.sh --all lists no .md file anywhere in the repo.",
"For every file that is SPLIT rather than deleted, no content line is lost: a sorted diff of the original against the concatenated parts shows only additions (the new headings and index links).",
"The two SKILL.md files keep their YAML frontmatter and description in place, so skill discovery still works; the detail moves to references/ subdirectories.",
"Deletions are limited to unreferenced records of completed work whose rules are enforced elsewhere. Nothing referenced by a live doc, hook or script is deleted.",
"No dangling links remain: a repo-wide grep for the deleted paths returns nothing outside append-only evidence and contract artifacts.",
"No suppression is added and no file is exempted from the cap."
],
"out_of_scope": [
"The remaining shell and source-code violations, which are separate commits.",
"Rewriting or condensing prose that is still current; splitting preserves it verbatim.",
"docs/superpowers/plans/** and sessions/**, which are already exempt."
],
"verifier": "bash ~/utils/scripts/check_file_length.sh --all showing no .md entry, plus a per-file sorted diff against git HEAD proving zero lines lost for each split, plus a repo-wide grep for the deleted paths, plus pre-commit run --files."
}