Content
50%Reviews 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 with useful tables and a clear 8-phase workflow, but it over-explains known biology, defers complete code to a non-existent phase_details.md, and lacks inline validation checkpoints. Addressing these would lift it from adequate to strong.
Suggestions
Trim or remove the 'Domain Reasoning' section — it explains biology concepts Claude already knows; keep only the actionable 'LOOK UP DON'T GUESS' guidance.
Add inline validation checkpoints between workflow phases (e.g., after Phase 2 assert common_samples >= 10; after Phase 4 flag genes with |r| below a computed threshold) rather than relying on a post-hoc 'Quantified Minimums' table.
Either ship phase_details.md as a bundle file or inline the complete correlation/clustering code — currently the body defers to phase_details.md, which does not exist, leaving code fragments incomplete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient tables and code, but the 'Domain Reasoning' section explains biology Claude already knows (concordant/discordant mRNA-protein, post-transcriptional regulation via miRNA/degradation), which is unnecessary padding. | 2 / 3 |
Actionability | Provides some concrete code (match_samples_across_omics, a spearmanr loop) but several blocks are incomplete fragments, and complete implementations are deferred to a phase_details.md that is not present in the bundle. | 2 / 3 |
Workflow Clarity | The 8 phases are clearly sequenced, but there are no inline validation checkpoints between phases; the 'Quantified Minimums' table is a post-hoc checklist rather than feedback loops, capping clarity at 2 for a batch analytical operation. | 2 / 3 |
Progressive Disclosure | Sections are well-organized with clearly signaled one-level-deep references to phase_details.md, but that referenced file does not exist in the bundle, so the disclosure points to missing detail. | 2 / 3 |
Total | 8 / 12 Passed |