Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an actionable, well-sequenced PostHog migration safety guide that assumes Claude's competence and concentrates on non-obvious project-specific hazards (hot tables, cross-language NOT NULL, CI policies), with concrete commands, named helpers, and explicit validation feedback loops. It is dense but not padded with general knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Assumes Claude's competence — no generic 'what is a migration' preamble — and every section covers non-obvious PostHog-specific hazards (hot-table locks, cross-language NOT NULL, CI guards) that Claude does not already know, so each token earns its place; not level 2 because it is not padded with general knowledge, though a few narrative asides could be trimmed. | 3 / 3 |
Actionability | Gives copy-paste-ready commands and named helpers — 'DEBUG=1 ./manage.py makemigrations', 'python manage.py rebase_migration <app>', 'SafeAddIndexConcurrently', 'AddForeignKeyNotValid' — and complete executable code for db_default= and RunSQL, matching the level-3 fully-executable anchor. | 3 / 3 |
Workflow Clarity | An explicit Classify → Generate → Apply safety rules → Validate workflow with validation checkpoints ('./manage.py sqlmigrate', run tests, confirm linear sequence), a sequenced retire-model procedure with deploy-cycle waits, and verify/feedback loops ('sqlmigrate', 'makemigrations --dry-run') for destructive DB operations, matching the level-3 anchor. | 3 / 3 |
Progressive Disclosure | Opens with 'Read these files first' pointing to four well-signaled one-level-deep doc paths, then keeps the overview inline with content appropriately split; references are clearly navigable rather than monolithic or nested, matching the level-3 anchor. | 3 / 3 |
Total | 12 / 12 Passed |