Content
85%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 rich, highly executable body that scores top marks on actionability and workflow clarity thanks to concrete payloads, validation checkpoints, and feedback loops. The main weakness is progressive disclosure: at ~450 lines it is a self-contained monolith with no reference files, and some material could be split out.
Suggestions
Split the 'Worked example A' and 'Worked example B' narratives into a references/ file (e.g. WORKED_EXAMPLES.md) and link to them from the workflow steps, leaving the main body as an overview.
Move the 'Validating signal quality after launch' section into a separate reference file and reference it from Step 7 to keep the core workflow terse.
Tighten the intro paragraph and the worked-example prose ('Reading them by hand is not feasible') to trim tokens without losing the load-bearing gotchas.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Assumes Claude's competence (no explanations of what LLM judges, traces, or Slack are) and is mostly load-bearing operational gotchas, though the two lengthy worked-example narratives could be trimmed. | 4 / 5 |
Actionability | Copy-paste-ready HogQL queries, complete JSON payloads for every posthog:llma-evaluation-* tool, and a full Slack block-kit template with clearly marked user-substituted placeholders cover the common cases end to end. | 5 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit validation checkpoints (volume/coverage checks, 3-5 trace iteration, synthetic-vs-real test panel, end-to-end production verify) and feedback loops including a failure-mode table and a recovery path when 'View Trigger Session' lands on the homepage. | 5 / 5 |
Progressive Disclosure | Well-organized into named sections but it is a ~450-line monolith with no bundle files, and content that could live in separate references (the worked examples, the signal-quality validation guide) is inlined rather than split out. | 3 / 5 |
Total | 17 / 20 Passed |