Content
78%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 strong, highly actionable body with executable code at every step, a clear numbered workflow, and practical troubleshooting — the main defects are orphaned bundle files that the body never points to, and moderate duplication between the step-by-step walkthrough, the complete script, and the unlinked reference file. Signaling the existing references/ and scripts/ files would fix both structure and redundancy.
Suggestions
Add explicit pointers to the existing bundle files, e.g., under Velocity Models Comparison: 'See [references/velocity_models.md](references/velocity_models.md) for the mathematical framework and parameter details' and under the workflow: 'A validated, ready-to-run version is at [scripts/rna_velocity_workflow.py](scripts/rna_velocity_workflow.py)'.
Collapse the 8-step walkthrough and the 'Complete Workflow Script' into one canonical flow (or move the full script section into scripts/ and summarize it in the body) to remove duplicated preprocessing/velocity code.
Move the Velocity Models Comparison table and the fit_* output-field details into references/velocity_models.md, keeping only a compact summary in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by dense, executable code and reference tables with little filler, matching the efficient-with-minor-trim-instances anchor. The Overview paragraph explaining mRNA splicing biology and the duplication between the 8-step walkthrough and the 'Complete Workflow Script' (plus the Velocity Models table duplicating references/velocity_models.md) are the over-explanation instances that keep it below the every-token-earns-its-place anchor at 5. | 4 / 5 |
Actionability | Every section provides copy-paste-ready, fully executable code with real parameters (scv.pp.filter_and_normalize(adata, min_shared_counts=20), scv.tl.recover_dynamics(adata, n_jobs=4), concrete plotting calls) plus a complete runnable pipeline function, matching the fully-executable/covers-common-cases anchor. It is not score 4 because there are no gaps — installation, loading, preprocessing, both model modes, and all downstream visualizations are concrete. | 5 / 5 |
Workflow Clarity | The workflow is clearly sequenced as numbered steps 1-8 with layer verification at setup (print(adata) with expected-structure comments), sanity checks in Best Practices, and a Troubleshooting table providing problem-to-solution feedback; this matches the clear-sequence/most-checkpoints anchor. It is not 5 because validation between intermediate steps is implicit rather than explicit (e.g., no checkpoint that velocity genes or fit_likelihood look sane before downstream analysis), and not 3 because checkpoints and error-recovery guidance are present, just unevenly distributed. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned internally, but neither bundle file is referenced anywhere — references/velocity_models.md (168 lines of model math) and scripts/rna_velocity_workflow.py (240-line validated pipeline with asserts) are orphaned from navigation, and the inline Velocity Models Comparison table duplicates the reference file. This matches the some-structure/references-not-clearly-signaled/content-that-should-be-separate-is-inline anchor; it is not 2 because the body itself has clear headers and is not a monolithic wall of text, and not 4 because a key structural duty (linking the existing deeper material) is entirely missing. | 3 / 5 |
Total | 16 / 20 Passed |