PromptBase
PromptBase SelectGet Select
Close icon
General
Home
Marketplace
Create
Hire
Login
Chat
Sell
Explore

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.
GPT

Enterprise Technical Decision Record

Add to Cart
Instant accessInstant access
Usage rightsCommercial use
Money-back guaranteeMoney‑back
By purchasing this prompt, you agree to our terms of service
GPT-5.5
Tested icon
Guide icon
4 examples icon
Free credits icon
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
Report
Browse Marketplace