Content
75%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 well-organized, lean body with executable tooling documentation and specific domain guidance across KPI definition by stage, dashboard layering, and cohort/retention analysis. The remaining gaps are mostly signaling: the reference list lacks labels, and the analytical workflow is not connected to the provided script commands.
Suggestions
Replace the bare 'See:' list with labeled, well-placed pointers (e.g., a References section with '**Framework details**: see references/metrics-frameworks.md') so each file's purpose is signaled.
Tie workflow step 4 directly to the tooling, e.g., 'Run `python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week` to build the retention matrix'.
Trim the 'When To Use' section, which duplicates the frontmatter description, to reclaim tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific guidance ("Executive layer: 5-7 directional metrics", "Compare retention curves, not single-point snapshots") and explains nothing Claude already knows. Not 5: the 'When To Use' bullet list and the opening line largely restate the frontmatter description and could be trimmed. | 4 / 5 |
Actionability | Fully copy-paste-ready commands with flags and output formats ('python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week --format json') plus sample CSV schemas cover retention, cohort, and funnel cases, and guidance elsewhere is specific. Not 5: the 5-step Workflow never ties its steps to these commands — step 4 'Run cohort + retention analysis' does not reference the calculator script. | 4 / 5 |
Workflow Clarity | The 5-step workflow (framework → KPIs → dashboard layers → cohort analysis → interpret and act) is clearly sequenced, with interpretive checkpoints such as 'Distinguish signal from noise using period-over-period context' and 'Connect metric movement to product changes and release timeline'. Not 5: no explicit validate-and-correct loop, acceptable here since the operations are non-destructive analysis. | 4 / 5 |
Progressive Disclosure | References are real and one level deep — references/metrics-frameworks.md and references/dashboard-templates.md exist and carry the framework/dashboard detail, while the body keeps one-line summaries (e.g., 'AARRR for growth loops and funnel visibility'). Not 5: the mid-document 'See:' list is bare paths with no per-file labels, placed oddly under Dashboard Design Principles rather than a clearly signaled references section. | 4 / 5 |
Total | 16 / 20 Passed |