Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a well-organized agent prompt with a clear six-step workflow and named tools, but it is padded with persona fluff, lacks executable examples, and has no validation checkpoints or external reference structure. These keep it at the mid-level anchor across all four dimensions.
Suggestions
Remove or tighten the persona preamble ('expertise spans multiple programming languages with deep knowledge...') so every line earns its place for token efficiency.
Add at least one concrete, executable command example (e.g., a sample Grep/ast-grep/jscpd invocation with flags and expected output) to move from described guidance to copy-paste-ready actionability.
Introduce an explicit validation/checkpoint step in the workflow (e.g., confirm findings against project conventions in AGENTS.md before reporting) and consider moving the examples block to a referenced file to improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly task-oriented but opens with persona padding Claude already knows ('expertise spans multiple programming languages with deep knowledge of software architecture principles and best practices'), fitting the 'mostly efficient but includes some unnecessary explanation' anchor rather than the lean level-3 anchor. | 2 / 3 |
Actionability | It names concrete tools (Grep, ast-grep, jscpd) and one parameter ('--min-tokens 50'), but provides no executable or copy-paste-ready commands/examples, matching the 'some concrete guidance but incomplete' anchor and falling short of the fully executable level-3 anchor. | 2 / 3 |
Workflow Clarity | The six-step workflow (broad search → compile list → anti-patterns → naming → duplication → architecture) is clearly sequenced, but there are no explicit validation checkpoints or feedback loops, fitting the 'steps listed but validation gaps' anchor rather than the checkpointed level-3 anchor. | 2 / 3 |
Progressive Disclosure | The body is sectioned into responsibilities, workflow, and deliverables, but it is a monolithic single file over 50 lines with no external references and inline content (e.g., the examples block) that could be split out, matching the 'some structure but content that should be separate is inline' anchor. | 2 / 3 |
Total | 8 / 12 Passed |