Content
92%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 dense, expert-level protocol in which every phase carries executable commands, skeletons, and validation gates, with MoE/VLM/Omni material correctly offloaded to well-signaled one-level-deep reference files. The only weakness is minor repetition (notably the hand-edit rule restated several times) that could be trimmed without losing clarity.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense expert material — tables, exact commands, and failure signatures — with no explanation of concepts Claude already knows. Minor trims remain: "Never hand-edit anything under generated/" is restated in the purpose, the Phase 5 hard rule, Common Pitfalls, and the reference header, and the "A text-only dense GPU model therefore reads this file plus the examples…" prose could be tightened. Anchor 4 (efficient, minor over-explanation), not 5 (those repetitions don't earn their place) and not 3 (nothing is padding or generic). | 4 / 5 |
Actionability | Fully executable throughout: copy-paste commands ("patchgen veomni.models.transformers.<m>.<m>_gpu_patch_gen_config -o veomni/models/transformers/<m>/generated --diff", "uv sync --frozen --extra gpu --group dev"), code skeletons for every wiring pattern, the patch-primitives API table, and exact failure signatures ("F821 / F811", "IndentationError: unexpected indent", "0 selected / N deselected") with the concrete commands to recover. Matches anchor 5. | 5 / 5 |
Workflow Clarity | Phases 0–8 are sequenced with a suggested plan, per-phase **Validation** checkpoints, Phase 7 acceptance criteria, and explicit feedback loops — "If not `5.16.1`, re-sync the default env", the "patchgen --check --fix" resync loop instead of ping-ponging with ruff, and "do NOT assume the test doesn't exist; re-check with --collect-only". Clear sequence with explicit validation and error recovery, matching anchor 5. | 5 / 5 |
Progressive Disclosure | The spine/reference split is explicit and quantified: the "What to read for your model" routing table points to references/model-examples.md, references/moe.md, and references/multimodal.md — all real files, one level deep, loaded per category — and states a text-only dense model "skips about 380 lines of MoE and multimodal material". Category-specific detail is correctly offloaded rather than inlined; matches anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |