Content
86%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 and highly actionable, with concrete commands, a clear workflow, and properly signaled references to real bundle files. The only slack is some duplication of the distinctiveness framing and a long inlined forcing-question library.
Suggestions
Collapse the 'Distinct from' table or the frontmatter distinction so the neighbor comparison lives in one place, saving tokens.
Add an explicit validate→retry checkpoint in the main Workflow (e.g. 'if saturation_planner flags the method as low-confidence, re-frame the goal before proceeding') to reach the top workflow_clarity anchor.
Consider moving the forcing-question library into a references file and keeping a one-line pointer, since it is the longest inlined section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and largely assumes Claude's competence (no explanation of what research is), but the 'Distinct from' table duplicates the frontmatter distinction and the forcing-question library is fairly long, so minor trimming is possible. | 4 / 5 |
Actionability | Provides copy-paste-ready, fully executable commands for every tool — e.g. 'study_designer.py --goal {discovery|evaluative|validation} --stage ... --profile ...', 'saturation_planner.py --method {usability|thematic|evaluative-coverage} --segments N', and '--sample' quick examples covering the common cases. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (Frame → Pick method → Size → Synthesize → File) with checkpoints (honor the redirect, record the confidence label, treat ANECDOTE flags as signals), but no explicit validate→fix→retry feedback loop in the main workflow, so it sits just below the top anchor. | 4 / 5 |
Progressive Disclosure | Clean overview with one-level-deep, clearly signaled references to verified bundle files (three references/*.md with one-line descriptions, scripts in a table, assets/research_plan_template.md), all of which exist on disk. | 5 / 5 |
Total | 18 / 20 Passed |