Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, well-structured body that gives executable SQL, a sequenced workflow with verification and error handling, and clear output-handling constraints — all without padding or restating concepts Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient: it assumes Claude knows what PostHog/Postgres are and adds only the non-obvious internal facts (dogfood replication, scoped `system.insights`), with every section earning its place. | 3 / 3 |
Actionability | Provides fully executable SQL (catalog lookup, column verification, analysis query) with concrete table names, the `posthog:execute-sql` tool, and specific filters like `team_id` and `NOT deleted AND saved` — copy-paste ready. | 3 / 3 |
Workflow Clarity | A clear 3-step sequence with an explicit verification gate ("Confirm columns before projecting — synced schemas drift") and an error-recovery checkpoint (permissions error → report and stop); appropriate validation for a read-only analysis flow. | 3 / 3 |
Progressive Disclosure | Self-contained and well-organized into focused sections (Synced tables, Workflow, Output handling, Related) with no nested references; the single Related pointer to `query-clickhouse-via-metabase` is a clear one-level cross-reference. | 3 / 3 |
Total | 12 / 12 Passed |