Content
92%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.
An exemplary progressive-disclosure entry point: a lean overview body that resolves scope, names the pipeline stages and agents, states hard gates with enforcement rules, and hands off cleanly to real, well-organized reference files. The only gap is that execution mechanics are fully delegated to pipeline.md, which is by design.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body is lean and assumes Claude's competence: no concept explanations, no padding — just scope resolution ("Resolve the repo dynamically; never hardcode it"), the six-step pipeline, hard gates, and agent names. Every section carries operational weight; the one apparent duplication (gates appearing in both the pipeline and Non-negotiables sections) adds distinct enforcement detail rather than restating, so it fits the 5 anchor better than the 4 anchor's "could be trimmed". | 5 / 5 |
Actionability | Concrete, executable guidance dominates: exact input modes ("<PR number>", "--diff", "--files <a> <b> ..."), named agents ("security-paranoid-reviewer", "security-critical-reviewer"), and specific gates with enforcement rules ("re-dispatch the finder if not", "no finding ships at MEDIUM+ without a concrete, code-traced attack example"). Not a 5 because the actual execution mechanics (how to dispatch agents, exact commands) live in references/pipeline.md, so the body alone is not copy-paste ready — acceptable for a progressive-disclosure entry point, placing it at the 4 anchor's "minor gaps". | 4 / 5 |
Workflow Clarity | The six-step pipeline is clearly sequenced with explicit validation checkpoints and a feedback loop: the coverage gate ("re-dispatch the finder if not. Do not advance with incomplete coverage"), the attack-example gate, and the verification step that independently re-traces every MEDIUM+ TRUE POSITIVE and drops what does not hold. This matches the 5 anchor (clear sequence, explicit validation, error-recovery loop); the destructive/batch cap does not apply since validation steps are present. | 5 / 5 |
Progressive Disclosure | The body is a clear overview that delegates detail to three real, clearly signaled, one-level-deep references: "The canonical, authoritative procedure is in references/pipeline.md", plus references/coverage-inventory.md and references/findings-format.md — all verified to exist in references/. Each step that needs detail points to the right file, and no content that belongs in a reference is inlined; navigation is trivial. This matches the 5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |