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.
The content is well-structured, actionable, and concise with explicit safety/validation gates and sensible deferral of advanced detail to the external package. Main room for improvement is turning the run flow into an explicit numbered checklist with error-recovery feedback loops.
Suggestions
Add a numbered 'How a generation runs' checklist (mutate one surface file -> sandbox -> run tests -> score -> archive only if improved) with an explicit 'if tests fail, discard' feedback loop to push workflow_clarity toward 5.
Trim the benchmark section to a brief summary and move the full evidence/numbers to the referenced LEARNINGS.md/RESULTS.md to tighten conciseness.
Surface the most common selection/flag combinations inline as one-line examples rather than only deferring them to @metaharness/darwin.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence; the benchmark section conveys measured, harness-specific empirical findings rather than padding, fitting 'efficient; minor instances of over-explanation that could be trimmed'. | 4 / 5 |
Actionability | Copy-paste-ready commands ('npm run evolve', 'npm run evolve:dry', 'npx metaharness-darwin evolve . --sandbox real --generations 3 --children 4') cover common cases, matching 'mostly executable guidance; concrete commands with minor gaps' on the advanced flags. | 4 / 5 |
Workflow Clarity | The mutate->sandbox->score->archive sequence is clear and validation gates are explicit (validateGeneratedCode, sandbox, tests-pass, measured-improvement), fitting 'clear sequence with most checkpoints present'; not 5 because the user-facing run flow is not a numbered checklist with error-recovery feedback loops. | 4 / 5 |
Progressive Disclosure | Around 50 lines with well-organized sections that defer advanced detail (selection strategies, benchmark evidence) to the external @metaharness/darwin package, matching 'good structure; references mostly clear'; no local bundle files exist to push it to 5. | 4 / 5 |
Total | 16 / 20 Passed |