@mytechtoday/augment-extensions 1.3.0 → 1.4.0

package/augment-extensions/workflows/adr-support/templates/business-case.md

@@ -1,235 +1,235 @@
-# ADR-{number}: {Title}
-
-**Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
-
-**Date:** {YYYY-MM-DD}
-
-**Deciders:** {List of people involved in the decision}
-
-**Business Owner:** {Name of business stakeholder}
-
-**Technical Story:** {Optional: Link to related issue, spec, or task}
-
----
-
-## Executive Summary
-
-{Provide a 2-3 sentence summary of the decision, the problem it solves, and the expected business value.}
-
----
-
-## Business Context
-
-### Problem Statement
-
-{Describe the business problem or opportunity. What pain points exist? What business goals are not being met?}
-
-### Current State
-
-{Describe the current situation, including existing solutions, workarounds, and their limitations}
-
-### Desired State
-
-{Describe the target state after implementing this decision. What will be different?}
-
----
-
-## Strategic Alignment
-
-### Business Objectives
-
-{How does this decision align with organizational goals?}
-
-- {Objective 1}
-- {Objective 2}
-- {Objective 3}
-
-### Key Performance Indicators (KPIs)
-
-{What metrics will this decision impact?}
-
-- {KPI 1: Current value → Target value}
-- {KPI 2: Current value → Target value}
-- {KPI 3: Current value → Target value}
-
----
-
-## Financial Analysis
-
-### Cost Breakdown
-
-#### Initial Investment
-
-| Category | Description | Cost |
-|----------|-------------|------|
-| Development | {Description} | ${amount} |
-| Infrastructure | {Description} | ${amount} |
-| Licensing | {Description} | ${amount} |
-| Training | {Description} | ${amount} |
-| **Total Initial** | | **${total}** |
-
-#### Ongoing Costs (Annual)
-
-| Category | Description | Cost |
-|----------|-------------|------|
-| Maintenance | {Description} | ${amount}/year |
-| Support | {Description} | ${amount}/year |
-| Licensing | {Description} | ${amount}/year |
-| Infrastructure | {Description} | ${amount}/year |
-| **Total Annual** | | **${total}/year** |
-
-### Return on Investment (ROI)
-
-#### Expected Benefits (Annual)
-
-| Benefit | Description | Value |
-|---------|-------------|-------|
-| Revenue Increase | {Description} | ${amount}/year |
-| Cost Savings | {Description} | ${amount}/year |
-| Efficiency Gains | {Description} | ${amount}/year |
-| **Total Annual Benefit** | | **${total}/year** |
-
-#### ROI Calculation
-
-- **Total Initial Investment:** ${amount}
-- **Annual Net Benefit:** ${annual benefit - annual cost}
-- **Payback Period:** {X months/years}
-- **3-Year ROI:** {percentage}%
-- **5-Year ROI:** {percentage}%
-
-### Risk-Adjusted ROI
-
-{Consider risks and their probability/impact on ROI}
-
-- **Best Case:** {ROI percentage}%
-- **Expected Case:** {ROI percentage}%
-- **Worst Case:** {ROI percentage}%
-
----
-
-## Risk Assessment
-
-### Business Risks
-
-| Risk | Probability | Impact | Mitigation Strategy |
-|------|-------------|--------|---------------------|
-| {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
-| {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
-| {Risk 3} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
-
-### Technical Risks
-
-| Risk | Probability | Impact | Mitigation Strategy |
-|------|-------------|--------|---------------------|
-| {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
-| {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
-
----
-
-## Alternatives Considered
-
-### Option 1: {Option Name}
-
-**Cost:** ${amount}
-**ROI:** {percentage}%
-**Pros:** {Brief list}
-**Cons:** {Brief list}
-**Why not chosen:** {Reason}
-
-### Option 2: {Option Name}
-
-**Cost:** ${amount}
-**ROI:** {percentage}%
-**Pros:** {Brief list}
-**Cons:** {Brief list}
-**Why not chosen:** {Reason}
-
-### Option 3: Do Nothing
-
-**Cost:** ${opportunity cost}
-**Impact:** {Description of impact of not acting}
-**Why not chosen:** {Reason}
-
----
-
-## Decision Outcome
-
-**Chosen option:** "{Option X}"
-
-### Justification
-
-{Explain why this option provides the best business value, considering costs, benefits, risks, and strategic alignment}
-
-### Success Criteria
-
-{How will we measure success?}
-
-- {Criterion 1}
-- {Criterion 2}
-- {Criterion 3}
-
----
-
-## Implementation Timeline
-
-| Phase | Duration | Key Milestones | Cost |
-|-------|----------|----------------|------|
-| Phase 1: {Name} | {X weeks} | {Milestones} | ${amount} |
-| Phase 2: {Name} | {X weeks} | {Milestones} | ${amount} |
-| Phase 3: {Name} | {X weeks} | {Milestones} | ${amount} |
-
-**Total Duration:** {X months}
-
----
-
-## Stakeholder Impact
-
-### Internal Stakeholders
-
-| Stakeholder | Impact | Change Required | Support Level |
-|-------------|--------|-----------------|---------------|
-| {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
-| {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
-
-### External Stakeholders
-
-| Stakeholder | Impact | Communication Plan |
-|-------------|--------|--------------------|
-| {Customers} | {Description} | {Plan} |
-| {Partners} | {Description} | {Plan} |
-
----
-
-## Approval
-
-### Recommendation
-
-{Clear recommendation with supporting rationale}
-
-### Required Approvals
-
-- [ ] {Business Owner}
-- [ ] {Finance}
-- [ ] {Technical Lead}
-- [ ] {Executive Sponsor}
-
-### Approval Date
-
-{Date when decision was approved}
-
----
-
-## More Information
-
-### References
-
-- {Link to market research}
-- {Link to competitive analysis}
-- {Link to technical feasibility study}
-
-### Appendices
-
-- {Link to detailed financial model}
-- {Link to risk analysis}
-- {Link to stakeholder analysis}
-
+# ADR-{number}: {Title}
+
+**Status:** {Draft | Proposed | Approved | Implemented | Superseded | Deprecated}
+
+**Date:** {YYYY-MM-DD}
+
+**Deciders:** {List of people involved in the decision}
+
+**Business Owner:** {Name of business stakeholder}
+
+**Technical Story:** {Optional: Link to related issue, spec, or task}
+
+---
+
+## Executive Summary
+
+{Provide a 2-3 sentence summary of the decision, the problem it solves, and the expected business value.}
+
+---
+
+## Business Context
+
+### Problem Statement
+
+{Describe the business problem or opportunity. What pain points exist? What business goals are not being met?}
+
+### Current State
+
+{Describe the current situation, including existing solutions, workarounds, and their limitations}
+
+### Desired State
+
+{Describe the target state after implementing this decision. What will be different?}
+
+---
+
+## Strategic Alignment
+
+### Business Objectives
+
+{How does this decision align with organizational goals?}
+
+- {Objective 1}
+- {Objective 2}
+- {Objective 3}
+
+### Key Performance Indicators (KPIs)
+
+{What metrics will this decision impact?}
+
+- {KPI 1: Current value → Target value}
+- {KPI 2: Current value → Target value}
+- {KPI 3: Current value → Target value}
+
+---
+
+## Financial Analysis
+
+### Cost Breakdown
+
+#### Initial Investment
+
+| Category | Description | Cost |
+|----------|-------------|------|
+| Development | {Description} | ${amount} |
+| Infrastructure | {Description} | ${amount} |
+| Licensing | {Description} | ${amount} |
+| Training | {Description} | ${amount} |
+| **Total Initial** | | **${total}** |
+
+#### Ongoing Costs (Annual)
+
+| Category | Description | Cost |
+|----------|-------------|------|
+| Maintenance | {Description} | ${amount}/year |
+| Support | {Description} | ${amount}/year |
+| Licensing | {Description} | ${amount}/year |
+| Infrastructure | {Description} | ${amount}/year |
+| **Total Annual** | | **${total}/year** |
+
+### Return on Investment (ROI)
+
+#### Expected Benefits (Annual)
+
+| Benefit | Description | Value |
+|---------|-------------|-------|
+| Revenue Increase | {Description} | ${amount}/year |
+| Cost Savings | {Description} | ${amount}/year |
+| Efficiency Gains | {Description} | ${amount}/year |
+| **Total Annual Benefit** | | **${total}/year** |
+
+#### ROI Calculation
+
+- **Total Initial Investment:** ${amount}
+- **Annual Net Benefit:** ${annual benefit - annual cost}
+- **Payback Period:** {X months/years}
+- **3-Year ROI:** {percentage}%
+- **5-Year ROI:** {percentage}%
+
+### Risk-Adjusted ROI
+
+{Consider risks and their probability/impact on ROI}
+
+- **Best Case:** {ROI percentage}%
+- **Expected Case:** {ROI percentage}%
+- **Worst Case:** {ROI percentage}%
+
+---
+
+## Risk Assessment
+
+### Business Risks
+
+| Risk | Probability | Impact | Mitigation Strategy |
+|------|-------------|--------|---------------------|
+| {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
+| {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
+| {Risk 3} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
+
+### Technical Risks
+
+| Risk | Probability | Impact | Mitigation Strategy |
+|------|-------------|--------|---------------------|
+| {Risk 1} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
+| {Risk 2} | {Low/Med/High} | {Low/Med/High} | {Strategy} |
+
+---
+
+## Alternatives Considered
+
+### Option 1: {Option Name}
+
+**Cost:** ${amount}
+**ROI:** {percentage}%
+**Pros:** {Brief list}
+**Cons:** {Brief list}
+**Why not chosen:** {Reason}
+
+### Option 2: {Option Name}
+
+**Cost:** ${amount}
+**ROI:** {percentage}%
+**Pros:** {Brief list}
+**Cons:** {Brief list}
+**Why not chosen:** {Reason}
+
+### Option 3: Do Nothing
+
+**Cost:** ${opportunity cost}
+**Impact:** {Description of impact of not acting}
+**Why not chosen:** {Reason}
+
+---
+
+## Decision Outcome
+
+**Chosen option:** "{Option X}"
+
+### Justification
+
+{Explain why this option provides the best business value, considering costs, benefits, risks, and strategic alignment}
+
+### Success Criteria
+
+{How will we measure success?}
+
+- {Criterion 1}
+- {Criterion 2}
+- {Criterion 3}
+
+---
+
+## Implementation Timeline
+
+| Phase | Duration | Key Milestones | Cost |
+|-------|----------|----------------|------|
+| Phase 1: {Name} | {X weeks} | {Milestones} | ${amount} |
+| Phase 2: {Name} | {X weeks} | {Milestones} | ${amount} |
+| Phase 3: {Name} | {X weeks} | {Milestones} | ${amount} |
+
+**Total Duration:** {X months}
+
+---
+
+## Stakeholder Impact
+
+### Internal Stakeholders
+
+| Stakeholder | Impact | Change Required | Support Level |
+|-------------|--------|-----------------|---------------|
+| {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
+| {Team/Dept} | {Description} | {Changes needed} | {High/Med/Low} |
+
+### External Stakeholders
+
+| Stakeholder | Impact | Communication Plan |
+|-------------|--------|--------------------|
+| {Customers} | {Description} | {Plan} |
+| {Partners} | {Description} | {Plan} |
+
+---
+
+## Approval
+
+### Recommendation
+
+{Clear recommendation with supporting rationale}
+
+### Required Approvals
+
+- [ ] {Business Owner}
+- [ ] {Finance}
+- [ ] {Technical Lead}
+- [ ] {Executive Sponsor}
+
+### Approval Date
+
+{Date when decision was approved}
+
+---
+
+## More Information
+
+### References
+
+- {Link to market research}
+- {Link to competitive analysis}
+- {Link to technical feasibility study}
+
+### Appendices
+
+- {Link to detailed financial model}
+- {Link to risk analysis}
+- {Link to stakeholder analysis}
+