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.
The body is highly actionable with executable code, a validated integration workflow, and good progressive disclosure into real reference files. It is slightly verbose in a few explanatory passages and references one unbundled path.
Suggestions
Trim conceptual narration like 'Yoga's context-builder runs against the simulated request, so auth middleware is exercised' and the restated worked-example prose to leave the code and assertions to speak.
Resolve the dangling reference to references/introspection.md (under graphql-complexity-limit-tester) — either add the file or remove the pointer to avoid a broken progressive-disclosure link.
Consolidate the duplicated 'Unexpected error.' / useMaskedErrors guidance between the Parsing results section and the Anti-patterns table to reduce token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and code-forward, but includes some over-explanation Claude already knows (e.g. 'auth middleware is exercised', 'useMaskedErrors interacts with every test that asserts on errors') and the worked-example narration repeats steps already shown as code. | 4 / 5 |
Actionability | Fully executable copy-paste-ready TypeScript for the basic test, HTTP executor, subscriptions, and auth pass-through, plus concrete assertions and a numbered integration scenario; commands (npm install, npm test) are specific. | 5 / 5 |
Workflow Clarity | The worked example is a clear numbered sequence with explicit validation assertions (tokenless rejected, valid token resolves, introspection error matches /introspection/i) and a feedback expectation; the anti-patterns table reinforces checkpoints. | 5 / 5 |
Progressive Disclosure | Body appropriately splits bulk production-config and Mercurius patterns into real one-level-deep references (references/production-config-tests.md, references/mercurius.md) with inline core examples; minor gap is the references to a non-bundled graphql-complexity-limit-tester / references/introspection.md path that is not present in the bundle. | 4 / 5 |
Total | 18 / 20 Passed |