Content
96%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 tightly engineered body: measured constants, failure-mode-first rules, exact commands, and a scoring loop with real validation and feedback checkpoints. The only structural gap is that the referenced demo.html is missing from the bundle the scorecard and verify steps depend on.
Suggestions
Include `demo.html` in the bundle (or point the demo and scorecard default URL at a bundled file), since the body's --sync step and the scorecard's default target both depend on it.
Name `references/last-scorecard.json` explicitly in the Verify checklist so the 'scorecard JSON with baseline, all-on, ablation and cost' claim maps to a checkable path.
Consider moving the per-rule measured war stories (e.g. the specular 6.5 shortfall) into the references if they are not needed at build time, to trim the main file further.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious measured facts ("gain 0.14 laid a milky haze across the plaque", "turning the studio reflections off raised the total score by 0.14", exact ACES constants and bias values) and never explains concepts Claude already knows — no three.js tutorial prose, no explanation of what tone mapping or shadow maps are. Every line carries a constant, a failure mode, or a measured outcome, so every token earns its place. | 5 / 5 |
Actionability | Guidance is copy-paste executable: exact commands ("npm i playwright-core", "node references/scorecard.mjs --url --size 1440x900 --dpr 1 --target 8 --no-ablate --sync"), exact light values ("Key DirectionalLight 0xfff2df, intensity 2.0, 4096 shadow map... normalBias 0.0045"), shader formulas ("smoothstep(0.02, 0.34, y)", ACES "a=2.51 b=0.03 c=2.43 d=0.59 e=0.14"), and a full constants table. Specific values cover the common cases completely; there is no pseudocode or hand-waving. | 5 / 5 |
Workflow Clarity | Two clearly numbered sequences ("Build order" 1-6 and "Scoring loop" 1-5) with explicit validation checkpoints: "exit code 1 if any item is short", "Score the baseline before changing anything", "The ablation is the check on the metrics", and a feedback loop of "Fix the lowest item's cheapest sub-metric first, re-run at the same size and DPR, and keep only what the picture confirms". A closing "Verify" checklist (metrics block equals references/metrics.js, console clean at two sizes, scorecard JSON matches claims) completes the error-recovery loop. | 5 / 5 |
Progressive Disclosure | Good structure: the overview keeps rules and constants inline while pushing detail one level deep to clearly signaled files ("the numbers are `references/`", "scores the eight items in `references/rubric.md`", "run `node references/scorecard.mjs`"), all of which exist in the bundle. However, the referenced `demo.html` — which the body names as "The demo is `demo.html`" and which the scorecard's --sync and default URL depend on — is absent from the actual bundle, leaving a navigation/executability gap that keeps this below a 5. | 4 / 5 |
Total | 19 / 20 Passed |