Claude Code CommandUtilities43 installs

Architecture Scenario Explorer

Install with the Claude Code Templates CLI
$ npx claude-code-templates@latest --command="utilities/architecture-scenario-explorer" --yes

Requires Claude Code. The command adds this command to your project's .claudedirectory — nothing runs on ToolZip's servers.

What's inside this command

Component source (preview)

Architecture Scenario Explorer

Explore architectural decisions through systematic scenario analysis with trade-off evaluation and future-proofing assessment.

Instructions

You are tasked with systematically exploring architectural decisions through comprehensive scenario modeling to optimize system design choices. Follow this approach: $ARGUMENTS

1. Prerequisites Assessment

Critical Architecture Context Validation:
  • System Scope: What system or component architecture are you designing?
  • Scale Requirements: What are the expected usage patterns and growth projections?
  • Constraints: What technical, business, or resource constraints apply?
  • Timeline: What is the implementation timeline and evolution roadmap?
  • Success Criteria: How will you measure architectural success?

If context is unclear, guide systematically:
Missing System Scope:
"What specific system architecture needs exploration?
- New System Design: Greenfield application or service architecture
- System Migration: Moving from legacy to modern architecture
- Scaling Architecture: Expanding existing system capabilities
- Integration Architecture: Connecting multiple systems and services
- Platform Architecture: Building foundational infrastructure

Please specify the system boundaries, key components, and primary functions."

Missing Scale Requirements:
"What are the expected system scale and usage patterns?
- User Scale: Number of concurrent and total users
- Data Scale: Volume, velocity, and variety of data processed
- Transaction Scale: Requests per second, peak load patterns
- Geographic Scale: Single region, multi-region, or global distribution
- Growth Projections: Expected scaling timeline and magnitude"

2. Architecture Option Generation

Systematically identify architectural approaches:

Architecture Pattern Matrix

Architectural Approach Framework:

Monolithic Patterns:
- Layered Architecture: Traditional n-tier with clear separation
- Modular Monolith: Well-bounded modules within single deployment
- Plugin Architecture: Core system with extensible plugin ecosystem
- Service-Oriented Monolith: Internal service boundaries with single deployment

Distributed Patterns:
- Microservices: Independent services with business capability alignment
- Service Mesh: Microservices with infrastructure-level communication
- Event-Driven: Asynchronous communication with event sourcing
- CQRS/Event Sourcing: Command-query separation with event storage

Hybrid Patterns:
- Modular Microservices: Services grouped by business domain
- Micro-Frontend: Frontend decomposition matching backend services
- Strangler Fig: Gradual migration from monolith to distributed
- API Gateway: Centralized entry point with backend service routing

Cloud-Native Patterns:
- Serverless: Function-based with cloud provider infrastructure
- Container-Native: Kubernetes-first with cloud-native services
- Multi-Cloud: Cloud-agnostic with portable infrastructure
- Edge-First: Distributed computing with edge location optimization

Architecture Variation Specification

For each architectural option:

Structural Characteristics:
- Component Organization: [how system parts are structured and related]
- Communication Patterns: [synchronous vs asynchronous, protocols, messaging]
- Data Management: [database strategy, consistency model, storage patterns]
- Deployment Model: [packaging, distribution, scaling, and operational approach]

Quality Attributes:
- Scalability Profile: [horizontal vs vertical scaling, bottleneck analysis]
- Reliability Characteristics: [failure modes, recovery, fault tolerance]
- Performance Expectations: [latency, throughput, resource efficiency]
- Security Model: [authentication, authorization, data protection, attack surface]

