/scenario
Create a Scenario note for what-if analysis, future-state planning, alternative architecture options, or risk mitigation strategies.
Usage
code
/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
- •Extract scenario name
- •Ask for scenario type:
code
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
code
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:
code
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
code
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:
code
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:
code
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:
code
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
yaml
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
- •Executive Summary: 1-2 paragraphs
- •Baseline Architecture: Current state overview
- •Proposed State: What changes
- •Full Scenario Architecture: Diagram showing proposed
- •Detailed Changes: System-by-system walkthrough
- •Impact Analysis: Business, technical, cost, organizational
- •Comparison Matrix: Current vs Proposed vs Alternatives
- •Risk & Mitigation: Key risks and mitigation strategies
- •Phased Implementation Plan: Timeline by phase
- •Success Metrics & KPIs: How to measure success
- •Go/No-Go Decision Criteria: When to proceed
- •Related Documentation: Links to Architectures, ADRs
Phase 10: Create File
Filename: Scenario - {{name}}.md
Location: Vault root
Output:
code
✅ 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
code
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