popilot 0.3.0 → 0.5.0

package/scaffold/.claude/commands/handoff.md

@@ -0,0 +1,259 @@
+# /handoff - Inter-Agent Handoff
+
+Perform standardized handoffs between agents.
+
+## Usage
+
+```
+/handoff              # Generate handoff document for current work
+/handoff to penny     # Simon → Penny handoff (PRD complete)
+/handoff to hank      # Penny → Hank handoff (screen spec request)
+/handoff to dev       # Hank → Dev Team handoff (spec complete)
+/handoff to vicky     # Penny → Vicky handoff (validation request)
+/handoff to simon     # Vicky → Simon handoff (validation results)
+/handoff to tara      # Hank → Tara handoff (tracking review)
+/handoff to nora      # Penny → Nora handoff (retro/ceremony data)
+```
+
+---
+
+## Handoff Flow
+
+```
+🎯 Simon (PRD complete)
+    ↓
+📋 Penny (Sprint planning + story writing)
+    ↓
+📐 Hank (Screen spec + handoff package)
+    ↓ ←→ 📡 Tara (tracking review)
+🔨 Derek + 🧪 Quinn (Implementation + QA)
+    ↓
+📋 Penny (Dev completion confirmation)
+    ↓
+📊 Vicky (Validation)
+    ↓
+🎯 Simon (Result interpretation + next hypothesis)
+```
+
+---
+
+## 🎯→📋 Simon → Penny (PRD Complete)
+
+If `$ARGUMENTS` is `to penny`:
+
+```markdown
+## 🎯→📋 Handoff: [Feature Name]
+
+### PRD Summary
+- **One Question**: [Question]
+- **Hypothesis**: IF [condition] THEN [result] BECAUSE [reason]
+- **OMTM**: [Metric] | Before: [value] | Target: [value]
+- **Validation Period**: [start] ~ [end]
+
+### Guard Rail
+- [Metric]: ≤[threshold]
+
+### Request to Penny
+- [ ] Write sprint plan
+- [ ] Break down stories
+- [ ] Route to Hank for screen specs (if UI)
+- [ ] Route to Tara for tracking plan
+
+### Reference Documents
+- PRD: [link]
+- Market data (Marco): [if available]
+```
+
+---
+
+## 📋→📐 Penny → Hank (Screen Spec Request)
+
+If `$ARGUMENTS` is `to hank`:
+
+```markdown
+## 📋→📐 Spec Request: [Story ID]
+
+### Context
+- PRD: [reference]
+- Story: [story title and AC summary]
+- Sprint: S{N}
+
+### Scope
+- [ ] Screen spec needed (which screens?)
+- [ ] Release readiness check needed
+
+### Priority
+- Sprint deadline: [date]
+```
+
+---
+
+## 📐→🔨 Hank → Dev Team (Spec Complete)
+
+If `$ARGUMENTS` is `to dev`:
+
+```markdown
+## 📐→🔨 Dev Handoff: [Feature/Story]
+
+### Screen Spec
+[7-level spec attached or linked]
+
+### Handoff Checklist
+- [ ] All screens specified (Level 1-5 complete)
+- [ ] Data sources identified (Level 3)
+- [ ] Edge cases documented (Level 5)
+- [ ] Tracking events specified (Level 6, reviewed by Tara)
+- [ ] Acceptance criteria testable (Level 7)
+- [ ] Design assets linked
+- [ ] API contracts defined
+
+### Open Questions
+[None / list if any]
+```
+
+---
+
+## 📋→📊 Penny → Vicky (Validation Request)
+
+If `$ARGUMENTS` is `to vicky`:
+
+```markdown
+## 📋→📊 Handoff: [Feature Name] Validation Request
+
+### Development Complete
+- Deploy date: [date]
+- Deploy scope: [full/partial]
+
+### Request to Vicky
+- [ ] Collect baseline data (Before)
+- [ ] Confirm event logging is working (coordinate with Tara)
+- [ ] Collect After data after measurement period
+- [ ] Report hypothesis validation results
+
+### Measurement Target Events
+| Event Name | Description |
+|------------|-------------|
+| `event_1` | [description] |
+
+### Success/Failure Criteria
+- Success: [metric] ≥ [value]
+- Failure: [metric] < [value]
+```
+
+---
+
+## 📊→🎯 Vicky → Simon (Validation Results)
+
+If `$ARGUMENTS` is `to simon`:
+
+```markdown
+## 📊→🎯 Validation Results: [Feature Name]
+
+### Verdict: ✅ Success / ❌ Failure / 🟡 Partial Success
+
+### Measurement Results
+| Metric | Before | After | Change | Target | Verdict |
+|--------|--------|-------|--------|--------|---------|
+| OMTM | [value] | [value] | +[N]% | [target] | ✅/❌ |
+
+### Guard Rail
+| Metric | Before | After | Allowed Range | Status |
+|--------|--------|-------|---------------|--------|
+| [metric] | [value] | [value] | ≤[threshold] | 🟢/🔴 |
+
+### Learnings
+- ✅ Validated: [content]
+- ❌ Disproved: [content]
+- 💡 New discovery: [content]
+
+### Next Hypothesis Proposal
+- [proposal content]
+```
+
+---
+
+## 📐→📡 Hank → Tara (Tracking Review)
+
+If `$ARGUMENTS` is `to tara`:
+
+```markdown
+## 📐→📡 Tracking Review: [Feature/Screen]
+
+### Screen Spec Level 6 (Draft)
+| Event | Trigger | Parameters |
+|-------|---------|------------|
+| ... | ... | ... |
+
+### Questions
+- Naming convention check?
+- Missing events?
+- Parameter types correct?
+```
+
+---
+
+## 📋→🗓️ Penny → Nora (Ceremony Data)
+
+If `$ARGUMENTS` is `to nora`:
+
+```markdown
+## 📋→🗓️ Sprint Data: S{N}
+
+### Sprint Summary
+- Goal: [One Question]
+- Planned SP: [N] | Completed SP: [N] | Velocity: [N]%
+- Stories completed: [N]/[total]
+- Blockers encountered: [list]
+```
+
+---
+
+## Handoff Checklist
+
+### PRD → Sprint (Simon → Penny)
+- [ ] Is the One Question clear?
+- [ ] Is the hypothesis in IF/THEN/BECAUSE format?
+- [ ] Is the OMTM quantified?
+- [ ] Are Guard Rails set?
+
+### Story → Spec (Penny → Hank)
+- [ ] Are story ACs in Given/When/Then format?
+- [ ] Are UI screens identified?
+- [ ] Is the sprint deadline communicated?
+
+### Spec → Development (Hank → Dev)
+- [ ] Is the 7-level spec complete?
+- [ ] Has Tara reviewed Level 6 (tracking)?
+- [ ] Are acceptance criteria testable?
+
+### Development → Validation (Penny → Vicky)
+- [ ] Is deployment complete?
+- [ ] Is event logging working?
+- [ ] Is baseline data available?
+
+### Validation → Strategy (Vicky → Simon)
+- [ ] Is the Before/After clear?
+- [ ] Has statistical significance been reviewed?
+- [ ] Have Guard Rails been checked?
+- [ ] Are learning points summarized?
+
+---
+
+## Automatic Handoff Suggestions
+
+Automatically suggest handoff at work completion:
+
+| Situation | Suggestion |
+|-----------|-----------|
+| PRD writing complete | "Shall we hand off to 📋 Penny?" |
+| Product direction finalized | "Shall we hand off to 📣 Mia for GTM planning?" |
+| Story writing complete | "Shall we request screen specs from 📐 Hank?" |
+| Screen spec complete | "Shall we hand off to 🔨 Derek?" |
+| Spec has tracking events | "Shall we request review from 📡 Tara?" |
+| Development confirmed complete | "Shall we request validation from 📊 Vicky?" |
+| Validation complete | "Shall we deliver results to 🎯 Simon?" |
+
+---
+
+*Connected agents*: 🎯 Simon, 📣 Mia, 📋 Penny, 📐 Hank, 📡 Tara, 🔨 Derek, 🧪 Quinn, 📊 Vicky, 🗓️ Nora
+*Related commands*: `/strategy`, `/gtm`, `/plan`, `/market`, `/tracking`, `/validate`, `/retro`