Implementation Considerations:
- Technology Stack: [languages, frameworks, databases, infrastructure]
- Team Structure Fit: [Conway's Law implications, team capabilities]
- Development Process: [build, test, deploy, monitor workflows]
- Evolution Strategy: [how architecture can grow and change over time]

3. Scenario Framework Development

Create comprehensive architectural testing scenarios:

Usage Scenario Matrix

Multi-Dimensional Scenario Framework:

Load Scenarios:
- Normal Operation: Typical daily usage patterns and traffic
- Peak Load: Maximum expected concurrent usage and transaction volume
- Stress Testing: Beyond normal capacity to identify breaking points
- Spike Testing: Sudden traffic increases and burst handling

Growth Scenarios:
- Linear Growth: Steady user and data volume increases over time
- Exponential Growth: Rapid scaling requirements and viral adoption
- Geographic Expansion: Multi-region deployment and global scaling
- Feature Expansion: New capabilities and service additions

Failure Scenarios:
- Component Failures: Individual service or database outages
- Infrastructure Failures: Network, storage, or compute disruptions
- Cascade Failures: Failure propagation and system-wide impacts
- Disaster Recovery: Major outage recovery and business continuity

Evolution Scenarios:
- Technology Migration: Framework, language, or platform changes
- Business Model Changes: New revenue streams or service offerings
- Regulatory Changes: Compliance requirements and data protection
- Competitive Response: Market pressures and feature requirements

Scenario Impact Modeling

  • Performance impact under each scenario type
  • Cost implications for infrastructure and operations
  • Development velocity and team productivity effects
  • Risk assessment and mitigation requirements

4. Trade-off Analysis Framework

Systematic evaluation of architectural trade-offs:

Quality Attribute Trade-off Matrix

Architecture Quality Assessment:

Performance Trade-offs:
- Latency vs Throughput: Response time vs maximum concurrent processing
- Memory vs CPU: Resource utilization optimization strategies
- Consistency vs Availability: CAP theorem implications and choices
- Caching vs Freshness: Data staleness vs response speed

Scalability Trade-offs:
- Horizontal vs Vertical: Infrastructure scaling approach and economics
- Stateless vs Stateful: Session management and performance implications
- Synchronous vs Asynchronous: Communication complexity vs performance
- Coupling vs Autonomy: Service independence vs operational overhead

Development Trade-offs:
- Development Speed vs Runtime Performance: Optimization time investment
- Type Safety vs Flexibility: Compile-time vs runtime error handling
- Code Reuse vs Service Independence: Shared libraries vs duplication
- Testing Complexity vs System Reliability: Test investment vs quality

Operational Trade-offs:
- Complexity vs Control: Managed services vs self-managed infrastructure
- Monitoring vs Privacy: Observability vs data protection
- Automation vs Flexibility: Standardization vs customization
- Cost vs Performance: Infrastructure spending vs response times

Decision Matrix Construction

  • Weight assignment for different quality attributes based on business priorities
  • Scoring methodology for each architecture option across quality dimensions
  • Sensitivity analysis for weight and score variations
  • Pareto frontier identification for non-dominated solutions

5. Future-Proofing Assessment

Evaluate architectural adaptability and evolution potential:

Technology Evolution Scenarios

Future-Proofing Analysis Framework:

Technology Trend Integration:
- AI/ML Integration: Machine learning capability embedding and scaling
- Edge Computing: Distributed processing and low-latency requirements
- Quantum Computing: Post-quantum cryptography and computational impacts
- Blockchain/DLT: Distributed ledger integration and trust mechanisms

Market Evolution Preparation:
- Business Model Flexibility: Subscription, marketplace, platform pivots
- Global Expansion: Multi-tenant, multi-region, multi-regulatory compliance
- Customer Expectation Evolution: Real-time, personalized, omnichannel experiences
- Competitive Landscape Changes: Feature parity and differentiation requirements

Regulatory Future-Proofing:
- Privacy Regulation: GDPR, CCPA evolution and global privacy requirements
- Security Standards: Zero-trust, compliance framework evolution
- Data Sovereignty: Geographic data residency and cross-border restrictions
- Accessibility Requirements: Inclusive design and assistive technology support

Adaptability Scoring

  • Architecture flexibility for requirement changes
  • Technology migration feasibility and cost
  • Team skill evolution and learning curve management
  • Investment protection and technical debt management

6. Architecture Simulation Engine

Model architectural behavior under different scenarios:

Performance Simulation Framework

Multi-Layer Architecture Simulation:

Component-Level Simulation:
- Individual service performance characteristics and resource usage
- Database query performance and optimization opportunities
- Cache hit ratios and invalidation strategies
- Message queue throughput and latency patterns

Integration-Level Simulation:
- Service-to-service communication overhead and optimization
- API gateway performance and routing efficiency
- Load balancer distribution and health checking
- Circuit breaker and retry mechanism effectiveness

System-Level Simulation:
- End-to-end request flow and user experience
- Peak load distribution and resource allocation
- Failure propagation and recovery patterns
- Monitoring and alerting system effectiveness

Infrastructure-Level Simulation:
- Cloud resource utilization and auto-scaling behavior
- Network bandwidth and latency optimization
- Storage performance and data consistency patterns
- Security policy enforcement and performance impact

Cost Modeling Integration

  • Infrastructure cost estimation across different scenarios
  • Development and operational cost projection
  • Total cost of ownership analysis over multi-year timeline
  • Cost optimization opportunities and trade-off analysis

7. Risk Assessment and Mitigation

Comprehensive architectural risk evaluation:

Technical Risk Framework

Architecture Risk Assessment:

Implementation Risks:
- Technology Maturity: New vs proven technology adoption risks
- Complexity Management: System comprehension and debugging challenges
- Integration Challenges: Third-party service dependencies and compatibility
- Performance Uncertainty: Untested scaling and optimization requirements

Operational Risks:
- Deployment Complexity: Release management and rollback capabilities
- Monitoring Gaps: Observability and troubleshooting limitations
- Scaling Challenges: Auto-scaling reliability and cost control
- Disaster Recovery: Backup, recovery, and business continuity planning

Strategic Risks:
- Technology Lock-in: Vendor dependency and migration flexibility
- Skill Dependencies: Team expertise requirements and knowledge gaps
- Evolution Constraints: Architecture modification and extension limitations
- Competitive Disadvantage: Time-to-market and feature development speed

Risk Mitigation Strategy Development

  • Specific mitigation approaches for identified risks
  • Contingency planning and alternative architecture options
  • Early warning indicators and monitoring strategies
  • Risk acceptance criteria and stakeholder communication

8. Decision Framework and Recommendations

Generate systematic architectural guidance:

Architecture Decision Record (ADR) Format

```

Architecture Decision: [System Name] - [Decision Topic]

Context and Problem Statement

  • Business Requirements: [key functional and non-functional requirements]
  • Current Constraints: [technical, resource, and timeline limitations]
  • Decision Drivers: [factors influencing architectural choice]

Architecture Options Considered

Option 1: [Architecture Name]

  • Description: [architectural approach and ke

Preview truncated. View the full source on GitHub →

Type
Command
Category
Utilities
Installs
43
Source
GitHub ↗

Related Claude Code Commands

Catalog data and component content are sourced from the open-source davila7/claude-code-templates project (MIT license). ToolZip curates the listing and writes original descriptions; every component links back to its original source. Claude Code is a product of Anthropic. ToolZip is an independent catalog and is not affiliated with or endorsed by Anthropic.