Content
82%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 tight, well-sequenced guide with concrete commands and real code that adds only project-specific knowledge (decks, doors, purity rules, event-based coupling). The main gaps are the incomplete test example and absent cli.ts/server.ts code, plus no explicit error-recovery guidance for failed migrations or tests.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — 'npm run db:generate', 'A service reads and writes only its own tables' — with zero padding and no explanation of concepts Claude already knows. All the terminology it does explain (decks, doors, zines) is project-specific and earns its tokens. | 5 / 5 |
Actionability | Mostly executable: real commands ('npm run db:generate', 'npm run db:migrate'), a complete service.ts example, and a folder-layout spec. Not 5 because the test snippet is a comment sketch ('// push your schema, seed, call your service functions, assert.') and cli.ts/server.ts wiring is described but never shown, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clear 8-step sequence with a genuine validation checkpoint (step 7: drive service.ts against PGlite and assert), covering the database-operation feedback-loop concern. Not 5 because there are no error-recovery loops (e.g., what to do when a migration fails or a test breaks), and not below 4 since the checkpoints that matter are present. | 4 / 5 |
Progressive Disclosure | Well-organized sections with clear, one-level-deep, well-signaled pointers ('src/hull/health/', 'src/zine.md', 'drizzle.config.ts', the author-zine skill). Not 5: at ~87 lines it exceeds the under-50-line simple-skill exception, and some content (e.g., the full testing pattern or door-wiring details) could live in a reference file, so placement is good rather than optimal. | 4 / 5 |
Total | 17 / 20 Passed |