Content
88%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.
An exceptionally actionable, well-gated orchestration document: exact commands, exit codes, thresholds, and validation-first sequencing with bounded correction loops, and no filler or basic-concept explanation. Its weaknesses are router length with some repeated MUST-read mandates, and that almost none of the many referenced grimoire/docs/forge files exist in the provided bundle, leaving the read-on-demand contract unverifiable as shipped.
Suggestions
Deduplicate the MUST-read mandates: grimoire/review/gates_reference.md and grimoire/review/self_correction.md are each required at The Loop step 8, the Gates section, and the Self-Correction section — consolidate to one canonical mandate and cross-reference it to reclaim router tokens.
Ensure the grimoire/, docs/, and forge/ files the router names actually ship with the skill bundle — in the provided bundle only scripts/capture_threejs_playwright.py resolves, so the progressive-disclosure contract cannot execute; a file manifest or shipping check would close this gap.
Tighten rule blocks that restate their contract file's content (e.g., the multi-line chirality and hair rules) to the one-line hard rule plus named file, as the router's own opening promises.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | There is no padding or explanation of concepts Claude already knows — the body is dense with hard rules, exact thresholds, and empirically grounded failure patterns (e.g., "a model with its face deleted scored the same 0.8803 as the finished face"), so it is well above the 3 anchor. It falls short of 5 because the router is ~420 lines with repetition: grimoire/review/gates_reference.md and grimoire/review/self_correction.md are each mandated multiple times (The Loop step 8, the Gates section, Self-Correction section), and several multi-line rule blocks could be one-liners pointing to their named contract files. | 4 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste commands with flags and arguments ("python3 forge/next.py --state .img2threejs/state.json [<spec>]", "forge/stage4_review/turntable_gate.py --capture 0=front.png --capture 90=right.png ..."), explicit exit-code semantics ("All three exit 0 clean / 1 gate failure / 2 error"), concrete thresholds ("--target-threshold 0.7", "≤5 critical, ≤3 important"), and an exact decision vocabulary ("continue | refine-spec | refine-code | request-input | stop") with recorded evidence flags. | 5 / 5 |
Workflow Clarity | The pipeline is a clearly sequenced 12-step numbered loop with lettered sub-steps, explicit validation checkpoints at every stage (validate → strict-validate before codegen, deterministic gates before AI vision, three off-axis gates before continue), bounded feedback loops ("3 corrections per pass, 6 total"; hard stop on exit code 3), and per-pass decision plus state re-sync steps — matching the 5 anchor's validate/fix/retry structure. | 5 / 5 |
Progressive Disclosure | The file is explicitly designed as a router ("This file is the always-loaded router... The full contract behind each rule lives in the grimoire/ or docs/ file that rule names — read the named file at the moment you reach that stage, not before") with one-level-deep, clearly signaled references, which is the 5-anchor pattern. Scored against the actual bundle per the guideline, however, nearly every referenced path (grimoire/, docs/, forge/) is absent — only scripts/capture_threejs_playwright.py resolves — so the disclosure targets cannot be verified in the bundle as provided, which is more than a minor organization gap and keeps it below 5. | 4 / 5 |
Total | 18 / 20 Passed |