Content
77%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 a well-structured, validated workflow with strong progressive disclosure and concrete tooling, but it repeats its own key points across several sections and leaves the doc-fetching step at a high level.
Suggestions
Consolidate the overlapping 'Common Failure Patterns' and 'Anti-Patterns' tables — the '200 OK' and 'don't write from memory' points each recur 3-4 times across sections.
Make Step 2 (Fetch Real Docs) executable: show the exact Context7/WebFetch invocation syntax rather than a one-line flow description.
Trim 'When This Triggers' to only the subcategories not already covered by the frontmatter description to remove the duplication.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is instruction-focused and does not explain basics Claude already knows, but core points repeat across sections — the '200 OK' / 'trusting a 200' concept and 'don't write from memory' each appear 3-4 times in the rule, failure-patterns table, anti-patterns table, and after-changes step, and 'When This Triggers' reiterates the frontmatter description. | 3 / 5 |
Actionability | Step 1 and the bundled script give copy-paste-ready bash commands and concrete examples, but Step 2 (Fetch Real Docs) stays abstract ('resolve-library-id → query-docs', 'Fetch the official API reference page') without executable invocation syntax, so it is mostly rather than fully executable. | 4 / 5 |
Workflow Clarity | A clear four-step Mandatory Steps sequence with explicit validation checkpoints ('If 1+ major versions behind, read the changelog/migration guide', 'Build to verify types', 'Test live and verify the actual downstream effect') plus a decision flowchart that provides feedback loops and an upfront confirm-checklist. | 5 / 5 |
Progressive Disclosure | Well-organized sections with two clearly-signaled, one-level-deep bundle resources — scripts/check_versions.py and references/doc-urls.md — each described with usage; the bulky doc-URL table and version checker are appropriately split out rather than inlined. | 5 / 5 |
Total | 17 / 20 Passed |