Content
81%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 lean, highly actionable advisory workflow with excellent sequencing, explicit fallbacks, and a fix-verification feedback loop. The only notable gaps are the duplicated severity/scope content between Workflow and Rules and the dangling reference to specs/finding.schema.json, which is not shipped in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with no explanation of concepts Claude already knows ('Static review guesses; the deployment KNOWS'). Matches anchor 4 rather than 5 because the Rules section restates content already in the Workflow — the severity mapping ('limit-hit / permanent-OCC-failure = high; threshold / retried = med') duplicates step 4, and 'Stay in lane' duplicates step 6. Not 3 since the duplication is minor and everything else earns its tokens. | 4 / 5 |
Actionability | Gives exact MCP tool names ('status', 'insights', 'tables', 'functionSpec'), concrete anti-patterns and fixes ('.collect() / unindexed .filter()', '.withIndex, .take(n), or .paginate', '@convex-dev/sharded-counter'), a sample evidence line, and an explicit fallback. Matches anchor 4 — mostly executable with minor gaps; not 5 because there is no copy-paste-ready example of an emitted finding against the referenced schema. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps (GUARD → GATHER → ROOT-CAUSE → EMIT → REPORT → scope) with explicit validation and feedback loops: step 2's fallback ('if it returns nothing or is unavailable, say so and fall back... do NOT invent findings') and step 5's gate plus re-verification ('apply only on confirmation, then re-run `insights` after traffic to verify the trend'). Matches anchor 5; the per-event-kind root-cause mapping also functions as a checklist. | 5 / 5 |
Progressive Disclosure | Under 50 lines with well-organized Workflow/Rules sections and appropriately inlined content, but the body twice directs emission 'per specs/finding.schema.json' and that file is not present in the bundle (no references/, scripts/, or assets/ exist), so the core output contract is unreadable. Anchor 4 (good structure, minor organization gap) rather than 5. | 4 / 5 |
Total | 17 / 20 Passed |