Content
82%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 a highly actionable, well-sequenced reference with concrete tool calls, thresholds, and a validation checklist, scoring at the top of the actionability dimension. Its main weakness is mild verbosity from duplicated facts and bulk reference data inlined rather than split into separate files.
Suggestions
De-duplicate the HPA 10-supported-cell-line list (Phase 2B and Error Handling) and the Chronos < -0.5 threshold (Phase 3 prose and the bundled-script note) — state each once and reference back.
Move the large Phase 0 tool-parameter table and the Quick Reference cancer-type table into separate reference files under ./references/, leaving concise summaries inline with clear links, to improve progressive disclosure.
Add an explicit validate→fix→retry loop for the bundled depmap_gene_dependency.py invocation (e.g., on download/cache failure, fall back to cBioPortal + the Quick Reference table) to push workflow clarity to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean reference material and concrete tool calls with little conceptual padding, but the HPA 10-line list appears twice (Phase 2B and Error Handling) and Chronos < -0.5 thresholds are repeated, so minor trimming is possible. | 4 / 5 |
Actionability | Fully executable guidance throughout — exact tool calls with real parameters, a concrete study ID (ccle_broad_2019), a runnable bundled script with copy-paste bash, numeric decision thresholds, and a scoring matrix — covering the common cases via the patterns and Quick Reference tables. | 5 / 5 |
Workflow Clarity | A clear five-phase sequence with per-phase GOAL/OUTPUT, a Completeness Checklist validation checkpoint, and an Error Handling table; not a 5 because per-step validate→fix→retry feedback loops are less explicit than the anchor-5 example. | 4 / 5 |
Progressive Disclosure | One well-signaled, real bundle reference (scripts/depmap_gene_dependency.py, which exists) at one level deep, but the large inlined tool-parameter table and cancer-type Quick Reference could arguably live in separate reference files — good structure with minor organization gaps. | 4 / 5 |
Total | 17 / 20 Passed |