ork-assess
Assess a code change, design, architecture, workflow, or competing options against explicit criteria and evidence. Use when a…
ROI, NPV, IRR, payback and TCO for investment decisions. Use when building a financial justification, cost-benefit or build-vs-buy analysis.
Claude Code
$ npx -y skills add yonatangross/orchestkit --skill business-case --agent claude-code
Codex
$ npx skills add yonatangross/orchestkit --skill business-case -a codex -y
Cursor
$ npx skills add yonatangross/orchestkit --skill business-case -a cursor -y
Gemini CLI
$ npx skills add yonatangross/orchestkit --skill business-case -a gemini-cli -y
GitHub Copilot
$ npx skills add yonatangross/orchestkit --skill business-case -a github-copilot -y
OpenCode
$ npx skills add yonatangross/orchestkit --skill business-case -a opencode -y
Windsurf
$ npx skills add yonatangross/orchestkit --skill business-case -a windsurf -y
name: business-case compatibility: "Claude Code 2.1.277+" description: "ROI, NPV, IRR, payback and TCO for investment decisions. Use when building a financial justification, cost-benefit or build-vs-buy analysis." user-invocable: false disable-model-invocation: false metadata: owner-agent: "product-strategist" category: document-asset-creation version: "1.0.0" author: "OrchestKit" complexity: "medium" tags: "roi, npv, irr, tco, build-vs-buy, financial-analysis, cost-benefit" allowed-tools: "Read Glob Grep WebFetch WebSearch"
Financial frameworks for investment justification and decision support.
| 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 |
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
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: [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]
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 |
| 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 |
---
Version: 1.0.0
The Complete AI Development Toolkit for Claude Code. 115 skills, 36 agents, 163 hooks. Install `ork` for stable (v10.x).
Assess a code change, design, architecture, workflow, or competing options against explicit criteria and evidence. Use when a…
Compare plausible implementation, architecture, product, or operational approaches before committing to one. Use when a request…
Map an unfamiliar codebase, feature, architecture, data flow, or operational path with file-backed evidence. Use when a request…
Render an answer inline as compact ASCII or box-drawing art with semantic status icons. Use for status, inventories, budgets,…
Make an approved, scoped change and prove the affected behavior. Use when a request asks to implement, build, add, or land a…
Review a pull request or branch for correctness, regressions, security, operational risk, and missing evidence. Use when a…
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
Ask which skill or flow fits your situation. A router over the skills in this repo.