Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured diagnostic playbook: concise, concrete, and sequenced with decision checkpoints, while pushing deeper failure detail into a single clearly-linked reference file. It respects both the token budget and the reader's intelligence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient — a symptom table, an ASCII pipeline, and short diagnostic steps with copy-paste commands; it never explains basic concepts Claude already knows and every section earns its tokens. | 3 / 3 |
Actionability | Fully executable guidance: exact `lsof -nP -i :3306 -i :6740 -i :6741`, `kcat`, `docker ps`, and `curl` commands with specific ports, topic names, and env vars — copy-paste ready, not pseudocode. | 3 / 3 |
Workflow Clarity | A clear 4-step ordered sequence with explicit decision checkpoints at each step (e.g. "If ports are not listening: ... See common failures" / "If ports are listening: ... proceed to Step 3") that branch on findings and route to the right next action. | 3 / 3 |
Progressive Disclosure | Body is a concise overview that points one level deep to a real `./references/common-failures.md` via well-signaled links (including a verified `#recorder-script-build-failure` anchor), with detail appropriately split out and easy navigation. | 3 / 3 |
Total | 12 / 12 Passed |