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, lean body that walks through a multi-step adoption process with executable code, specific commands, concrete file pointers, and closing validation/QA checkpoints. It assumes Claude's competence while surfacing only product-specific knowledge.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and information-rich with no padding of general concepts Claude already knows (HogQL, kea, tailwind are used without explanation); every token conveys product-specific architecture and gotchas. | 3 / 3 |
Actionability | Provides copy-paste-ready TypeScript (the connect/listeners snippet, the SceneExport declaration), specific commands ('pnpm build:products', 'pnpm --filter=@posthog/frontend typescript:check'), and concrete reference file paths. | 3 / 3 |
Workflow Clarity | Sequenced adoption steps 1-6 (plus 4b) with explicit validation checkpoints: a dedicated test step (5) and a final QA checklist covering dark mode, self-hosted, skip persistence, and type checks. | 3 / 3 |
Progressive Disclosure | Well-organized into clear sections (How it works, Adoption steps, Migration, QA) with one-level-deep references to real codebase files and no nested reference chains; no bundle files are needed. | 3 / 3 |
Total | 12 / 12 Passed |