Menu
Calculate ROI and Cost Savings methodology and workflow
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Execute story development with selectable automation modes to accommodate different developer preferences, skill levels, and story complexity.
Set up a Kord-aligned documentation baseline (no legacy frameworks)
Create Next Story Task methodology and workflow
Validate Next Story Task methodology and workflow
advanced-elicitation methodology and workflow
No checklists needed - this task facilitates brainstorming sessions, validation is through user interaction methodology and workflow
| name | calculate-roi |
| description | Calculate ROI and Cost Savings methodology and workflow |
| agent | architect |
| subtask | false |
Parameter:* mode (optional, default: interactive)
Purpose:* Definitive pass/fail criteria for task completion
Checklist:*
acceptance-criteria:
- [ ] Task completed as expected; side effects documented
type: acceptance-criterion
blocker: true
validation: |
Assert task completed as expected; side effects documented
error_message: "Acceptance criterion not met: Task completed as expected; side effects documented"
Strategy:* fallback
Common Errors:*
Error:* Task Not Found
Error:* Invalid Parameters
Error:* Execution Timeout
Calculate real cost savings from pattern consolidation with hard numbers. Estimates monthly/annual maintenance costs before and after, projects ROI timeline, shows when investment breaks even.
This task uses interactive elicitation to gather cost parameters.
Gather Team Context*
Review Pattern Metrics*
Configure Calculation*
Load Consolidation Metrics*
Calculate Maintenance Cost (Before)*
Calculate Maintenance Cost (After)*
Calculate Monthly and Annual Savings*
Estimate Implementation Cost*
Calculate ROI Metrics*
Calculate Velocity Impact*
Generate ROI Report*
Create Stakeholder Summary*
Update State File*
# roi section in .state.yaml
roi:
calculated_at: "2025-10-27T14:00:00Z"
before:
patterns: 176
monthly_cost: $38,100
annual_cost: $457,200
hours_per_month: 352
after:
patterns: 32
monthly_cost: $6,900
annual_cost: $82,800
hours_per_month: 64
savings:
monthly: $31,200
annual: $374,400
hours_saved_monthly: 288
implementation:
estimated_cost: $12,000
developer_weeks: 4
roi_metrics:
ratio: 31.2
breakeven_months: 0.38
year_1_net: $362,400
year_3_cumulative: $1,111,200
velocity_impact:
multiplier: "4-6x"
time_savings: "70% reduction in UI decisions"
calculate-roi
Output:
💰 Brad: Calculating ROI from pattern consolidation...
Team Context:
- Developers: 8
- Hourly rate: $150/hr
- Patterns maintained: 176 → 32
📊 COST ANALYSIS:
BEFORE consolidation:
176 patterns × 2 hrs/month × $150/hr = $52,800/month
Annual cost: $633,600
AFTER consolidation:
32 patterns × 2 hrs/month × $150/hr = $9,600/month
Annual cost: $115,200
💵 SAVINGS:
Monthly: $43,200
Annual: $518,400
3-year total: $1,555,200
🎯 ROI METRICS:
Implementation cost: $15,000
ROI ratio: 34.6x
Breakeven: 0.35 months (10 days!)
Year 1 net profit: $503,400
⚡ VELOCITY IMPACT:
Estimated 5x faster feature development
288 hours/month saved = 1.8 FTE equivalent
✅ Report saved: outputs/design-system/my-app/roi/roi-analysis.md
✅ Executive summary: outputs/design-system/my-app/roi/executive-summary.md
Brad says: Numbers don't lie. Show this to your boss.
# Design System ROI - Executive Summary
## Investment
**$15,000** (4 developer-weeks)
## Return
**$518,400/year** savings
## ROI
*34.6x return** on investment
## Breakeven
*10 days**
## Impact
- 81.8% pattern reduction (176 → 32)
- 5x velocity improvement
- 1.8 FTE equivalent time savings
*Recommendation**: Immediate approval. Payback in under 2 weeks.