Content
60%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, actionable, and clearly sequenced evaluation workflow with real, well-signaled reference files. Its main weakness is verbosity — repeated restatements across the philosophy, steps, and hard-nevers inflate the body.
Suggestions
Consolidate the repeated 'no handing work back to the loop' point so it lives once (e.g. in E9 and the Hard nevers) rather than four times across the intro, E9, Step 7, and Hard nevers.
Split the dense E7 paragraph into a short rule plus a one-line rationale; the current block buries the key memory-authoring guidance under qualifications.
Move the E1-E9 philosophy block into a reference file and keep only the 2-3 load-bearing principles inline, tightening the body toward an overview-plus-steps shape.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: the intro, the E1-E9 philosophy block, and the Hard nevers restate the same points multiple times (e.g. 'no handing work back to the loop' appears four times), and E7 is a single dense paragraph that could be trimmed. | 2 / 5 |
Actionability | Provides concrete, executable commands (git fetch, git checkout --detach, gh pr diff, gh pr view --json, git push origin HEAD:feature/<f>, git checkout main) and specific files to read, with only minor deferral to the references for mechanics. | 4 / 5 |
Workflow Clarity | Steps 0-8 are clearly sequenced with checkpoints (clean-tree preflight, understanding gate in Step 6, explicit human go-ahead before the destructive merge/close in Step 7); minor gaps are deferred to references. | 4 / 5 |
Progressive Disclosure | Two one-level-deep references (references/walkthrough.md, references/verdict.md) are clearly signaled with one-line descriptions and are real bundle files; the body is well-sectioned, though the inlined E1-E9 philosophy is heavy enough to keep it from a 5. | 4 / 5 |
Total | 14 / 20 Passed |