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.
Well-structured, lean, action-oriented quality checklist with clear sequencing and feedback loops. Only minor gap is the generic Step 3 command placeholder.
Suggestions
In Step 3, replace the generic instruction with a concrete example command for running lint/type-check/tests, or point to where the project's command set is defined.
Optionally note how to discover the project's actual lint/test commands if they vary, so Claude does not guess.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and checklist-driven with no padding; assumes Claude's competence and avoids explaining concepts Claude already knows. | 5 / 5 |
Actionability | Concrete executable commands (git diff, get_context.py, grep) plus specific checklists, but Step 3's 'Run the project's lint, type-check, and test commands' is left generic rather than giving the specific command(s). | 4 / 5 |
Workflow Clarity | Clearly sequenced six-step flow with explicit feedback loops (fix then re-run project checks; stop-vs-fix decision rules in Step 6) covering a destructive-adjacent verification task. | 5 / 5 |
Progressive Disclosure | Single-level overview well-organized into labeled steps pointing to external spec files at .trellis/spec/<package>/<layer>/index.md; no nesting and references are clearly signaled. | 5 / 5 |
Total | 19 / 20 Passed |