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.
The body is well-structured, token-efficient, and uses progressive disclosure effectively with verified reference files. Its main gap is actionability: the workflow and validation guidance is abstract and lacks the specific commands or examples needed to execute design-system checks.
Suggestions
Add concrete validation commands (e.g. the actual repo design-system check script or test invocation) to the Validation section instead of the generic "run the smallest command or test".
Furnish at least one executable example in the Workflow or Examples section, such as a token-layer lookup command or a sample contract.yaml snippet showing a token resolution.
Consolidate overlapping guidance across Philosophy, Avoid, and Anti-Patterns to remove redundancy and tighten the token budget further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean bullet-list of directives with no padding or explanation of concepts Claude already knows, though Philosophy and Anti-Patterns overlap somewhat with Avoid/Constraints and could be trimmed. | 4 / 5 |
Actionability | Guidance is directional and concrete in places ("Start with 2-3 focused surfaces", "identify the layer") but lacks specific commands or code, and Validation only says "run the smallest command" without naming the actual checks. | 3 / 5 |
Workflow Clarity | The Workflow section gives a clear sequenced set of steps and the Validation section supplies a fail-fast checkpoint with a feedback loop, though checkpoints live in a separate section rather than inline in the sequence. | 4 / 5 |
Progressive Disclosure | A dedicated Progressive Disclosure section points to real one-level-deep references (references/contract.yaml, evals.yaml, task-profile.json, all present) plus clearly signaled deferred-context paths, giving easy navigation from an overview. | 5 / 5 |
Total | 16 / 20 Passed |