Content
71%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, evidence-obsessed workflow skill: every phase names its output files, formats, and verification gates. Its weaknesses are structural — an 840-line monolith with inlined templates that belong in reference files, a duplicated/out-of-order Phase 6, repeated backlog rules, and time-stamped/mixed-language headings that add tokens and confusion.
Suggestions
Merge the Phase 6 stub (line 626) into the real Handoff Ritual section and renumber so phases read in execution order (Phase 7 currently precedes the Phase 6 content); drop the '(added 2026-04-20)' changelog date from the heading.
Move the artifact templates (Epic frontmatter, FEATURE spec skeleton, Codebase-Verifikation block, SC table format, BACKLOG row schema) into one-level-deep reference files under references/ and keep SKILL.md as the phase walkthrough that links to them.
State the backlog Status/Phase/last-change rules once — currently they appear in both the 'MANDATORY: Backlog as single source of truth' section and Phase 5 — and normalize the mixed German/English headings (e.g. 'Graph-Konsistenz-Check', 'Kriterium (observable)', 'Refinement-Bedarf') to one language.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient project-specific rules with little explanation of concepts Claude already knows, but there is real tightening to do: Phase 6 appears twice (a "Handoff Ritual (moved, see below)" stub at line 626 and the real content at line 728), backlog status/phase rules are stated in the MANDATORY section and again in Phase 5, and time-stamped detail like "Phase 7: Codebase-Verification Gate (added 2026-04-20)" plus mixed German/English headings ("Graph-Konsistenz-Check", "Verifikations-Befund", "Kriterium (observable)") add tokens without adding instruction. Anti-drift check: anchor 2 would require 'several unnecessary explanations or padded sections' — the content is dense rather than padded — so 3 is the best fit. | 3 / 5 |
Actionability | Guidance is fully concrete and executable: exact artifact paths ("_devprocess/requirements/handoff/plan-context.md", "ADR-{XXX}-{slug}.md"), copy-paste frontmatter blocks for each artifact, shell commands ("mkdir -p {ROOT}/{analysis,...}"; "git for-each-ref --format='%(refname:short)' refs/heads/"; "python3 tools/renumber-for-merge.py --target <re-branch> --source-ref \"$B\" --list-conflicts"), a canonical commit message, and a filled-in example SC table showing exactly what to write. Anti-drift check: anchor 4 ('minor gaps') would apply if key formats were left abstract, but every phase has its output format fully specified. | 5 / 5 |
Workflow Clarity | The V-walk is explicitly sequenced (Phase -1 through 9) with validation checkpoints and feedback loops: "Verify before filing... drop the finding if the target is already satisfied", Phase 7's codebase-verification gate, Phase 8's consistency check, and "Fix any failed gate before running the Handoff Ritual". However the phase numbering is incoherent in places — Phase 6 is declared out of order (stub between 5 and 7, real content after Phase 9) and Phase 7 carries a changelog date in its heading — which keeps it below a 5. Anti-drift check: anchor 3 requires missing or implicit checkpoints, but validation here is explicit and layered; the defect is sequencing, matching anchor 4's 'minor gaps'. | 4 / 5 |
Progressive Disclosure | The file has clear section structure and signals external material by path ("skills/project-conventions/SKILL.md#canonical-specs", "skills/requirements-engineering/templates/BACKLOG-TEMPLATE.md", "tools/migration/*.py"), but no bundle files exist and everything else is inlined in a ~840-line monolith: full Epic/FEATURE frontmatter templates, the SC table format, the Codebase-Verifikation block, and the backlog row schema are exactly the material that belongs in one-level-deep reference files. Anti-drift check: anchor 2 ('minimal structure') is too harsh given the consistent headers and signaled references; anchor 4 requires 'most content appropriately placed', which the inlined templates contradict. | 3 / 5 |
Total | 15 / 20 Passed |