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 coaching skill: lean overview, sequenced workflow with a decision tree and worked example, and three clearly-signaled reference files holding the full before/after code. It assumes competence and avoids re-teaching TDD basics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body that defers TDD basics to Beck ('For TDD basics, defer to Kent Beck') and compresses the catalog into a table, a decision tree, a worked example, an anti-patterns table, and a short limitations section — every token earns its place and Claude's competence is assumed. | 3 / 3 |
Actionability | Gives a concrete 7-step 'How to use', a decision tree that routes symptoms to pattern numbers, and a worked example with executable code ('processOrder(1, { findOrder: () => ({ id: 1 }) })'); the linked reference files contain complete before/after code for each pattern. | 3 / 3 |
Workflow Clarity | The multi-step process is clearly sequenced (numbered 1-7) with a decision tree for routing and a worked example walking route -> open -> move -> test; the test written at the seam acts as the verification checkpoint, and refactoring here is incremental rather than a destructive batch operation. | 3 / 3 |
Progressive Disclosure | The body is an overview whose pattern table links to three real, one-level-deep reference files (injection-patterns.md, boundary-adapter-patterns.md, structural-patterns.md), each covering a distinct pattern group with full before/after code — content is appropriately split and clearly signaled. | 3 / 3 |
Total | 12 / 12 Passed |