Content
65%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable executable code with good section organization and useful troubleshooting, but it is token-heavy and fails to leverage the provided bundle scripts, inlining implementations that should be referenced. Workflow checkpoints are implicit rather than explicit.
Suggestions
Replace the inline implementations with concise summaries that point to the existing bundle scripts (e.g. 'See scripts/simulate_pcr.py — run: python scripts/simulate_pcr.py --template …'), cutting hundreds of lines.
Add explicit validation checkpoints to the workflows (e.g. after Golden Gate design: 'verify overhangs unique and non-palindromic before ordering primers; re-run if violations') to form validate→fix→retry loops.
Tighten redundant sections — the Quick Start and Typical Workflows overlap with the Core Capabilities examples — to recover context budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~660 lines with seven full inline Python implementations, much of which duplicates the bundled scripts in ./scripts/, so it could be tightened substantially; it avoids score 1 because it does not explain basic concepts Claude already knows — the verbosity is domain code, not fluff. | 2 / 3 |
Actionability | Code is fully executable and copy-paste ready using real Biopython (Bio.Restriction, SeqUtils.MeltingTemp) and primer3-py APIs with concrete examples, matching the score-3 anchor for specific executable guidance rather than pseudocode. | 3 / 3 |
Workflow Clarity | Three 'Typical Workflows' are sequenced with concrete code and a Troubleshooting section offers error-recovery pairs, but there are no explicit validate→fix→retry checkpoints or checklists for the design operations, so it sits at score 2 rather than 3. | 2 / 3 |
Progressive Disclosure | Sections are well organized, but ~500 lines of full implementations are inlined while five real bundle scripts exist in ./scripts/ (simulate_pcr.py, design_crispr.py, design_primers.py, golden_gate.py, restriction_digest.py) and are never referenced from the body — the classic score-2 pattern of content that should be separate being inline with bundle references not signaled. | 2 / 3 |
Total | 9 / 12 Passed |