Skip to main content
ClaudeWave
Skill188 estrellas del repoactualizado today

business-case

Business case analysis with ROI, NPV, IRR, payback period, and TCO calculations for investment decisions. Use when building financial justification, cost-benefit analysis, build-vs-buy comparisons, or sensitivity analysis.

Instalar en Claude Code
Copiar
git clone --depth 1 https://github.com/yonatangross/orchestkit /tmp/business-case && cp -r /tmp/business-case/plugins/ork/skills/business-case ~/.claude/skills/business-case
Después abre una sesión nueva de Claude Code; el skill carga automáticamente.

SKILL.md

# Business Case

Financial frameworks for investment justification and decision support.

## When to Use Each Framework

| Framework | Use When |
|-----------|----------|
| **ROI** | Quick sanity check; time value of money doesn't matter much |
| **NPV** | Multi-year investments; gold standard for GO/NO-GO |
| **IRR** | Comparing projects competing for the same budget |
| **Payback Period** | Leadership asks "how fast do we break even?" |
| **TCO** | Build vs. buy; total cost including hidden/ongoing costs |
| **Sensitivity Analysis** | High uncertainty; need to stress-test assumptions |

## Decision Tree

```
Is the investment multi-year?
  YES → Use NPV (+ IRR to compare alternatives)
  NO  → ROI is sufficient

Is this a build vs. buy decision?
  YES → TCO comparison across all three options
  NO  → Skip TCO, use NPV/ROI

Are assumptions uncertain?
  YES → Add sensitivity analysis (3 scenarios)
  NO  → Base case only
```

## Quick Reference Formulas

```
ROI = (Net Benefits - Total Costs) / Total Costs × 100%

NPV = Sum(Cash Flow_t / (1 + r)^t) - Initial Investment
  r = discount rate (10% enterprise, 15-20% growth, 25-40% startup)
  Decision: Accept if NPV > 0

IRR = discount rate where NPV = 0
  Decision: Accept if IRR > hurdle rate

Payback Period = Initial Investment / Annual Cash Flow
  Benchmarks: SaaS 6-12 mo, Enterprise platform 12-24 mo, Infra 24-36 mo

TCO = CAPEX + (OPEX × years) + Opportunity Cost + Hidden Costs
```

## Business Case Template

```markdown
# Business Case: [Project Name]

## Executive Summary
[2-3 sentences: what we're investing in and expected return]

## Financial Analysis

### Investment Required
| Item | One-Time | Annual |
|------|----------|--------|
| Development | $X | |
| License / SaaS | | $X |
| Implementation | $X | |
| Training | $X | |
| Maintenance | | $X |
| **Total** | **$X** | **$X** |

### Expected Benefits
| Benefit | Annual Value | Confidence |
|---------|--------------|------------|
| Time savings (X hrs × $Y/hr) | $X | High |
| Error reduction | $X | Medium |
| Revenue uplift | $X | Low |
| **Total** | **$X** | |

### Key Metrics
| Metric | Value |
|--------|-------|
| 3-Year TCO | $X |
| NPV (10% discount) | $X |
| IRR | X% |
| Payback Period | X months |
| ROI | X% |

## Sensitivity Analysis
| Scenario | Discount Rate | Year 1 Benefits | NPV |
|----------|---------------|-----------------|-----|
| Base case | 10% | $X | $X |
| Conservative | 15% | $X × 0.75 | $X |
| Optimistic | 8% | $X × 1.25 | $X |

## Risk Analysis
| Risk | Probability | Impact | Mitigation |
|------|-------------|--------|------------|
| | | | |

## Recommendation
[GO / NO-GO] — [one-sentence rationale]
```

## TCO: Build vs. Buy vs. Partner

See [rules/business-cost-benefit.md](rules/business-cost-benefit.md) for the full 3-year TCO template and hidden cost checklist.

Key hidden costs to never omit:

| Category | Build | Buy |
|----------|-------|-----|
| Opportunity cost | Yes — team blocked from other work | No |
| Switching costs | N/A | Yes — vendor lock-in |
| Downtime risk | You own uptime | Partial SLA coverage |
| Security/compliance | Your responsibility | Shared |

## Common Pitfalls

| Pitfall | Mitigation |
|---------|------------|
| Simple ROI without time value | Always use NPV for multi-year decisions |
| Ignoring soft costs (training, change mgmt) | Add 30% buffer to implementation estimates |
| Optimistic benefit estimates | Use conservative estimates, document assumptions |
| Sunk cost included in forward analysis | Evaluate future costs/benefits only |
| No sensitivity analysis | Always test conservative + optimistic scenarios |

## References

- [ROI & Financial Metrics](rules/business-roi.md) — NPV, IRR, payback period formulas with code examples
- [Cost-Benefit & TCO](rules/business-cost-benefit.md) — Build vs. buy TCO template, hidden costs, sensitivity analysis
- [ROI Calculation Guide](references/roi-calculation-guide.md) — Detailed cost breakdown (CAPEX/OPEX/opportunity cost)
- [Build-Buy-Partner Decision](references/build-buy-partner-decision.md) — Scoring matrix across 5 dimensions

## Related Skills

- `ork:market-sizing` — Size the opportunity before building the business case
- `ork:competitive-analysis` — Assess competitive context and moat for the investment
- `ork:product-frameworks` — Full product strategy toolkit (prioritization, OKRs, personas)

---

Version: 1.0.0
accessibilitySkill

Accessibility patterns for WCAG 2.2 compliance, keyboard focus management, React Aria component patterns, cognitive inclusion, native HTML-first philosophy, and user preference honoring. Use when implementing screen reader support, keyboard navigation, ARIA patterns, focus traps, accessible component libraries, reduced motion, or cognitive accessibility.

agent-orchestrationSkill

Agent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows. Use when building autonomous agent loops, coordinating multiple agents, evaluating CrewAI/AutoGen/Swarm, or orchestrating complex multi-step scenarios.

ai-ui-generationSkill

AI-assisted UI generation patterns for json-render, v0.app, Google Stitch, Bolt Cloud, and Cursor workflows. Covers prompt engineering for component and full-stack app generation, review checklists for AI-generated code, design token injection, refactoring for design system conformance, and CI gates for quality assurance. Use when generating UI components with AI tools, rendering multi-surface MCP visual output, reviewing AI-generated code, or integrating AI output into design systems.

analyticsSkill

Queries local analytics across OrchestKit projects for agent usage, skill frequency, hook timing, team activity, session replay, cost estimation, and model delegation trends. Privacy-safe with hashed project IDs. Supports time-range filtering and comparative analysis. Use when reviewing performance, estimating costs, or understanding usage patterns.

animation-motion-designSkill

Animation and motion design patterns using Motion library (formerly Framer Motion) and View Transitions API. Use when implementing component animations, page transitions, micro-interactions, gesture-driven UIs, or ensuring motion accessibility with prefers-reduced-motion.

api-designSkill

API design patterns for REST/GraphQL framework design, versioning strategies, and RFC 9457 error handling. Use when designing API endpoints, choosing versioning schemes, implementing Problem Details errors, or building OpenAPI specifications.

architecture-decision-recordSkill

Use this skill when documenting significant architectural decisions. Provides ADR templates following the Nygard format with sections for context, decision, consequences, and alternatives. Use when writing ADRs, recording decisions, or evaluating options.

architecture-patternsSkill

Architecture validation and patterns for clean architecture, backend structure enforcement, project structure validation, test standards, and context-aware sizing. Use when designing system boundaries, enforcing layered architecture, validating project structure, defining test standards, or choosing the right architecture tier for project scope.