Content
63%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 content is well-structured, lean, and action-oriented with a clear sequenced workflow and appropriate guardrails around destructive operations. Its main weaknesses are that the key executable JSON templates are deferred to a reference.md that is missing from the bundle, hurting both actionability and progressive disclosure.
Suggestions
Ship the missing reference.md (or place it under references/) so the Portable Text cheat sheet, changeBlock template, and GROQ snippets are actually reachable — currently every anchored reference is a broken link.
Inline at least one minimal copy-paste-ready Portable Text JSON block (a single h2 + paragraph with _key values) so create_documents can be invoked correctly even without the external reference.
Add an explicit draft-verification feedback loop (e.g. fetch the created draft back and confirm blocks/keys rendered) to lift workflow_clarity from 4 to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it never explains what Sanity, Linear, or a changelog is — with only minor instances that could be trimmed (e.g. 'brace/bracket errors are the most common failure' and the dual checklist-plus-section framing); not a 5 because a few tokens are explanatory rather than strictly necessary. | 4 / 5 |
Actionability | Names concrete MCP tools (create_documents, patch_documents, discard_drafts, publish_documents) and gives a real patch-path example (content[_key=="fd1ce739c172"] with insert before/after/replace), but the core executable artifact — the Portable Text JSON payload with unique _key values — is deferred to reference.md ('with the Portable Text structure from reference.md'), and that file is absent, leaving key details missing. | 3 / 5 |
Workflow Clarity | A clear 7-step sequenced checklist with explicit guardrails for destructive/batch ops ('discard_drafts ... confirm intent', 'Never publish unless explicitly asked', draft-only creation); not a 5 because there is no validate-then-retry feedback loop after draft creation. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and clearly signals one-level-deep references to reference.md with anchor links (#fetch-reference-ids, #portable-text-cheat-sheet, #changeblock-template), but reference.md and the references/ bundle directory do not exist, so the signaled navigation leads nowhere — a real organization defect. | 3 / 5 |
Total | 14 / 20 Passed |