ork-assess
Assess a code change, design, architecture, workflow, or competing options against explicit criteria and evidence. Use when a request asks to assess, rate,…
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.
$ npx -y skills add yonatangross/orchestkit --skill business-case --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/business-caseContext preview
The summary Claude sees to decide when to auto-load this skill.
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.
name: business-case compatibility: "Claude Code 2.1.251+" description: "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." version: 1.0.0 author: OrchestKit user-invocable: false disable-model-invocation: false complexity: medium persuasion-type: guidance tags: [roi, npv, irr, tco, build-vs-buy, financial-analysis, cost-benefit] context: fork agent: product-strategist metadata: category: document-asset-creation 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. 106 skills, 36 agents, 171 hooks. Install `ork` for stable (v9.x), or `ork-alpha` for the v10 line, which ships daily.
Repo: yonatangross/orchestkit
Assess a code change, design, architecture, workflow, or competing options against explicit criteria and evidence. Use when a request asks to assess, rate,…
Compare plausible implementation, architecture, product, or operational approaches before committing to one. Use when a request asks to brainstorm, think…
Map an unfamiliar codebase, feature, architecture, data flow, or operational path with file-backed evidence. Use when a request asks how a system works, where…
Make an approved, scoped change and prove the affected behavior. Use when a request asks to implement, build, add, or land a feature that already has an agreed…
Review a pull request or branch for correctness, regressions, security, operational risk, and missing evidence. Use when a request asks to review a PR, review…
Verify that existing work is ready to merge, release, or hand off using an explicit evidence contract. Use when a request asks to verify, validate, prove,…