Content
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise and well-organized with clear use/non-use sections, but it stays at the directive level without executable code or explicit validation checkpoints, and its single referenced bundle file does not actually exist. Strengthening actionability and fixing the broken reference would lift the weakest dimensions.
Suggestions
Add at least one concrete, executable example (e.g. a small before/after refactor snippet or a command like running the test suite after each slice).
Make the validation loop explicit: 'run tests; if failing, fix and re-run; only proceed when green' rather than the implicit Safety note.
Fix the broken reference — create resources/implementation-playbook.md or correct the path so the signaled progressive-disclosure file actually exists.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: short bulleted sections, no padding, no explanation of concepts Claude already knows, and every line earns its place; the brief restatement of the persona is the only mild excess. | 3 / 3 |
Actionability | It lists useful directive steps ('Assess code smells', 'Apply changes in small slices') but provides no concrete code, commands, or worked example — it describes the process rather than giving executable guidance, matching the score-2 anchor. | 2 / 3 |
Workflow Clarity | The Instructions are sequenced but there are no explicit validation checkpoints; the Safety note 'ensure tests pass' is implicit rather than a structured validate->fix->retry loop, so per the rubric this stays at 2. | 2 / 3 |
Progressive Disclosure | It signals a one-level-deep reference (resources/implementation-playbook.md) for detail, which is good structure, but that referenced file does not exist in the bundle — the path is also inconsistent (body says 'resources/' while the path uses 'resources/'), so navigation is not cleanly realized. | 2 / 3 |
Total | 9 / 12 Passed |