Prompt Details
Model
Chat - (gpt-5.5)
Token size
1,113
Example input
[PROJECT_NAME]: CustomerHub SaaS Platform Modernization
[SYSTEM_CONTEXT]: A growing SaaS CRM platform currently runs as a single monolithic application deployed on virtual machines. Engineering teams want faster releases, improved scalability, and better reliability while supporting rapid customer growth.
[TECHNICAL_DECISION]: Should the platform remain a modular monolith or migrate to a Kubernetes-based microservices architecture?
[ARCHITECTURE_CONSTRAINTS]: Six-person engineering team
[BUSINESS_OBJECTIVES]: Reduce deployment time
Example output
A. DECISION CONTEXT
Business Context
CustomerHub has experienced 300% customer growth over the past two years. The current monolithic architecture slows feature delivery and increases deployment risk. The company plans to expand into multiple regions while maintaining high availability.
Technical Context
The application is built with Java Spring Boot, uses PostgreSQL as the primary database, and runs on AWS EC2 behind an Application Load Balancer. All services are deployed together, making releases lengthy and risky.
Stakeholders
CTO
Engineering Manager
Platform Engineering Team
Backend Developers
DevOps Engineers
Product Management
Enterprise Customers
Problem Statement
The existing architecture limits deployment speed, scalability, and independent team ownership. A long-term architecture strategy is required.
Decision Urgency
High. Platform growth is accelerating, and upcoming enterprise contracts require improved scalability within the next six months.
Architecture Decision Summary
Evaluate whether to continue evolving the modular monolith or adopt a Kubernetes-based microservices architecture while balancing engineering capacity, operational complexity, and long-term scalability.
B. CURRENT ARCHITECTURE REVIEW
Existing Architecture
Java Spring Boot Monolith
PostgreSQL
AWS EC2
Redis Cache
RabbitMQ
REST APIs
System Boundaries
Authentication
Customer Management
Billing
Notifications
Reporting
All modules execute within the same application.
Dependencies
PostgreSQL
Redis
RabbitMQ
AWS Load Balancer
S3 Storage
Technology Stack
Java 21
Spring Boot
PostgreSQL
Redis
RabbitMQ
Docker
GitHub Actions
Infrastructure
AWS EC2
Application Load Balancer
Auto Scaling Group
Amazon RDS
CloudWatch
Strengths
Simple deployment
Mature codebase
Easy debugging
Low operational overhead
Strong transactional consistency
Weaknesses
Large deployments
Scaling entire application
Slow release cycles
Tight module coupling
Single deployment risk
C. ALTERNATIVE ANALYSIS
Alternative 1: Continue Modular Monolith
Benefits
Lowest migration risk
Lower operational complexity
Faster implementation
Lower infrastructure cost
Risks
Limited independent scaling
Larger deployments remain
Complexity
Medium
Cost
Low
Scalability
Moderate
Security
Strong centralized controls
Maintainability
Good with modular discipline
Operational Impact
Minimal operational changes
Alternative 2: Kubernetes Microservices
Benefits
Independent deployments
Independent scaling
Better fault isolation
Team autonomy
Risks
Increased operational complexity
Service communication challenges
Distributed system failures
Complexity
High
Cost
High
Scalability
Excellent
Security
Requires service identity and zero-trust networking
Maintainability
Excellent after stabilization
Operational Impact
Major infrastructure transformation
Alternative 3: Hybrid Evolution
Benefits
Gradual migration
Reduced migration risk
Preserve existing investment
Learn incrementally
Risks
Temporary mixed architecture
Additional governance required
Complexity
Medium-High
Cost
Medium
Scalability
High
Security
Incremental improvements
Maintainability
Very Good
Operational Impact
Manageable transition
D. TECHNICAL TRADE-OFF ANALYSIS
Category
Modular Monolith
Hybrid
Microservices
Performance
High
High
Moderate
Reliability
Good
Very Good
Excellent
Scalability
Moderate
High
Excellent
Security
Good
Very Good
Excellent
Developer Experience
Excellent
Good
Moderate
Operational Complexity
Low
Medium
High
Vendor Lock-in
Low
Medium
Medium
Technical Debt
Medium
Low
Low
Major Trade-Offs
Microservices improve scalability but significantly increase operational complexity.
Modular monolith minimizes cost but limits future scaling.
Hybrid evolution balances risk and long-term flexibility.
Kubernetes introduces new infrastructure management responsibilities.
Incremental migration reduces business disruption.
E. ARCHITECTURE DECISION RECORD (ADR)
Title
Adopt Hybrid Evolution Toward Kubernetes-Based Microservices
Status
Accepted
Date
2026-07-10
Context
The platform requires improved scalability and deployment independence while minimizing migration risk.
Decision
Adopt a phased hybrid architecture. Extract high-value services incrementally while retaining the modular monolith for stable domains.
Alternatives Considered
Modular Monolith
Full Microservices
Hybrid Evolution
Consequences
Positive
Lower migration risk
Incremental learning
Better scalability
Faster releases
Negative
Temporary architectural complexity
Mixed deployment strategies
Risks
Service boundary mistakes
Operational maturity gap
Data consistency challenges
Mitigation Plan
Architecture review board approval
Domain-driven design workshops
Automated testing
Progressive rollout
Observability platform
Review Trigger
Review after:
Six months
50% service extraction
Major customer growth
Platform incident trends
F. GOVERNANCE REVIEW
Standards Compliance
8/10
Architectural Principles
Strong alignment with modularity and scalability.
Technology Consistency
Consistent technology stack with gradual modernization.
Documentation Quality
Well documented but requires ongoing ADR updates.
Review Requirements
Quarterly architecture review
Security review
Performance benchmarking
Cost review
Governance Improvements
Formal Architecture Review Board
Mandatory ADR for major changes
Standard technology catalog
Architecture fitness functions
Regular technical debt review
G. IMPLEMENTATION IMPACT
Codebase
Medium-High impact
Infrastructure
High impact
APIs
Medium impact
Data
Medium impact
Security
High impact
Operations
High impact
Testing
High impact
CI/CD
Medium impact
Estimated Implementation Complexity
High (8/10)
H. ARCHITECTURE GOVERNANCE SCORECARD
Decision Quality: 9/10
Documentation: 9/10
Maintainability: 9/10
Scalability: 10/10
Risk Management: 8/10
Technical Alignment: 9/10
Governance: 8/10
Overall Architecture Governance Score
89/100
I. IMPLEMENTATION ROADMAP
Phase 1 – Validation
Objectives
Validate business goals
Identify bounded contexts
Benchmark current system
Deliverables
Architecture assessment
ADR approval
Migration plan
Success Metrics
Stakeholder approval
Performance baseline
Risks
Incorrect service boundaries
Phase 2 – Architecture Preparation
Objectives
Build Kubernetes platform
Establish CI/CD
Implement observability
Deliverables
Cluster
Monitoring
Logging
Deployment pipelines
Success Metrics
Successful staging deployments
Risks
Infrastructure delays
Phase 3 – Implementation
Objectives
Extract Billing Service
Extract Notification Service
Enable independent deployments
Deliverables
Production services
API Gateway
Service monitoring
Success Metrics
Deployment frequency doubled
Zero critical incidents
Risks
Integration failures
Phase 4 – Post-Implementation Review
Objectives
Measure outcomes
Review architecture
Capture lessons learned
Deliverables
Updated ADRs
Governance report
Optimization backlog
Success Metrics
Improved deployment speed
Improved availability
Reduced incident rate
Risks
Unresolved technical debt
J. EXECUTIVE ARCHITECTURE REPORT
Architecture Decision Summary
Adopt a hybrid modernization strategy that incrementally transitions from a modular monolith to Kubernetes-based microservices, balancing scalability, operational risk, and long-term maintainability.
Top 10 Architecture Insights
The current monolith remains stable but limits scalability.
Independent deployments increase delivery speed.
Kubernetes introduces operational complexity.
Hybrid migration minimizes business disruption.
Observability becomes critical in distributed systems.
Domain boundaries must be clearly defined.
CI/CD maturity is essential.
Security must evolve toward zero trust.
Governance should guide technology adoption.
Continuous ADR documentation preserves engineering knowledge.
Top 5 Trade-Offs
Scalability vs operational complexity
Speed of migration vs implementation risk
Developer autonomy vs governance consistency
Infrastructure cost vs long-term flexibility
Simplicity vs future scalability
Top 5 Implementation Risks
Incorrect service decomposition
Increased operational overhead
Data consistency issues
Deployment failures
Team learning curve
Top 5 Governance Improvements
Mandatory ADR process
Architecture Review Board
Standardized technology catalog
Quarterly architecture audits
Continuous documentation updates
Architecture Governance Score
89/100
Most Important Decision to Validate
Validate that the selected service boundaries align with business domains before extracting any microservices.
One Rule for All Future Architecture Decisions
Every significant architecture decision must be documented with its context, alternatives, trade-offs, risks, and expected long-term consequences before implementation begins.
By purchasing this prompt, you agree to our terms of service
GPT-5.5
Every important technical decision deserves a documented rationale.
This prompt helps engineering teams create enterprise-grade Architecture Decision Records (ADRs), evaluate technical alternatives, analyze trade-offs, strengthen architecture governance, and preserve engineering knowledge for future teams.
Instead of relying on tribal knowledge or scattered documentation, you'll build a structured decision history that improves consistency, onboarding, and long-term maintainability.
...more
Added over 1 month ago
