Content
100%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 body is a dense, fully executable protocol: every phase has a literal command, validation is enforced at each decision point by the engine (exit 2 semantics), and error-recovery paths (out-of-order, interrupted, oscillating) are each specified. Detail is correctly split across four real, one-level-deep reference files, keeping the main file to the loop itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body contains no explanation of concepts Claude already knows — every line is operational: commands with flags ("ponder start \"the UI\" --lens ui --max-passes 6 --min-passes 2"), exit codes ("Out-of-order commands exit 2"), and non-obvious rationale that earns its tokens ("setEncoding(\"utf8\") prevents UTF-8 chunk boundary corruption; keep shards in .ponder/tmp/batch/ so cat globs never match their own output file"). Nothing can be trimmed without losing an operational fact, matching the 5 anchor. | 5 / 5 |
Actionability | Fully executable throughout: literal commands for every phase ("ponder units --file .ponder/tmp/units.json --scan src/routes --strict-scope", "ponder delta --file .ponder/tmp/deltas-2.jsonl"), a complete seven-operation delta JSONL example showing all required fields, an executable codex exec fan-out snippet with the exact node wrap step, and a five-command resumption sequence. Examples cover pass 1, pass 2+, the quiet pass, and the phantom-delete case, matching the 5 anchor (copy-paste ready, common cases covered). | 5 / 5 |
Workflow Clarity | The loop is sequenced as seven numbered steps in explicit order plus a stated pass-2+ variant ("predict -> deliberate -> delta -> judge -> decide"), with validation checkpoints throughout ("ponder doctor", "--strict-scope exits 2 if any file... was omitted", "ponder verify --repair", "exit 2 on unledgered edits") and feedback loops for error recovery (out-of-order commands print the owed phase, "escalate" on thrash > 0.25, budget-stop vs. converged-stop distinction, stopping criteria as an explicit checklist). Batch fan-out includes validation (strict-scope, verify reconciliation), so the batch-operation cap does not apply; this matches the 5 anchor rather than 4. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: all four referenced files exist (references/protocol.md, perspectives.md, harness-notes.md, worked-example.md), are one level deep (verified no nested delegation — the only cross-file mention is a harness path-resolution note), and each is listed with a one-line scope description under "Deeper references (load only when needed)". The operational loop stays inline while per-command flags, JSON shapes, and verdict rules are pushed to references, exactly matching the 5 anchor (clear overview, well-signaled one-level-deep references, appropriate split). | 5 / 5 |
Total | 20 / 20 Passed |