/scenario

Create a Scenario note for what-if analysis, future-state planning, alternative architecture options, or risk mitigation strategies.

Usage

/scenario <name>
/scenario "SAP Cloud Migration"
/scenario "Real-time Analytics" --type future-state
/scenario "Vendor Alternative: Google vs AWS" --type alternative-option

Instructions

Phase 1: Parse Input & Type

1. Extract scenario name
2. Ask for scenario type:

   Scenario Type:
   - current-state (baseline for comparison)
   - future-state (where we want to go)
   - alternative-option (different approach)
   - risk-mitigation (contingency plan)
   Default: future-state
   

Phase 2: Baseline Architecture

What is the baseline architecture for this scenario?
(Choose existing Architecture note)

Search: [[Architecture - Current State HLD]]
Found: [[Architecture - Current State HLD]]

Confirm baseline? (Y/n)
> y

Phase 3: What Changes?

For future-state / alternative scenarios, ask:

What changes from the baseline?

System Additions (comma-separated or one per line):
> SAP S/4HANA Cloud
> SAP Event Mesh

System Removals:
> SAP LegacyEngineeringSystem (legacy)

System Modifications:
> DataPlatform (add real-time event consumer)
> Snowflake (increase storage)

Integration Changes:
> Add: Event-driven SAP to DataPlatform
> Remove: Daily batch sync
> Modify: DataPlatform to Snowflake (add real-time)

Phase 4: Systems Involved

Systems in this scenario (for quick view):
- [[System - SAP S/4HANA Cloud]]
- [[System - Event Mesh]]
- [[System - DataPlatform]]
- [[System - Snowflake]]

Phase 5: Impact Analysis

Ask: "Analyse impact? (Y/n)"

If YES:

BUSINESS IMPACT:
Benefits:
> Real-time data enables faster decisions
> Reduced reporting lag from 24h to <1s
> Better customer experience

Risks:
> Migration disruption (1-2 week freeze)
> Higher licensing costs
> Team learning curve

TECHNICAL IMPACT:
Capabilities enabled:
> Event-driven architecture
> Real-time data pipelines
> Stream processing

Technical debt reduced:
> Legacy LegacyEngineeringSystem system (EOL'd)
> Point-to-point integrations (replaced)
> Batch workflows (replaced with streams)

COST IMPACT:
Implementation: £1,250,000
  - SAP migration: £800k
  - Integration: £300k
  - Analytics: £150k

Annual savings: £250,000 (infrastructure reduction)
Payback: 5 years

ORGANIZATIONAL IMPACT:
Resources: 27 people over 12 months
Budget: £1,250,000
Skills needed: SAP Cloud, Event-driven patterns, Kafka
Training required: 2 weeks per person

Phase 6: Trade-offs & Comparison

Ask: "Compare with alternatives? (Y/n)"

If YES:

Alternative A: Vendor X SaaS
- Cost: Low (£300k/year)
- Timeline: 3 months
- Complexity: Low
- Flexibility: Limited

Alternative B: Keep current, add analytics tools
- Cost: £150k/year (tooling)
- Timeline: 6 months
- Complexity: Low
- Flexibility: High

Recommended: [Select which]

Phase 7: Decision Framework

Ask: "Add decision criteria? (Y/n)"

If YES:

Go/No-Go Criteria:

GREEN LIGHT (Proceed):
- Budget secured
- Architecture approved
- Team available
- Executive sponsorship

YELLOW LIGHT (Conditions):
- Budget reduced (adjust scope)
- Timeline extended (resource constraints)
- Pilot approach (smaller initial scope)

RED LIGHT (Hold/Reject):
- SAP readiness < 40%
- Budget unavailable
- Key resources unavailable

Recommended: GREEN (full implementation)
Approval Status: Proposed

Phase 8: Generate Frontmatter

type: Scenario
title: "{{name}}"

scenarioId: "SCEN-{{name|sanitize}}-001"
scenarioType: {{type}}
version: "1.0"
createdDate: 2026-01-14
owner: "[[Person - {{user}}]]"

baselineArchitecture: "[[Architecture - {{baseline}}]]"
timeframe: {{timeframe}}

systemsAdded: [{{systems}}]
systemsRemoved: [{{systems}}]
systemsModified: [{{systems}}]

integrationsAdded: [{{integrations}}]
integrationsRemoved: [{{integrations}}]
integrationsModified: [{{integrations}}]

recommendedApproach: {{recommended}}
decisionStatus: proposed

confidence: medium
freshness: current
verified: false

created: 2026-01-14
tags: [type/scenario, {{type|lower}}]

Phase 9: Generate Body Content

1. Executive Summary: 1-2 paragraphs
2. Baseline Architecture: Current state overview
3. Proposed State: What changes
4. Full Scenario Architecture: Diagram showing proposed
5. Detailed Changes: System-by-system walkthrough
6. Impact Analysis: Business, technical, cost, organizational
7. Comparison Matrix: Current vs Proposed vs Alternatives
8. Risk & Mitigation: Key risks and mitigation strategies
9. Phased Implementation Plan: Timeline by phase
10. Success Metrics & KPIs: How to measure success
11. Go/No-Go Decision Criteria: When to proceed
12. Related Documentation: Links to Architectures, ADRs

Phase 10: Create File

Filename: Scenario - {{name}}.md

Location: Vault root

Output:

✅ Created: Scenario - {{name}}.md

Scenario Type: {{type}}
Status: {{status}}
Recommendation: {{recommended}}

Baseline: [[Architecture - {{baseline}}]]

Systems impacted: {{count}}
Integrations changed: {{count}}

Estimated cost: {{cost}}
Timeline: {{timeline}}

Next steps:
1. Review with stakeholders
2. Get executive approval: /decision {{scenario}}
3. Create project: /project {{scenario}}
4. Develop detailed plan: /architecture --type lld

Example Interaction

User: /scenario "SAP Cloud Migration"

Scenario Type (default: future-state):
> future-state

Baseline Architecture:
> [[Architecture - Current State HLD]]

Systems being added:
> SAP S/4HANA Cloud
> SAP Event Mesh

Systems being removed:
> SAP LegacyEngineeringSystem (legacy)

Integration changes:
> Add event-driven SAP Cloud → DataPlatform
> Remove batch SAP → DataPlatform

Impact Analysis? (Y/n)
> y

Business Impact:
Benefits:
> Real-time data, faster decisions, reduced reporting lag

Risks:
> Migration disruption, higher costs, learning curve

Cost Impact:
Implementation: 1,250,000
Annual Savings: 250,000

Timeline? (Y/n)
> y

Phase 1 (Q1 2026): Planning (3 months)
Phase 2 (Q2 2026): SAP Cloud migration (3 months)
Phase 3 (Q3-Q4 2026): Integration modernization (4 months)

Compare with alternatives? (Y/n)
> y

Alternative A: Keep current, add tools (£150k, 6 months)
Alternative B: Vendor X SaaS (£300k, 3 months)

✅ Created: Scenario - SAP Cloud Migration.md

Status: Proposed
Recommendation: Proceed (GREEN light)

Next: Review with stakeholders and get approval