Content
53%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 well-structured overview with strong progressive disclosure to real reference files, but it is held back by a broken raw-image code example, duplicated percentage guidance, missing validation for batch operations, and two ghost script references.
Suggestions
Fix the raw-image example: count_cells_in_image does not exist in scripts/segment_cells.py — replace it with the actual count_cells_watershed or count_cells_basic signature so the example is executable.
De-duplicate the 'relative proportion -> percentage' guidance, which appears as both the top CRITICAL section and an Answer Formatting subsection; keep a single authoritative version.
Add validation checkpoints for batch/destructive operations (e.g., verify segmentation output before batch processing) and remove the two non-existent script references (colony_morphometry.py, statistical_comparison.py) from the References section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with useful tables and a decision tree, but the 'relative proportion -> percentage' guidance is duplicated (CRITICAL section and Answer Formatting subsection) and the abstract 'Core Principles' list pads, so it could be tightened. | 3 / 5 |
Actionability | Contains substantial executable code (Phase 0, imports, R-to-Python equivalents, formatting), but the flagship raw-image example imports count_cells_in_image, a function that does not exist in scripts/segment_cells.py, so the copy-paste example fails. | 3 / 5 |
Workflow Clarity | A clear sequence exists (RULE ZERO -> decision tree -> phases), but there are no validation/feedback checkpoints, and batch operations (batch_process.py) lack validation, capping this at 3 per the batch-operations rule. | 3 / 5 |
Progressive Disclosure | Good one-level-deep structure with well-signaled .md references that all resolve, but the References section lists two non-existent scripts (colony_morphometry.py, statistical_comparison.py) and troubleshooting.md is unreferenced. | 4 / 5 |
Total | 13 / 20 Passed |