Skill: Roadmap Tracker
Name
Roadmap Tracker - Automated 1M€ 18-Month Business KPI Tracking
Description
This skill automates the tracking and visualization of business metrics for the 18-month journey to 1M€ ARR as defined in /home/fitna/homelab/ROADMAP_1M_18MONTHS.md. It updates the live dashboard /home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md with current MRR, customer counts, feature progress, and KPI trends, calculating variance against targets and generating progress visualizations.
When to Use This Skill
Trigger Conditions
Use this skill when the user requests ANY of the following:
- "Update roadmap tracker"
- "Track business KPIs"
- "Show progress toward 1M€"
- "Update MRR dashboard"
- "Calculate roadmap variance"
- "Generate business metrics report"
- "Track revenue milestones"
Context Indicators
- User mentions MRR, ARR, revenue, or customers
- User discusses roadmap phases or milestones
- User asks about progress toward business goals
- User wants to update metrics dashboards
Process Steps
Phase 1: Gather Current Metrics (5 minutes)
Collect Revenue Metrics
Ask user for (or retrieve from CRM/database):
- Current MRR (Monthly Recurring Revenue): €X,XXX
- Current ARR (Annual Recurring Revenue): MRR × 12
- Total Customers: XX (Fitnaai SaaS subscribers)
- Beta Users: XX (free trial users)
- Churn Rate: X.X% (monthly customer loss)
Collect Product Metrics
- Features Shipped: X out of Y planned
- WAU (Weekly Active Users): XXX
- MAU (Monthly Active Users): XXX
- Feature Adoption Rate: XX% (users using new features)
- NPS Score: XX (Net Promoter Score)
Collect Content & Marketing Metrics
- YouTube Subscribers: XXX
- Newsletter Subscribers: XXX
- Newsletter Open Rate: XX%
- Blog Traffic: XXX visitors/month
- Social Media Followers: XXX (LinkedIn, Twitter, etc.)
Collect Consulting & Products Metrics
- Consulting Revenue (Monthly): €X,XXX
- Course Sales (Monthly): €XXX
- Content Revenue (Monthly): €XXX (sponsorships, affiliates)
Phase 2: Calculate Target Variance (5 minutes)
Determine Current Phase
Reference: /home/fitna/homelab/ROADMAP_1M_18MONTHS.md
Phase Timeline:
- Q1 (M1-3): Foundation → MVP Launch + 10 Beta (0€ → 1.5K€ MRR)
- Q2 (M4-6): Validation → PMF + 50 Customers (1.5K€ → 9.5K€ MRR)
- Q3 (M7-9): Scale → 500 Customers (9.5K€ → 25K€ MRR)
- Q4-Q6 (M10-18): Acceleration → Dominance (25K€ → 103K€ MRR)
Calculate Month Number:
Start Date: [ROADMAP_START_DATE]
Current Date: [TODAY]
Month Number: (Current - Start) / 30 days
Current Phase: [Q1/Q2/Q3/Q4-Q6]
Calculate MRR Variance
Target MRR (from phase): €X,XXX
Actual MRR: €Y,YYY
Variance: €(Y,YYY - X,XXX)
Variance %: ((Actual - Target) / Target) × 100
Status: 🟢 On Track (±10%) / 🟡 Behind (-10% to -25%) / 🔴 Critical (>-25%)
Calculate Customer Variance
Target Customers: XX
Actual Customers: YY
Variance: YY - XX
Variance %: ((Actual - Target) / Target) × 100
Calculate Revenue Stream Breakdown
Reference roadmap revenue model:
| Stream |
Target@M[X] |
Actual |
Variance |
% of Total |
| SaaS (Fitnaai) |
€X,XXX |
€Y,YYY |
€Z,ZZZ |
XX% |
| Consulting |
€X,XXX |
€Y,YYY |
€Z,ZZZ |
XX% |
| Content |
€XXX |
€YYY |
€ZZZ |
X% |
| Courses/Products |
€X,XXX |
€Y,YYY |
€Z,ZZZ |
XX% |
| TOTAL MRR |
€X,XXX |
€Y,YYY |
€Z,ZZZ |
100% |
Phase 3: Generate Progress Visualizations (5 minutes)
Create MRR Progress Bar
## MRR Progress Toward 103K€
[████████████░░░░░░░░░░░░░░░░░░░░] 40% (€41K / €103K)
Calculation:
- Each █ = 3.33% (100% / 30 bars)
- Bars = (Actual MRR / Target MRR) × 30
Create Customer Acquisition Progress
## Customer Acquisition Progress
Phase: Q2 - Validation (Target: 50 customers)
Current: 32 customers
[████████████████████░░░░░░░░░░░░] 64% (32/50)
Remaining: 18 customers
Days Left in Phase: 45
Required Rate: 0.4 customers/day
Current Rate: 0.5 customers/day ✅
Create Feature Completion Tracker
## Feature Roadmap Progress
### Must-Have Features (M1-3)
- [x] User authentication & onboarding
- [x] Workout plan generator (AI-powered)
- [x] Client progress tracking
- [x] Basic reporting dashboard
- [ ] Mobile app MVP (2 weeks delayed)
Progress: [████████████████░░░░░░░░] 80% (4/5 features)
### Nice-to-Have Features (M4-6)
- [x] Advanced AI workout customization
- [ ] Nutrition planning integration
- [ ] WhatsApp/SMS notifications
- [ ] Video exercise library
Progress: [█████░░░░░░░░░░░░░░░░░░░░] 25% (1/4 features)
Create KPI Dashboard
## Key Performance Indicators (KPIs)
| KPI | Target | Actual | Status |
|-----|--------|--------|--------|
| MRR | €9.5K | €7.2K | 🟡 -24% |
| Customers | 50 | 32 | 🟡 -36% |
| Churn Rate | <5% | 3.8% | 🟢 |
| CAC (Cost per Acquisition) | <€50 | €42 | 🟢 |
| LTV/CAC Ratio | >3x | 4.2x | 🟢 |
| WAU/MAU | >40% | 52% | 🟢 |
| NPS Score | >50 | 58 | 🟢 |
| Feature Adoption | >60% | 65% | 🟢 |
Phase 4: Update Live Dashboard (5 minutes)
Update 1M Roadmap Tracker File
Reference: /home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md
# Read current tracker
TRACKER_FILE="/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md"
# Update with new metrics (use Edit tool)
# Replace MRR section with calculated values
# Update progress bars
# Refresh variance calculations
# Update last updated timestamp
Add Trend Analysis
## Trend Analysis (Last 30 Days)
### MRR Growth
30 days ago: €6.1K
Today: €7.2K
Growth: +€1.1K (+18%)
Monthly Growth Rate: 18%
**Projection to M6 Target:** €9.5K (reachable if growth sustained)
### Customer Acquisition
30 days ago: 24 customers
Today: 32 customers
Net New: +8 customers (+33%)
Churn: -2 customers
Gross New: +10 customers
**Projection:** 50 customers by end of Q2 ✅ On track
Generate Insights & Recommendations
## Insights & Recommendations
### 🟢 What's Working
- Feature adoption rate (65%) exceeds target → users love the product
- Churn rate (3.8%) well below target → strong retention
- LTV/CAC ratio (4.2x) indicates healthy unit economics
### 🟡 Areas to Improve
- MRR growth (-24% vs target) needs acceleration
→ **Action**: Launch Q2 pricing tier (€79/mo for 20-50 clients)
- Customer acquisition (-36% vs target) behind pace
→ **Action**: Increase content marketing (2 blogs/week + YouTube shorts)
### 🔴 Risks
- Mobile app MVP delayed by 2 weeks
→ **Impact**: May miss Q2 beta launch window
→ **Mitigation**: Re-scope MVP, focus on core features only
Phase 5: Sprint & Weekly Sync (Continuous)
Link to Sprint Progress
Reference: /home/fitna/homelab/sprints/sprint-{NUMBER}/SPRINT_BOARD.md
## Current Sprint Contribution to Roadmap
**Sprint 26 Goals:**
- Landing page → Impacts: Customer acquisition (+10 signups/week projected)
- Beta launch email → Impacts: Onboarding (10 beta users)
- Monitoring setup → Impacts: Reliability (reduce downtime to <1%)
**Sprint Impact on MRR:** +€500 (5 new customers @ €99/mo)
Weekly Update Cadence
- Every Monday: Update MRR, customers, churn from CRM
- Every Friday: Update feature progress, KPIs, trend analysis
- End of Month: Full variance analysis, quarterly projections
Rules and Constraints
Hard Rules (Must Follow)
- Update MRR and customers WEEKLY (minimum)
- Variance MUST be calculated against roadmap targets
- Progress bars MUST be accurate (don't fake progress)
- KPIs MUST use objective data (no guessing)
- Churn rate MUST be tracked monthly (critical metric)
- All revenue streams MUST be broken down (SaaS, consulting, content, products)
Soft Rules (Best Practices)
- Update dashboard every Monday morning
- Include trend analysis (30-day, 90-day)
- Document assumptions in projections
- Link roadmap to sprint deliverables
- Celebrate wins (milestones reached)
Quality Gates
Before finalizing roadmap update:
Expected Outputs
Deliverables
- 1M Roadmap Tracker (updated) - Live dashboard with current metrics
- Variance Report - Target vs. actual analysis
- Trend Analysis - 30/90-day growth trends
- Insights & Recommendations - Data-driven action items
File Structure
/home/fitna/homelab/shared/dashboards/
├── 1m-roadmap-tracker.md (updated weekly)
├── monthly-reports/
│ ├── 2025-01-mrr-report.md
│ ├── 2025-02-mrr-report.md
│ └── ...
└── historical/
├── 2025-01-snapshot.md
└── 2025-02-snapshot.md
Success Metrics
- ✅ MRR updated weekly
- ✅ Variance within ±10% (on track)
- ✅ All 8 KPIs tracked and visualized
- ✅ Trends show upward trajectory
- ✅ Recommendations implemented within 2 weeks
Error Handling
Common Issues & Solutions
Issue: Missing MRR data
- Solution: Query CRM/Stripe for subscription revenue
- Fallback: Estimate from customer count × average plan price
Issue: Churn rate unknown
- Solution: Calculate: (Customers Lost / Total Customers) × 100
- Data Source: CRM cancellation records
Issue: Feature progress unclear
- Solution: Review sprint boards and Git commits
- Metric: Features marked "Done" / Total planned features
Issue: Variance too large (>25%)
- Action: Trigger urgent review, adjust roadmap or strategy
- Escalate: Discuss with stakeholders, revise targets if needed
Issue: Progress bars don't match percentages
- Solution: Recalculate: (Actual / Target) × 30 bars
- Validation: Percentage = (Number of █ symbols / 30) × 100
Example Usage
User Request
"Update the roadmap tracker with current MRR of €7.2K and 32 customers."
Agent Response
I'll update the roadmap tracker with your current metrics.
**Current Phase:** Q2 - Validation (Month 5 of 18)
**Target MRR:** €9.5K
**Actual MRR:** €7.2K
**Variance:** -€2.3K (-24%) 🟡
**MRR Progress Toward 103K€:**
[██████░░░░░░░░░░░░░░░░░░░░░░░░] 7% (€7.2K / €103K)
**Customer Acquisition:**
Target: 50 customers
Actual: 32 customers
Variance: -18 customers (-36%) 🟡
**Revenue Breakdown:**
- SaaS (Fitnaai): €5.8K (81%)
- Consulting: €1.0K (14%)
- Content: €0.3K (4%)
- Courses: €0.1K (1%)
**Trend Analysis (30 days):**
MRR: €6.1K → €7.2K (+€1.1K, +18%) 📈
Customers: 24 → 32 (+8, +33%) 📈
Churn: 3.8% (target: <5%) 🟢
**Recommendations:**
1. Launch €79/mo pricing tier to accelerate MRR growth
2. Increase content output (2 blogs/week) to boost customer acquisition
3. Focus on retention (churn excellent, maintain current quality)
**Status:** 🟡 Behind pace but trending positively. Sustaining 18% monthly growth will reach Q2 target.
**Updated:** `/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md`
Integration Points
Related Skills
- Agent 1 - SprintManager: Link sprint deliverables to roadmap KPIs
- Agent 4 - DailyProgressReporter: Weekly velocity feeds into roadmap projections
- Agent 6 - MonitoringSetup: Track infrastructure KPIs (uptime, performance)
External Tools
- CRM/Stripe: Revenue and customer data
- Google Analytics: Traffic and content metrics
- GitHub: Feature completion tracking
Data Sources
- Roadmap:
/home/fitna/homelab/ROADMAP_1M_18MONTHS.md
- Tracker:
/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md
- Sprint boards:
/home/fitna/homelab/sprints/sprint-{NUMBER}/SPRINT_BOARD.md
Version
v1.0 - Initial skill definition based on 1M€ roadmap analysis
1---2name: agent-7-skill-roadmaptracker3description: Roadmap Tracker - Automated 1M€ 18-Month Business KPI Tracking4---5
6# Skill: Roadmap Tracker
7
8## Name
9**Roadmap Tracker** - Automated 1M€ 18-Month Business KPI Tracking
10
11## Description
12This skill automates the tracking and visualization of business metrics for the 18-month journey to 1M€ ARR as defined in `/home/fitna/homelab/ROADMAP_1M_18MONTHS.md`. It updates the live dashboard `/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md` with current MRR, customer counts, feature progress, and KPI trends, calculating variance against targets and generating progress visualizations.
13
14## When to Use This Skill
15
16### Trigger Conditions
17Use this skill when the user requests ANY of the following:
18- "Update roadmap tracker"
19- "Track business KPIs"
20- "Show progress toward 1M€"
21- "Update MRR dashboard"
22- "Calculate roadmap variance"
23- "Generate business metrics report"
24- "Track revenue milestones"
25
26### Context Indicators
27- User mentions MRR, ARR, revenue, or customers
28- User discusses roadmap phases or milestones
29- User asks about progress toward business goals
30- User wants to update metrics dashboards
31
32## Process Steps
33
34### Phase 1: Gather Current Metrics (5 minutes)
35
361. **Collect Revenue Metrics**
37 Ask user for (or retrieve from CRM/database):
38 - **Current MRR (Monthly Recurring Revenue)**: €X,XXX
39 - **Current ARR (Annual Recurring Revenue)**: MRR × 12
40 - **Total Customers**: XX (Fitnaai SaaS subscribers)
41 - **Beta Users**: XX (free trial users)
42 - **Churn Rate**: X.X% (monthly customer loss)
43
442. **Collect Product Metrics**
45 - **Features Shipped**: X out of Y planned
46 - **WAU (Weekly Active Users)**: XXX
47 - **MAU (Monthly Active Users)**: XXX
48 - **Feature Adoption Rate**: XX% (users using new features)
49 - **NPS Score**: XX (Net Promoter Score)
50
513. **Collect Content & Marketing Metrics**
52 - **YouTube Subscribers**: XXX
53 - **Newsletter Subscribers**: XXX
54 - **Newsletter Open Rate**: XX%
55 - **Blog Traffic**: XXX visitors/month
56 - **Social Media Followers**: XXX (LinkedIn, Twitter, etc.)
57
584. **Collect Consulting & Products Metrics**
59 - **Consulting Revenue (Monthly)**: €X,XXX
60 - **Course Sales (Monthly)**: €XXX
61 - **Content Revenue (Monthly)**: €XXX (sponsorships, affiliates)
62
63### Phase 2: Calculate Target Variance (5 minutes)
64
655. **Determine Current Phase**
66 Reference: `/home/fitna/homelab/ROADMAP_1M_18MONTHS.md`
67
68 **Phase Timeline:**
69 - **Q1 (M1-3)**: Foundation → MVP Launch + 10 Beta (0€ → 1.5K€ MRR)
70 - **Q2 (M4-6)**: Validation → PMF + 50 Customers (1.5K€ → 9.5K€ MRR)
71 - **Q3 (M7-9)**: Scale → 500 Customers (9.5K€ → 25K€ MRR)
72 - **Q4-Q6 (M10-18)**: Acceleration → Dominance (25K€ → 103K€ MRR)
73
74 **Calculate Month Number:**
75 ```
76 Start Date: [ROADMAP_START_DATE]
77 Current Date: [TODAY]
78 Month Number: (Current - Start) / 30 days
79 Current Phase: [Q1/Q2/Q3/Q4-Q6]
80 ```
81
826. **Calculate MRR Variance**
83 ```
84 Target MRR (from phase): €X,XXX
85 Actual MRR: €Y,YYY
86 Variance: €(Y,YYY - X,XXX)
87 Variance %: ((Actual - Target) / Target) × 100
88 Status: 🟢 On Track (±10%) / 🟡 Behind (-10% to -25%) / 🔴 Critical (>-25%)
89 ```
90
917. **Calculate Customer Variance**
92 ```
93 Target Customers: XX
94 Actual Customers: YY
95 Variance: YY - XX
96 Variance %: ((Actual - Target) / Target) × 100
97 ```
98
998. **Calculate Revenue Stream Breakdown**
100 Reference roadmap revenue model:
101
102 | Stream | Target@M[X] | Actual | Variance | % of Total |
103 |--------|-------------|--------|----------|------------|
104 | SaaS (Fitnaai) | €X,XXX | €Y,YYY | €Z,ZZZ | XX% |
105 | Consulting | €X,XXX | €Y,YYY | €Z,ZZZ | XX% |
106 | Content | €XXX | €YYY | €ZZZ | X% |
107 | Courses/Products | €X,XXX | €Y,YYY | €Z,ZZZ | XX% |
108 | **TOTAL MRR** | €X,XXX | €Y,YYY | €Z,ZZZ | 100% |
109
110### Phase 3: Generate Progress Visualizations (5 minutes)
111
1129. **Create MRR Progress Bar**
113 ```markdown
114 ## MRR Progress Toward 103K€
115
116 [████████████░░░░░░░░░░░░░░░░░░░░] 40% (€41K / €103K)
117 ```
118
119 **Calculation:**
120 - Each █ = 3.33% (100% / 30 bars)
121 - Bars = (Actual MRR / Target MRR) × 30
122
12310. **Create Customer Acquisition Progress**
124 ```markdown
125 ## Customer Acquisition Progress
126
127 Phase: Q2 - Validation (Target: 50 customers)
128 Current: 32 customers
129 [████████████████████░░░░░░░░░░░░] 64% (32/50)
130
131 Remaining: 18 customers
132 Days Left in Phase: 45
133 Required Rate: 0.4 customers/day
134 Current Rate: 0.5 customers/day ✅
135 ```
136
13711. **Create Feature Completion Tracker**
138 ```markdown
139 ## Feature Roadmap Progress
140
141 ### Must-Have Features (M1-3)
142 - [x] User authentication & onboarding
143 - [x] Workout plan generator (AI-powered)
144 - [x] Client progress tracking
145 - [x] Basic reporting dashboard
146 - [ ] Mobile app MVP (2 weeks delayed)
147
148 Progress: [████████████████░░░░░░░░] 80% (4/5 features)
149
150 ### Nice-to-Have Features (M4-6)
151 - [x] Advanced AI workout customization
152 - [ ] Nutrition planning integration
153 - [ ] WhatsApp/SMS notifications
154 - [ ] Video exercise library
155
156 Progress: [█████░░░░░░░░░░░░░░░░░░░░] 25% (1/4 features)
157 ```
158
15912. **Create KPI Dashboard**
160 ```markdown
161 ## Key Performance Indicators (KPIs)
162
163 | KPI | Target | Actual | Status |
164 |-----|--------|--------|--------|
165 | MRR | €9.5K | €7.2K | 🟡 -24% |
166 | Customers | 50 | 32 | 🟡 -36% |
167 | Churn Rate | <5% | 3.8% | 🟢 |
168 | CAC (Cost per Acquisition) | <€50 | €42 | 🟢 |
169 | LTV/CAC Ratio | >3x | 4.2x | 🟢 |
170 | WAU/MAU | >40% | 52% | 🟢 |
171 | NPS Score | >50 | 58 | 🟢 |
172 | Feature Adoption | >60% | 65% | 🟢 |
173 ```
174
175### Phase 4: Update Live Dashboard (5 minutes)
176
17713. **Update 1M Roadmap Tracker File**
178 Reference: `/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md`
179
180 ```bash
181 # Read current tracker
182 TRACKER_FILE="/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md"
183
184 # Update with new metrics (use Edit tool)
185 # Replace MRR section with calculated values
186 # Update progress bars
187 # Refresh variance calculations
188 # Update last updated timestamp
189 ```
190
19114. **Add Trend Analysis**
192 ```markdown
193 ## Trend Analysis (Last 30 Days)
194
195 ### MRR Growth
196 30 days ago: €6.1K
197 Today: €7.2K
198 Growth: +€1.1K (+18%)
199 Monthly Growth Rate: 18%
200 **Projection to M6 Target:** €9.5K (reachable if growth sustained)
201
202 ### Customer Acquisition
203 30 days ago: 24 customers
204 Today: 32 customers
205 Net New: +8 customers (+33%)
206 Churn: -2 customers
207 Gross New: +10 customers
208 **Projection:** 50 customers by end of Q2 ✅ On track
209 ```
210
21115. **Generate Insights & Recommendations**
212 ```markdown
213 ## Insights & Recommendations
214
215 ### 🟢 What's Working
216 - Feature adoption rate (65%) exceeds target → users love the product
217 - Churn rate (3.8%) well below target → strong retention
218 - LTV/CAC ratio (4.2x) indicates healthy unit economics
219
220 ### 🟡 Areas to Improve
221 - MRR growth (-24% vs target) needs acceleration
222 → **Action**: Launch Q2 pricing tier (€79/mo for 20-50 clients)
223 - Customer acquisition (-36% vs target) behind pace
224 → **Action**: Increase content marketing (2 blogs/week + YouTube shorts)
225
226 ### 🔴 Risks
227 - Mobile app MVP delayed by 2 weeks
228 → **Impact**: May miss Q2 beta launch window
229 → **Mitigation**: Re-scope MVP, focus on core features only
230 ```
231
232### Phase 5: Sprint & Weekly Sync (Continuous)
233
23416. **Link to Sprint Progress**
235 Reference: `/home/fitna/homelab/sprints/sprint-{NUMBER}/SPRINT_BOARD.md`
236
237 ```markdown
238 ## Current Sprint Contribution to Roadmap
239
240 **Sprint 26 Goals:**
241 - Landing page → Impacts: Customer acquisition (+10 signups/week projected)
242 - Beta launch email → Impacts: Onboarding (10 beta users)
243 - Monitoring setup → Impacts: Reliability (reduce downtime to <1%)
244
245 **Sprint Impact on MRR:** +€500 (5 new customers @ €99/mo)
246 ```
247
24817. **Weekly Update Cadence**
249 - **Every Monday**: Update MRR, customers, churn from CRM
250 - **Every Friday**: Update feature progress, KPIs, trend analysis
251 - **End of Month**: Full variance analysis, quarterly projections
252
253## Rules and Constraints
254
255### Hard Rules (Must Follow)
2561. **Update MRR and customers WEEKLY** (minimum)
2572. **Variance MUST be calculated against roadmap targets**
2583. **Progress bars MUST be accurate** (don't fake progress)
2594. **KPIs MUST use objective data** (no guessing)
2605. **Churn rate MUST be tracked monthly** (critical metric)
2616. **All revenue streams MUST be broken down** (SaaS, consulting, content, products)
262
263### Soft Rules (Best Practices)
264- Update dashboard every Monday morning
265- Include trend analysis (30-day, 90-day)
266- Document assumptions in projections
267- Link roadmap to sprint deliverables
268- Celebrate wins (milestones reached)
269
270### Quality Gates
271Before finalizing roadmap update:
272- [ ] All KPIs populated with current data
273- [ ] Variance calculated correctly (Actual - Target)
274- [ ] Progress bars match percentages
275- [ ] Trend analysis includes 30-day comparison
276- [ ] Insights backed by data (not opinions)
277- [ ] Recommendations are actionable
278
279## Expected Outputs
280
281### Deliverables
2821. **1M Roadmap Tracker (updated)** - Live dashboard with current metrics
2832. **Variance Report** - Target vs. actual analysis
2843. **Trend Analysis** - 30/90-day growth trends
2854. **Insights & Recommendations** - Data-driven action items
286
287### File Structure
288```
289/home/fitna/homelab/shared/dashboards/
290├── 1m-roadmap-tracker.md (updated weekly)
291├── monthly-reports/
292│ ├── 2025-01-mrr-report.md
293│ ├── 2025-02-mrr-report.md
294│ └── ...
295└── historical/
296 ├── 2025-01-snapshot.md
297 └── 2025-02-snapshot.md
298```
299
300### Success Metrics
301- ✅ MRR updated weekly
302- ✅ Variance within ±10% (on track)
303- ✅ All 8 KPIs tracked and visualized
304- ✅ Trends show upward trajectory
305- ✅ Recommendations implemented within 2 weeks
306
307## Error Handling
308
309### Common Issues & Solutions
310
311**Issue: Missing MRR data**
312- **Solution**: Query CRM/Stripe for subscription revenue
313- **Fallback**: Estimate from customer count × average plan price
314
315**Issue: Churn rate unknown**
316- **Solution**: Calculate: (Customers Lost / Total Customers) × 100
317- **Data Source**: CRM cancellation records
318
319**Issue: Feature progress unclear**
320- **Solution**: Review sprint boards and Git commits
321- **Metric**: Features marked "Done" / Total planned features
322
323**Issue: Variance too large (>25%)**
324- **Action**: Trigger urgent review, adjust roadmap or strategy
325- **Escalate**: Discuss with stakeholders, revise targets if needed
326
327**Issue: Progress bars don't match percentages**
328- **Solution**: Recalculate: (Actual / Target) × 30 bars
329- **Validation**: Percentage = (Number of █ symbols / 30) × 100
330
331## Example Usage
332
333### User Request
334"Update the roadmap tracker with current MRR of €7.2K and 32 customers."
335
336### Agent Response
337```markdown
338I'll update the roadmap tracker with your current metrics.
339
340**Current Phase:** Q2 - Validation (Month 5 of 18)
341**Target MRR:** €9.5K
342**Actual MRR:** €7.2K
343**Variance:** -€2.3K (-24%) 🟡
344
345**MRR Progress Toward 103K€:**
346[██████░░░░░░░░░░░░░░░░░░░░░░░░] 7% (€7.2K / €103K)
347
348**Customer Acquisition:**
349Target: 50 customers
350Actual: 32 customers
351Variance: -18 customers (-36%) 🟡
352
353**Revenue Breakdown:**
354- SaaS (Fitnaai): €5.8K (81%)
355- Consulting: €1.0K (14%)
356- Content: €0.3K (4%)
357- Courses: €0.1K (1%)
358
359**Trend Analysis (30 days):**
360MRR: €6.1K → €7.2K (+€1.1K, +18%) 📈
361Customers: 24 → 32 (+8, +33%) 📈
362Churn: 3.8% (target: <5%) 🟢
363
364**Recommendations:**
3651. Launch €79/mo pricing tier to accelerate MRR growth
3662. Increase content output (2 blogs/week) to boost customer acquisition
3673. Focus on retention (churn excellent, maintain current quality)
368
369**Status:** 🟡 Behind pace but trending positively. Sustaining 18% monthly growth will reach Q2 target.
370
371**Updated:** `/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md`
372```
373
374## Integration Points
375
376### Related Skills
377- **Agent 1 - SprintManager**: Link sprint deliverables to roadmap KPIs
378- **Agent 4 - DailyProgressReporter**: Weekly velocity feeds into roadmap projections
379- **Agent 6 - MonitoringSetup**: Track infrastructure KPIs (uptime, performance)
380
381### External Tools
382- CRM/Stripe: Revenue and customer data
383- Google Analytics: Traffic and content metrics
384- GitHub: Feature completion tracking
385
386### Data Sources
387- Roadmap: `/home/fitna/homelab/ROADMAP_1M_18MONTHS.md`
388- Tracker: `/home/fitna/homelab/shared/dashboards/1m-roadmap-tracker.md`
389- Sprint boards: `/home/fitna/homelab/sprints/sprint-{NUMBER}/SPRINT_BOARD.md`
390
391## Version
392v1.0 - Initial skill definition based on 1M€ roadmap analysis