package/scaffold/.claude/commands/market.md

@@ -0,0 +1,120 @@
+# /market - Activate Market Researcher
+
+Activate 🗺️ **Marco** (Market Researcher) agent.
+
+## Load Persona
+
+Read `.context/agents/market-researcher.md` and activate Marco's persona.
+
+## Marco's Identity
+
+- **Role**: Market Researcher + Competitive Analyst
+- **Personality**: A scout who maps the terrain before battle begins
+- **Strengths**: Combines external market intelligence with internal strategic context
+
+## Communication Style
+
+- Market-data-centric, always cites sources
+- Comparative tables and positioning maps
+- Separates facts from interpretation
+- Action-oriented recommendations
+
+## Speech Examples
+
+```
+🗺️ Marco: "Three competitors launched similar features in Q4. Here's how they positioned them."
+🗺️ Marco: "The market is moving toward subscription models. Our pricing is 20% below average."
+🗺️ Marco: "Based on competitor analysis, our differentiator should be X, not Y."
+```
+
+## Usage
+
+```
+/market              # Activate Marco + display menu
+/market competitor   # Competitive analysis
+/market research     # Market research
+/market positioning  # Positioning analysis
+/market pricing      # Price benchmarking
+```
+
+---
+
+## Trigger Menu
+
+| Trigger | Function |
+|---------|----------|
+| **CMP** | Competitive analysis (competitor features, positioning, pricing) |
+| **MKT** | Market research (trends, sizing, opportunity) |
+| **POS** | Positioning analysis (differentiation, value prop) |
+| **PRC** | Price benchmarking (competitor pricing, willingness-to-pay) |
+
+---
+
+## Competitive Analysis (`/market competitor`)
+
+If `$ARGUMENTS` is `competitor`:
+
+```markdown
+## 🗺️ Competitive Analysis: [Market/Segment]
+
+### Competitor Landscape
+| Competitor | Core Feature | Target | Pricing | Differentiator |
+|-----------|-------------|--------|---------|----------------|
+| [name] | [feature] | [target] | [price] | [diff] |
+
+### Feature Comparison Matrix
+| Feature | Us | Comp A | Comp B | Comp C |
+|---------|-----|--------|--------|--------|
+| [feature] | ✅/❌ | ✅/❌ | ✅/❌ | ✅/❌ |
+
+### Strategic Implications
+- [What this means for our product]
+
+### Sources
+- [URL/reference for each claim]
+```
+
+---
+
+## Market Research (`/market research`)
+
+If `$ARGUMENTS` is `research`:
+
+```markdown
+## 🗺️ Market Research: [Topic]
+
+### Market Overview
+- Size: [TAM/SAM/SOM]
+- Growth: [trend]
+- Key drivers: [list]
+
+### Segment Analysis
+| Segment | Size | Growth | Our Position |
+|---------|------|--------|-------------|
+| [seg] | [size] | [%] | [position] |
+
+### Opportunity Assessment
+- [Opportunity 1]: [evidence]
+- [Opportunity 2]: [evidence]
+
+### Sources
+- [citations]
+```
+
+---
+
+## Handoff Flow
+
+```
+🗺️ Marco (Market intelligence)
+    ↓
+🎯 Simon (Strategy + PRD)
+    ↓
+📋 Penny (Sprint planning)
+```
+
+---
+
+*Agent*: 🗺️ Marco (Market Researcher)
+*Connections*: 🎯 Simon (strategic decisions), 📣 Mia (GTM strategy), 📈 Danny (market data validation)
+*Tools*: WebSearch, WebFetch

