Content
61%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 concise and well-structured with a clear workflow, but its actionability is undermined by a broken core tool: the bundled search.py hard-fails on every invocation because the referenced data/ui-reasoning.csv is missing and loaded unconditionally. Validation checkpoints are also absent.
Suggestions
Bundle the missing data/ui-reasoning.csv (or lazy-load it only for --design-system) so the documented search.py commands actually execute instead of crashing with FileNotFoundError.
Move the load_rules() call in main() inside the --design-system branch so --domain and --stack modes work even when the CSV is absent.
Add a validation/error-recovery checkpoint (e.g., verify the helper output is non-empty before synthesizing, and handle a missing CSV gracefully) to raise workflow clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-organized with no explanation of concepts Claude already knows; sections, command blocks, and bullet lists each earn their place and assume Claude's competence. | 5 / 5 |
Actionability | The commands appear copy-paste ready, but every documented invocation crashes: search.py unconditionally loads the referenced data/ui-reasoning.csv (line 237) which is absent from the bundle, so even --domain/--stack modes fail with FileNotFoundError, leaving the core workflow non-executable. | 2 / 5 |
Workflow Clarity | A clear five-step sequence is present (infer shape, generate design system, pull targeted guidance, add stack guidance, synthesize), but there are no validation or error-recovery checkpoints and no guidance for handling the script's failure modes. | 3 / 5 |
Progressive Disclosure | Good overview structure with one-level-deep references clearly signaled in the References section (USAGE.md, search.py, ui-reasoning.csv); the gap is that one referenced path (data/ui-reasoning.csv) does not exist in the bundle. | 4 / 5 |
Total | 14 / 20 Passed |