Analytics Design
Purpose
Design a comprehensive measurement strategy including metrics hierarchy, event taxonomy, funnel instrumentation, and A/B test framework to ensure features can be evaluated with data.
Scope Constraints
Produces measurement plans, event schemas, and experimentation frameworks as documentation artifacts. Does not implement tracking code, configure analytics platforms, or access production data. All outputs are design specifications for engineering implementation.
Inputs
- Feature or product area to instrument
- Business goals and key questions to answer
- Existing analytics infrastructure (tools, event patterns, naming conventions)
- Privacy requirements and data retention policies
- Target user segments for experimentation
Input Sanitization
No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.
Procedure
Progress Checklist
Step 1: Define Key Metrics Hierarchy
Build a three-tier metrics structure:
- North Star Metric: The single metric that best captures the value delivered to users (e.g., weekly active users completing core action)
- Leading Indicators: Metrics that predict movement in the North Star (e.g., activation rate, feature adoption, session frequency)
- Guardrail Metrics: Metrics that must NOT degrade (e.g., page load time, error rate, unsubscribe rate, support ticket volume)
For each metric, define:
- Precise definition (what counts, what doesn't)
- Data source and calculation method
- Current baseline (if known)
- Target threshold
Step 2: Design Event Taxonomy
Establish a consistent naming convention:
- Category: Feature area (e.g.,
editor, dashboard, onboarding)
- Action: User action or system event (e.g.,
clicked, viewed, completed, errored)
- Label: Specific element or variant (e.g.,
save_button, sidebar_nav, dark_mode)
- Value: Numeric value if applicable (e.g., duration, count, score)
Naming rules:
- Use snake_case for all event names
- Format:
category.action.label (e.g., editor.clicked.save_button)
- Keep consistent across platforms (web, mobile, API)
- Version events when schema changes (
v2.editor.clicked.save_button)
Step 3: Specify Event Properties
For each trackable interaction, define:
| Event Name |
Properties |
Type |
Required |
Description |
feature.action.label |
user_id |
string |
yes |
Anonymous user identifier |
|
session_id |
string |
yes |
Current session |
|
timestamp |
ISO 8601 |
yes |
Event time |
|
[custom props] |
... |
... |
Feature-specific data |
Include:
- Common properties (present on every event)
- Feature-specific properties
- Context properties (page, referrer, device, viewport)
Step 4: Plan Funnel Instrumentation
For each key user flow:
- Define funnel stages (each stage = a specific event)
- Identify drop-off measurement points between stages
- Design recovery tracking (users who drop off then return)
- Plan cohort segmentation (new vs returning, plan type, entry source)
[Stage 1: View] → [Stage 2: Engage] → [Stage 3: Convert] → [Stage 4: Retain]
100% 65% 30% 20%
↓ 35% drop ↓ 35% drop ↓ 10% drop
[Exit survey?] [Tooltip help?] [Follow-up email?]
Step 5: Design A/B Test Framework
For each planned experiment:
- Experiment name: Descriptive, following convention (e.g.,
onboarding_v2_simplified_flow)
- Hypothesis: "If we [change], then [metric] will [improve/decrease] because [reason]"
- Variants: Control (A) and treatment(s) (B, C...)
- Allocation: Percentage split per variant (typically 50/50 for two variants)
- Sample size: Calculate minimum detectable effect (MDE) with 80% power, 95% significance
- Duration: Estimated time to reach sample size based on traffic
- Guardrails: Metrics to monitor for negative effects during the test
Step 6: Define Success Criteria
For each experiment:
- Primary metric: The one metric that determines success
- Minimum detectable effect: The smallest improvement worth shipping (e.g., +5% conversion)
- Statistical significance threshold: Typically p < 0.05
- Practical significance: Is the effect size meaningful even if statistically significant?
- Decision framework:
- Significant positive result → Ship to 100%
- Significant negative result → Revert and analyze
- No significant result → Extend test or abandon
- Mixed results (primary up, guardrail down) → Investigate and decide
Step 7: Plan Data Pipeline and Storage
- Collection method: Client-side SDK, server-side events, or hybrid
- Transport: Real-time streaming vs batch upload
- Storage: Analytics warehouse, time-series database, or SaaS platform
- Retention: How long to keep raw events vs aggregated data
- Access: Who can query the data, dashboards to create
- Privacy: PII handling, consent tracking, GDPR/CCPA compliance
Compaction resilience: If context was lost during a long session, re-read the Inputs section to reconstruct the feature area and measurement goals, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.
Output Format
Metrics Hierarchy
North Star: [Metric Name]
├── Leading: [Indicator 1]
├── Leading: [Indicator 2]
├── Leading: [Indicator 3]
├── Guardrail: [Metric A] (must not decrease)
└── Guardrail: [Metric B] (must stay below threshold)
Event Catalog
| Event Name |
Description |
Properties |
Trigger |
category.action.label |
... |
{prop1, prop2, ...} |
User clicks X |
| ... |
... |
... |
... |
Funnel Diagram
[Stage 1] ──→ [Stage 2] ──→ [Stage 3] ──→ [Stage 4]
100% ___% ___% ___%
A/B Test Plan
| Experiment |
Hypothesis |
Variants |
Sample Size |
Duration |
Primary Metric |
| ... |
If..., then... |
A/B |
... |
... weeks |
... |
Handoff
- Hand off to impact-estimation if analytics findings reveal features that need RICE scoring for prioritization.
- Hand off to mvp-scoping if measurement design surfaces scope questions about which features to instrument first.
Quality Checks
Evolution Notes
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: analytics-design3description: Use when planning measurement strategy for a feature or product area. Covers metrics hierarchy design, event taxonomy, funnel instrumentation, A/B test framework, and data pipeline planning. Do not use for feature prioritization scoring (use impact-estimation) or MVP scope definition (use mvp-scoping).4---56# Analytics Design78## Purpose910Design a comprehensive measurement strategy including metrics hierarchy, event taxonomy, funnel instrumentation, and A/B test framework to ensure features can be evaluated with data.1112## Scope Constraints1314Produces measurement plans, event schemas, and experimentation frameworks as documentation artifacts. Does not implement tracking code, configure analytics platforms, or access production data. All outputs are design specifications for engineering implementation.1516## Inputs1718- Feature or product area to instrument19- Business goals and key questions to answer20- Existing analytics infrastructure (tools, event patterns, naming conventions)21- Privacy requirements and data retention policies22- Target user segments for experimentation2324## Input Sanitization2526No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.2728## Procedure2930### Progress Checklist31- [ ] Step 1: Metrics hierarchy defined32- [ ] Step 2: Event taxonomy designed33- [ ] Step 3: Event properties specified34- [ ] Step 4: Funnel instrumentation planned35- [ ] Step 5: A/B test framework designed36- [ ] Step 6: Success criteria defined37- [ ] Step 7: Data pipeline planned3839### Step 1: Define Key Metrics Hierarchy4041Build a three-tier metrics structure:42- **North Star Metric:** The single metric that best captures the value delivered to users (e.g., weekly active users completing core action)43- **Leading Indicators:** Metrics that predict movement in the North Star (e.g., activation rate, feature adoption, session frequency)44- **Guardrail Metrics:** Metrics that must NOT degrade (e.g., page load time, error rate, unsubscribe rate, support ticket volume)4546For each metric, define:47- Precise definition (what counts, what doesn't)48- Data source and calculation method49- Current baseline (if known)50- Target threshold5152### Step 2: Design Event Taxonomy5354Establish a consistent naming convention:55- **Category:** Feature area (e.g., `editor`, `dashboard`, `onboarding`)56- **Action:** User action or system event (e.g., `clicked`, `viewed`, `completed`, `errored`)57- **Label:** Specific element or variant (e.g., `save_button`, `sidebar_nav`, `dark_mode`)58- **Value:** Numeric value if applicable (e.g., duration, count, score)5960Naming rules:61- Use snake_case for all event names62- Format: `category.action.label` (e.g., `editor.clicked.save_button`)63- Keep consistent across platforms (web, mobile, API)64- Version events when schema changes (`v2.editor.clicked.save_button`)6566### Step 3: Specify Event Properties6768For each trackable interaction, define:6970| Event Name | Properties | Type | Required | Description |71|------------|-----------|------|----------|-------------|72| `feature.action.label` | user_id | string | yes | Anonymous user identifier |73| | session_id | string | yes | Current session |74| | timestamp | ISO 8601 | yes | Event time |75| | [custom props] | ... | ... | Feature-specific data |7677Include:78- Common properties (present on every event)79- Feature-specific properties80- Context properties (page, referrer, device, viewport)8182### Step 4: Plan Funnel Instrumentation8384For each key user flow:85- Define funnel stages (each stage = a specific event)86- Identify drop-off measurement points between stages87- Design recovery tracking (users who drop off then return)88- Plan cohort segmentation (new vs returning, plan type, entry source)8990```91[Stage 1: View] → [Stage 2: Engage] → [Stage 3: Convert] → [Stage 4: Retain]92 100% 65% 30% 20%93 ↓ 35% drop ↓ 35% drop ↓ 10% drop94 [Exit survey?] [Tooltip help?] [Follow-up email?]95```9697### Step 5: Design A/B Test Framework9899For each planned experiment:100- **Experiment name:** Descriptive, following convention (e.g., `onboarding_v2_simplified_flow`)101- **Hypothesis:** "If we [change], then [metric] will [improve/decrease] because [reason]"102- **Variants:** Control (A) and treatment(s) (B, C...)103- **Allocation:** Percentage split per variant (typically 50/50 for two variants)104- **Sample size:** Calculate minimum detectable effect (MDE) with 80% power, 95% significance105- **Duration:** Estimated time to reach sample size based on traffic106- **Guardrails:** Metrics to monitor for negative effects during the test107108### Step 6: Define Success Criteria109110For each experiment:111- **Primary metric:** The one metric that determines success112- **Minimum detectable effect:** The smallest improvement worth shipping (e.g., +5% conversion)113- **Statistical significance threshold:** Typically p < 0.05114- **Practical significance:** Is the effect size meaningful even if statistically significant?115- **Decision framework:**116 - Significant positive result → Ship to 100%117 - Significant negative result → Revert and analyze118 - No significant result → Extend test or abandon119 - Mixed results (primary up, guardrail down) → Investigate and decide120121### Step 7: Plan Data Pipeline and Storage122123- **Collection method:** Client-side SDK, server-side events, or hybrid124- **Transport:** Real-time streaming vs batch upload125- **Storage:** Analytics warehouse, time-series database, or SaaS platform126- **Retention:** How long to keep raw events vs aggregated data127- **Access:** Who can query the data, dashboards to create128- **Privacy:** PII handling, consent tracking, GDPR/CCPA compliance129130> **Compaction resilience**: If context was lost during a long session, re-read the Inputs section to reconstruct the feature area and measurement goals, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.131132## Output Format133134### Metrics Hierarchy135136```137North Star: [Metric Name]138 ├── Leading: [Indicator 1]139 ├── Leading: [Indicator 2]140 ├── Leading: [Indicator 3]141 ├── Guardrail: [Metric A] (must not decrease)142 └── Guardrail: [Metric B] (must stay below threshold)143```144145### Event Catalog146147| Event Name | Description | Properties | Trigger |148|------------|-------------|-----------|---------|149| `category.action.label` | ... | `{prop1, prop2, ...}` | User clicks X |150| ... | ... | ... | ... |151152### Funnel Diagram153154```155[Stage 1] ──→ [Stage 2] ──→ [Stage 3] ──→ [Stage 4]156 100% ___% ___% ___%157```158159### A/B Test Plan160161| Experiment | Hypothesis | Variants | Sample Size | Duration | Primary Metric |162|------------|-----------|----------|-------------|----------|----------------|163| ... | If..., then... | A/B | ... | ... weeks | ... |164165## Handoff166167- Hand off to impact-estimation if analytics findings reveal features that need RICE scoring for prioritization.168- Hand off to mvp-scoping if measurement design surfaces scope questions about which features to instrument first.169170## Quality Checks171172- [ ] North star metric is clearly defined with calculation method173- [ ] Event taxonomy follows consistent naming convention174- [ ] All key user interactions have corresponding events175- [ ] Funnels have defined stages with drop-off measurement176- [ ] A/B tests have hypotheses, sample size calculations, and duration estimates177- [ ] Success criteria include both statistical and practical significance178- [ ] Privacy and data retention requirements addressed179- [ ] Guardrail metrics defined for each experiment180181## Evolution Notes182<!-- Observations appended after each use -->183184---185> Converted and distributed by [TomeVault](https://tomevault.io/claim/dtsong) — claim your Tome and manage your conversions.186<!-- tomevault:4.0:skill_md:2026-04-13 -->