package/scaffold/.claude/commands/metrics.md

@@ -0,0 +1,123 @@
+# /metrics - Metrics Review and Update
+
+Review business metrics and update as needed.
+
+## Usage
+
+```bash
+/metrics              # Display current metrics summary
+/metrics update       # Update all metrics files
+/metrics update [domain]   # Update specific domain metrics only
+```
+
+ARGUMENTS: $ARGUMENTS
+
+---
+
+## Execution Steps
+
+### 1. Load Metrics Files
+
+Read YAML files in the `.context/metrics/` folder:
+- `business.yaml` - Core KPIs, funnel, targets
+- `[domain].yaml` - Domain-specific metrics
+- `segments.yaml` - Segment-level metrics
+- `team.yaml` - Team/owner information
+
+### 2. Branch Based on Arguments
+
+#### Case A: `/metrics` (no arguments)
+
+Display current metrics summary:
+
+```markdown
+📈 **Business Metrics Overview** (Updated: 2026-01-26)
+
+## Core KPIs
+| Metric | Value | vs Target |
+|--------|-------|-----------|
+| Paid Users | 81 | 54% (target 150) |
+| MRR | ₩5,163,480 | - |
+| ARPU | ₩63,747 | - |
+| Monthly Churn | 12% | ⚠️ Exceeds 10% target |
+
+## Funnel (2025 Cumulative)
+Signup 3,645 → Linked 476 (13%) → Paid 132 (3.6%)
+
+## Domain Metrics
+- Core metric achievement rate: --%
+- Active users: --
+
+📊 Dashboard: [Deployment URL]
+```
+
+#### Case B: `/metrics update`
+
+Full metrics update:
+
+1. **business.yaml**:
+   - Query paid users, MRR from MCP `prod-db`
+   - Execute date-based aggregation queries
+
+2. **[domain].yaml**:
+   - Query domain-related tables from MCP `prod-db`
+   - Calculate core metrics
+
+3. **segments.yaml**:
+   - Calculate segment-level retention, conversion rates
+
+4. Update `_meta.updated_at` in each file
+
+5. Output summary of changes
+
+#### Case C: `/metrics update [domain]`
+
+Update specific domain metrics only:
+
+1. Update only `[domain].yaml`
+2. Display before/after comparison
+
+---
+
+## Metrics File Structure
+
+```
+.context/metrics/
+├── README.md         # Structure description
+├── business.yaml     # MRR, ARPU, funnel, targets
+├── [domain].yaml     # Domain-specific metrics
+├── segments.yaml     # Segment-level metrics
+└── team.yaml         # Team/owner information
+```
+
+---
+
+## Data Sources
+
+| Metric | Source | Query Notes |
+|--------|--------|------------|
+| MRR/ARPU | prod-db | Caution with Settlement table (heavy) |
+| Funnel | GA4 MCP | - |
+| Domain metrics | prod-db | Snapshot table recommended |
+| Segments | prod-db | Index column required |
+
+---
+
+## VitePress Dashboard Integration
+
+After metrics update:
+1. `npm run build` (VitePress build)
+2. `git push` (Vercel auto-deploy)
+3. Dashboard updated
+
+---
+
+## Related Commands
+
+- `/analytics` - Activate 📈 Danny (deep analysis)
+- `/validate` - Activate 📊 Vicky (hypothesis validation)
+
+---
+
+*File location*: `.context/metrics/`
+*Dashboard*: `/dashboard`