Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured body: concise domain-specific guidance, actionable named tools and shape tables, a clear multi-step workflow with validation checkpoints, and clean one-level-deep progressive disclosure to a verified references file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and token-efficient: every line carries non-obvious domain knowledge (fingerprint semantics, warehouse freshness lag, parquet scan pruning) with no padding or explanation of concepts Claude already knows. | 3 / 3 |
Actionability | Provides concrete, executable guidance — named MCP tools, a shape-reading table mapping readings to next steps, and copy-ready SQL pointed to in the referenced queries file — rather than abstract direction. | 3 / 3 |
Workflow Clarity | A clearly sequenced workflow (start wide → three shapes → trunk-break culprit → flaky corroboration) with explicit validation checkpoints (confidence check before naming a culprit, warehouse freshness check before trusting a boundary, verify the failure window matches). | 3 / 3 |
Progressive Disclosure | The body is an overview that signals a single one-level-deep reference (references/investigation-queries.md, verified to exist) for the SQL detail; content is appropriately split and easy to navigate. | 3 / 3 |
Total | 12 / 12 Passed |