Content
56%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.
Well-structured with a clear sequenced workflow and validation checkpoint, but verbose with redundant sections and an ornamental action table, and its progressive-disclosure references point to resource files that are not present in the bundle.
Suggestions
Bundle the referenced resources/*.md files (execution-protocol, checklist, document-templates, anti-patterns, migration-playbook, query-tuning, vector-db, iso-controls) or remove the references so navigation is not broken.
Tighten redundancy: collapse 'Intent signature' into 'When to use', fold guardrails that restate Default Workflow points, and drop the contrived 'SSL primitive' column from the Actions table.
Move the inlined guardrail list and Required Deliverables into the already-referenced document-templates.md / anti-patterns.md so the body stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly directive rather than padded, but verbose: the 'When to use' list overlaps the 'Intent signature', the ornamental Actions table maps actions onto contrived 'SSL primitives', and the 17 guardrails repeat ideas already in the Default Workflow. | 3 / 5 |
Actionability | Concrete design directives and deliverables are present, plus one executable rg block, but the substantive executable detail is deferred to resources/*.md files that are not bundled, leaving the body's own guidance high-level. | 3 / 5 |
Workflow Clarity | A clear sequenced workflow (Entry -> PREPARE/ACQUIRE/REASON/ACT/VERIFY/FINALIZE -> Exit) with a VERIFY checkpoint, a failure-and-recovery section, and a checklist reference for destructive migration work. | 4 / 5 |
Progressive Disclosure | There is a dedicated References section with one-level-deep pointers, but no bundle directory exists so every resources/*.md path is unverified/dangling, and sizable content (the 17 guardrails, deliverables) is inlined that could live in those files. | 3 / 5 |
Total | 13 / 20 Passed |