Get the FREE Ultimate OpenClaw Setup Guide →

adr-format-business-case

npx machina-cli add skill zircote/adr/adr-format-business-case --openclaw
Files (1)
SKILL.md
3.8 KB

Business Case ADR Format

The Business Case format is designed for decisions requiring financial analysis, stakeholder sign-off, and executive-level documentation. It includes SWOT analysis, cost-benefit analysis, and ROI assessment.

About Business Case Format

The Business Case format is:

  • Executive-focused - Clear for non-technical stakeholders
  • Financial - Includes cost-benefit and ROI analysis
  • Comprehensive - SWOT, risks, and implementation planning
  • Formal - Stakeholder sign-off section

Template Structure

# {NUMBER}. {TITLE}

Date: {DATE}

## Status

{STATUS}

## Executive Summary

{2-3 sentence overview}

## Business Context

{Business situation description}

## Problem Statement

{Business problem or opportunity}

## SWOT Analysis

### Strengths
### Weaknesses
### Opportunities
### Threats

## Options Considered

### Option 1: {Title}
**Cost**: {Estimate}
**Effort**: {High/Medium/Low}
**Risk**: {High/Medium/Low}
**Alignment**: {Strategic alignment}

## Decision

{Chosen option and justification}

## Cost-Benefit Analysis

### Costs
### Benefits
### ROI Assessment

## Implementation

### Timeline
### Resources Required
### Success Metrics

## Risk Assessment

{Risk table with likelihood, impact, mitigation}

## Stakeholder Sign-off

{Sign-off table}

Section Guide

Executive Summary

Brief overview for executives:

  • What decision was made
  • Why it matters to the business
  • Key financial impact

Business Context

Describe business situation:

  • Market conditions
  • Competitive pressures
  • Customer needs
  • Organizational goals

SWOT Analysis

CategoryFocus
StrengthsInternal positive factors
WeaknessesInternal limitations
OpportunitiesExternal potential gains
ThreatsExternal risks

Options with Business Metrics

For each option, document:

  • Cost: Initial and ongoing
  • Effort: Implementation effort
  • Risk: Overall risk level
  • Alignment: Fit with strategic goals

Cost-Benefit Analysis

Costs:

  • Initial investment
  • Ongoing operational costs
  • Opportunity costs

Benefits:

  • Short-term gains
  • Long-term value
  • Intangible benefits

ROI Assessment:

  • Expected return
  • Payback period
  • Break-even point

Implementation Planning

Include:

  • Phased timeline
  • Resource requirements
  • Key milestones
  • Success metrics (KPIs)

Risk Assessment

RiskLikelihoodImpactMitigation
{Risk 1}High/Med/LowHigh/Med/Low{Strategy}

Stakeholder Sign-off

RoleNameDateSignature
Sponsor
Technical Lead
Finance

When to Use Business Case Format

Best for:

  • Executive-level decisions
  • Significant financial impact
  • Decisions requiring formal approval
  • Cross-departmental decisions
  • Compliance/governance requirements

Consider other formats when:

  • Purely technical decisions
  • Small scope/low cost
  • Quick documentation needed
  • Internal team decisions

Business Case Best Practices

Executive Communication

  • Lead with business impact
  • Quantify benefits where possible
  • Be clear about costs and risks
  • Provide actionable recommendations

Financial Analysis

  • Include all cost categories
  • Consider total cost of ownership
  • Project multi-year costs
  • Account for opportunity costs

Additional Resources

Templates

Template available at: ${CLAUDE_PLUGIN_ROOT}/templates/business-case/adr-template.md

Source

git clone https://github.com/zircote/adr/blob/main/skills/adr-format-business-case/SKILL.mdView on GitHub

Overview

adr-format-business-case guides you to create ADRs in a formal business-case format for executive and financial analysis. It combines SWOT, cost-benefit analysis, ROI, and implementation planning with a formal sign-off to support strategic decisions.

How This Skill Works

The skill provides a structured template that covers Executive Summary, Business Context, Problem Statement, SWOT Analysis, Options, Cost-Benefit Analysis, ROI, Implementation, Risk, and Stakeholder Sign-off. It emphasizes an executive-focused, financial, and comprehensive approach to ADRs.

When to Use It

  • When making executive-level decisions with significant financial impact
  • When cross-department alignment is required and formal sign-off is needed
  • For initiatives needing SWOT, risk assessment, and ROI calculations
  • When compliance or governance requires formal documentation
  • When presenting MBA-style, cost-benefit, or ROI ADRs to stakeholders

Quick Start

  1. Step 1: Define Title, Date, Status, and Executive Summary
  2. Step 2: Populate Business Context, Problem Statement, SWOT, and Options with metrics
  3. Step 3: Complete Cost-Benefit Analysis, ROI, Implementation, Risk, and Stakeholder Sign-off

Best Practices

  • Lead with the executive summary and clearly state the financial impact
  • Quantify costs and benefits with concrete numbers and timelines
  • Document risks with likelihood, impact, and mitigation strategies
  • Align options with strategic goals and provide a clear recommendation
  • Use the provided template structure to ensure sign-off readiness

Example Use Cases

  • Business-case ADR for migrating to a cloud infrastructure with ROI
  • Cost-benefit analysis for a new product line and market expansion
  • IT security program with SWOT, risk assessment, and implementation plan
  • Regulatory compliance initiative requiring executive sign-off
  • Cross-functional process automation with ROI and phased timeline

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers