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.
A well-structured overview that uses progressive disclosure correctly, with a clear sequenced workflow and explicit validation guidance. Its weaknesses are the complete absence of executable detail in the body (everything concrete is deferred to references) and two padded sections (persona role definition, knowledge keyword list) that spend tokens on nothing Claude doesn't already know.
Suggestions
Add one small executable anchor to the body — e.g., a pg_stat_statements top-offenders query or an EXPLAIN (ANALYZE, BUFFERS) invocation — so the entry point isn't purely abstract.
Delete the 'Knowledge Reference' section and fold the 'Role Definition' persona into a single sentence; both restate things Claude already knows and add no actionable guidance.
Tie workflow steps to concrete starting points (e.g., step 1 'Analyze Performance' could name the monitoring-analysis.md diagnostics to run first) so the sequence has executable entry points.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The structural sections (workflow, constraints, reference table) are lean and list-based, but two sections are pure padding: the 'Role Definition' persona paragraph ('a senior database performance engineer with 10+ years of experience') and the 'Knowledge Reference' keyword dump ('pg_stat_statements, EXPLAIN ANALYZE, indexes, VACUUM, partitioning...') that tells Claude nothing it doesn't already know. This matches anchor 3 — mostly efficient with some unnecessary explanation that could be trimmed — rather than 2, since no concept is actually explained at length. | 3 / 5 |
Actionability | The body contains no executable code, SQL, or commands anywhere — even the highest-value moments stay abstract ('Analyze EXPLAIN plans before optimizing', 'Measure performance before and after changes'). This matches anchor 2: minimal concrete guidance with high-level hints but missing the specific steps to execute. Not 3 because there isn't even partial concrete material like a sample pg_stat_statements query or an EXPLAIN ANALYZE invocation in the body; the concrete detail is entirely deferred to reference files. | 2 / 5 |
Workflow Clarity | The 5-step Core Workflow (Analyze → Identify → Design → Implement → Validate) is a clear sequence, and validation checkpoints are explicitly present ('Measure performance before and after changes', step 5 'Validate Results - Measure improvements, ensure stability'), which satisfies the database-operations feedback-loop expectation and avoids the cap at 3. Not 5 because the steps lack executable commands or explicit error-recovery loops (the anchor-5 pattern of 'if X fails, fix and re-check'), leaving minor validation gaps. | 4 / 5 |
Progressive Disclosure | The Reference Guide table gives a clear overview with well-signaled, one-level-deep references, each paired with a 'Load When' condition, and all five referenced files (query-optimization.md, index-strategies.md, postgresql-tuning.md, mysql-tuning.md, monitoring-analysis.md) exist with substantive content. This matches the anchor-5 example of a clear overview pointing to well-signaled separate files with no nesting. | 5 / 5 |
Total | 14 / 20 Passed |