Content
86%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.
An exemplary gotcha-style reference: lean, dense with non-obvious Drizzle-specific knowledge, and clearly organized. Its only shortfalls are that code appears as inline fragments rather than complete examples, and migration workflows lack explicit validate-fix-retry loops.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every bullet is a dense, non-obvious fact ('omit { schema } and the db.query.* relational API silently does not exist'; 'A column rename generates DROP + ADD'), with zero padding and no explanation of concepts Claude already knows. | 5 / 5 |
Actionability | Concrete API recipes appear throughout (sql.placeholder('id') + .prepare('name') then .execute({ id }); postgres(url, { max: 1 }) followed by migrate(drizzle(client), { migrationsFolder: './drizzle' }); a copy-paste ALTER TABLE RENAME COLUMN statement), but they are inline fragments rather than complete executable examples covering the common cases. | 4 / 5 |
Workflow Clarity | Migration workflows are clearly sequenced ('generate → review the SQL in the out dir → migrate'; the two-migration pattern for non-nullable columns) with validation checkpoints present (reviewing generated SQL, the check command), so the destructive-operation cap does not apply — but there are no explicit error-recovery loops. | 4 / 5 |
Progressive Disclosure | The body is under 50 lines with two well-organized sections (Gotchas, drizzle-kit) and needs no external reference files, satisfying the simple-skill exception for full marks. | 5 / 5 |
Total | 18 / 20 Passed |