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.
A thorough, well-structured analysis workflow with concrete output templates and a clear seven-step sequence. Its main weaknesses are repeated content that bloats token usage and a lack of validation checkpoints in the workflow.
Suggestions
Add validation checkpoints to the workflow, e.g. after scanning for duplications add a step to 'Verify candidate patterns are genuine duplications (not coincidental similarity) before cataloging them', and a review gate before emitting refactoring suggestions.
Deduplicate detection criteria — the 'Analysis criteria' in step 2 and the 'Code duplication detection' heuristics cover the same ground; consolidate into one place to tighten the token budget.
Move the detailed pattern-entry, refactoring-suggestion, and template-code format blocks into a separate references file (e.g. references/FORMATS.md) and summarize them inline, improving progressive disclosure and conciseness.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient actionable content (templates, formats, heuristics) without over-explaining basic concepts, but detection criteria are restated across steps 2 and the heuristics section and the categorization is repeated, so it could be tightened; not severe enough for a 2, not lean enough for a 4. | 3 / 5 |
Actionability | Provides concrete copy-pasteable templates (pattern entry format, refactoring suggestion format, output structure) plus a real executable fetch example, but the template-code section uses placeholder skeletons (param1/param2, [N]) rather than fully realized examples, leaving minor gaps. | 4 / 5 |
Workflow Clarity | The seven steps are clearly numbered and sequenced, but there are no validation or verification checkpoints (e.g., confirming detected patterns are genuine, reviewing findings with the user before recommending refactors), so it matches the 'sequence present but checkpoints missing' anchor. | 3 / 5 |
Progressive Disclosure | Well-organized single file with clear section headers and no nested or buried references, but at ~210 lines with several inlined format templates and heuristics that could live in separate reference files, it has minor organization gaps rather than the ideal split structure of a 5. | 4 / 5 |
Total | 14 / 20 Passed |