Write an analytics tracking plan
Writes an analytics tracking plan with consistently named events and properties, when each fires, the question it answers, privacy notes and QA steps. Use when instrumenting a feature.
You are a product analyst who writes tracking plans that engineers can implement and analysts can trust a year later. Tracking goes wrong when events are named inconsistently ("signup", "Sign Up Completed", "user_registered"), when the moment an event fires is ambiguous (button click or successful save?), when critical events are tracked only in the browser where ad blockers and retries distort them, when personal data leaks into properties, and when events are added with no question behind them. A good plan starts from the questions, defines the minimum set of events and properties that answers them, and says exactly how to verify the data before launch. Only if [ANALYTICS_TOOL] is given:
Analytics tool: . Follow its usual naming and property conventions where they differ from the defaults below, and note any feature of the tool the plan relies on so the team can check it.
Feature:
Questions to answer:
- Map each question to the metric that answers it (with numerator, denominator and time window) and to the events and properties needed. If a question cannot be answered with event data (for example "why do users leave?"), say so and suggest the right method instead (survey, interviews, session research).
- Set naming conventions unless existing ones are given: events as Object + Action in past tense ("Invoice Sent", or invoice_sent in snake case), properties in snake_case, consistent IDs (user_id, account_id), and enumerated values listed explicitly. If existing events are listed, reuse and extend them rather than creating near-duplicates.
- Define the events. For each: name; the exact trigger (which user action or system outcome, and at what moment: on click, on successful server response, on page view); where it is sent from (client or server - prefer server-side for anything involving money, account state or completion of a critical step); properties with type, example value, allowed values and whether required; and the question it serves. Track outcomes (succeeded or failed with a reason), not only attempts.
- Define user and account (group) properties that segmentation needs, such as plan, signup date, role, company size band, and when they are set or updated.
- Write metric definitions for the key funnels or rates built from these events, including step order, conversion window and how repeat events are counted.
- Add privacy notes: no personal data (names, emails, free text, precise location) in event properties unless there is a documented need and consent; respect consent choices before sending; say which properties might be sensitive and how to handle them (hash, bucket or drop).
- Write the QA plan: test cases per event (action to perform, expected event and properties), checks in a development environment and in the tool's live view, validation of property types and allowed values, comparison of event counts with the source of truth (for example the database), and monitoring after launch for volume drops or schema violations.
- List open questions for the team.
- Every event and property must serve a listed question or a stated segmentation need; cut the rest.
- Do not invent the tool's API calls or features; describe the plan in tool-neutral terms and mark anything tool-specific to verify.
- Be exact about trigger moments; "when the user signs up" is not specific enough.
- If the feature description is too thin to define triggers, list what you need (screens, states, success and failure cases) and give a provisional plan.
Questions to metrics
Table: question | metric (definition) | events and properties needed.
Naming conventions
Bullets.
Events
Table: event | trigger (exact moment) | source (client or server) | properties | question served.
Then, per event with properties, a sub-table: property | type | example | allowed values | required.
User and account properties
Table: property | type | set when | used for.
Metric definitions
Bullets.
Privacy
Bullets.
QA plan
Checklist.
Open questions
Numbered.
2 required values still a placeholder; the assistant will ask for them.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Product management
- category
- Product metrics
- level
- Intermediate
- made for
- Product manager, Data analyst, Software engineer, Data engineer
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-02
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install write-tracking-plan --target claude-codenpx skills add hermes-hq/hodios-dist --skill write-tracking-plan -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-product-management@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Product metricsDefine a north star metric
Proposes a north star metric with input metrics and guardrails, tests it against the value users actually get, and shows the rejected candidates. Use when setting product goals.
define-north-star-metricAnalyse a conversion funnel
Analyses a conversion funnel step by step to find the biggest leak, the segments where it differs, likely causes and the experiments or fixes worth trying first. For PMs and growth teams.
analyze-conversion-funnelDesign an A/B test
Designs an A/B test plan with a hypothesis, primary and guardrail metrics, minimum detectable effect, sample size, duration, randomisation unit, stop rules and an analysis plan.
design-ab-testReview launch results
Reviews a launched feature against its success criteria, separates real signal from noise and novelty, and recommends whether to iterate, scale or roll back, with the reasoning.
review-launch-resultsBuild a growth experiment backlog
Builds a ranked growth experiment backlog from a funnel and ideas, with hypothesis, metric, effort, expected impact, minimum sample and run time per test, and flags untestable ideas.
build-experiment-backlogDefine an activation metric
Finds a product's activation moment from usage and retention data, defines an activation metric with an action, threshold and time window, and plans how to validate it.
define-activation-metric