Content
40%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.
The body is well-structured with real references and some executable commands, but it is heavily padded with generic capability lists Claude already knows and lacks any sequenced workflow with validation checkpoints. It reads more like a topical outline than actionable guidance.
Suggestions
Cut the generic 'Core Expertise', 'Best Practices', and 'Senior-Level Responsibilities' bullet lists, which restate knowledge Claude already has, and keep only non-obvious specifics.
Add a sequenced end-to-end workflow (e.g., train -> validate -> package -> deploy -> monitor) with explicit validation checkpoints for the batch/destructive deployment steps.
Replace abstract pattern descriptions with concrete, copy-paste-ready examples (e.g., a real k8s manifest snippet or a working monitoring config) or move detail into the reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Large swaths of the body are generic padded bullet lists Claude already knows ('Test-driven development', 'Drive architectural decisions', 'Advanced production patterns and architectures'), adding little actionable knowledge beyond enumeration. | 2 / 5 |
Actionability | Quick Start and Common Commands give genuinely executable commands (python scripts/..., docker build, kubectl apply, helm upgrade), but the majority of sections are abstract descriptions ('Model serving with low latency', 'Batching and caching strategies') with no concrete steps or code. | 3 / 5 |
Workflow Clarity | No real multi-step workflow is sequenced; Quick Start is three independent commands and Common Commands is loosely grouped. Batch/destructive operations (kubectl apply, helm upgrade) appear with no validation or verification checkpoints. | 2 / 5 |
Progressive Disclosure | Clear section structure with well-signaled, one-level-deep references to three real reference files and the scripts/ directory (all verified to exist). Minor gaps: the body inlines generic content that belongs in references, and the reference files themselves are thin. | 4 / 5 |
Total | 11 / 20 Passed |