Content
75%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.
Highly actionable content with executable code, concrete commands, and a sequenced QC-first workflow with validation guards. The main weaknesses are over-explanation of biology Claude already knows and a dangling analysis_patterns.md reference whose file is absent from the bundle.
Suggestions
Trim the biology rationale under 'WHY each metric flags a problem' and the Reasoning Framework to the non-obvious decisions only; Claude already knows why mitochondrial leakage indicates stress.
Create references/analysis_patterns.md (referenced three times in the decision tree and Reference Documentation) or repoint those links to an existing file so all referenced paths resolve.
Collapse the Scanpy vs Seurat equivalents table into the seurat_workflow.md reference, since it is lookup material rather than workflow guidance Claude needs inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient code-and-table content, but several sections explain biology Claude already knows (e.g., why high mito implies a dying cell via membrane rupture, ribo being cell-type-specific) and the Reasoning Framework and Scanpy-vs-Seurat table restate well-known concepts, fitting the score-3 anchor of mostly efficient with some unnecessary explanation. | 3 / 5 |
Actionability | Copy-paste-ready code blocks for loading, QC metrics, the full pipeline, DE, statistics, and Harmony, plus concrete CLI invocations (python scripts/scrna_qc.py --install-plan, the tu run run_deseq2_analysis command) covering the common cases as required by the score-5 anchor. | 5 / 5 |
Workflow Clarity | A clear decision tree sequences QC -> Normalize -> HVG -> PCA -> Cluster -> Annotate -> DE with explicit validation checkpoints (Rule Zero pre-computed check, 'HONEST EXECUTION' install-plan guard, 'Never report cutoffs you did not actually run'), but a few checkpoints are implicit rather than enumerated validate->fix->retry loops, so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | Good one-level-deep structure: the body is an overview pointing to eight real references/ files (scanpy_workflow, scrna_qc, etc.) and scripts/ with clear signaling, but it references analysis_patterns.md which does not exist in references/, and one reference path is inconsistent, leaving minor organization gaps at the score-4 level. | 4 / 5 |
Total | 16 / 20 Passed |