Content
65%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 well-structured, tool-specific orchestration guide with concrete parameter guidance and clear phase sequencing. Its main weaknesses are missing validation checkpoints in the batch workflow and referenced bundle files that do not exist, undermining both executability and progressive disclosure.
Suggestions
Add explicit validation checkpoints between phases (e.g., "Verify gene IDs resolved before Phase 2", "Confirm disease type classified before Phase 3 routing") with error-recovery feedback loops.
Provide the referenced bundle files (TOOLS_REFERENCE.md, SCORING_REFERENCE.md, REPORT_TEMPLATE.md, EXAMPLES.md, QUICK_START.md) or inline the critical scoring matrices so the 0-100 score can actually be computed.
Include at least one concrete Python example for the "COMPUTE, DON'T DESCRIBE" section to make the analysis step copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, information-rich bullet/table format that mostly assumes Claude's competence; minor over-explanation remains (e.g., the opening "Stratification means splitting patients into groups..." definition and some redundant KEY PRINCIPLES framing) that could be trimmed. | 4 / 5 |
Actionability | Concrete tool names with specific parameter gotchas (e.g., "MyGene_query_genes: param is `query` (NOT `q`)"), inline score-component ranges and risk-tier table; gaps are the absence of any executable code examples and the reliance on referenced scoring matrices that are not present in the bundle. | 4 / 5 |
Workflow Clarity | Nine phases are clearly sequenced with numbered steps, but this batch/multi-tool workflow lacks explicit inter-phase validation checkpoints or error-recovery feedback loops (only implicit guidance like "LOOK UP DON'T GUESS"), capping it at 3 per the batch-operations rule. | 3 / 5 |
Progressive Disclosure | A well-signaled one-level-deep reference section lists TOOLS_REFERENCE.md, SCORING_REFERENCE.md, REPORT_TEMPLATE.md, EXAMPLES.md, QUICK_START.md, but none of these bundle files actually exist, so the disclosure leads to dead ends rather than accessible detail. | 3 / 5 |
Total | 14 / 20 Passed |