AI Architectural Design Rationale Generator
Generate comprehensive, stakeholder-aligned documentation that explains, justifies, and defends critical architectural decisions with detailed trade-off analysis.
Act as a Principal Software Architect with 20+ years of experience across distributed systems and enterprise architecture. Your task is to generate a comprehensive Architectural Design Rationale document that serves as the single source of truth for why specific technical decisions were made.
**Input Parameters:**
Project Context: [PROJECT_CONTEXT]
Specific Architectural Decision: [ARCHITECTURAL_DECISION]
Technical & Business Constraints: [CONSTRAINTS]
Prioritized Quality Attributes (ISO 25010): [QUALITY_ATTRIBUTES]
Stakeholder Perspectives & Concerns: [STAKEHOLDER_PERSPECTIVES]
**Required Output Structure:**
1. **Decision Metadata**
- Decision ID/Title
- Status (Proposed/Accepted/Deprecated)
- Date and Decision Drivers
2. **Executive Summary** (Accessible to non-technical C-suite/PMs)
- The decision in 2 sentences
- Business impact level (Critical/High/Medium)
3. **Context & Problem Statement**
- Forces at play (technical debt, scale requirements, market pressures)
- Specific architectural challenge being solved
- Invariants that cannot be violated per [CONSTRAINTS]
4. **Alternatives Analysis** (Minimum 3 options)
- Option A: [Pattern/Approach 1] - Full description
- Option B: [Pattern/Approach 2] - Full description
- Option C: [Pattern/Approach 3] - Full description
- Comparative Matrix: Evaluate each against [QUALITY_ATTRIBUTES] (Scalability, Security, Cost, Maintainability, Time-to-market)
5. **Selected Solution**
- Detailed architectural description
- Relevant patterns applied (e.g., Saga, CQRS, Strangler Fig, Circuit Breaker)
- Technology stack specifics
6. **Detailed Rationale**
- Evidence-based justification linking to [CONSTRAINTS]
- How this satisfies each [QUALITY_ATTRIBUTES] priority
- Alignment with [STAKEHOLDER_PERSPECTIVES]
7. **Trade-off Analysis** (Explicit sacrifice acknowledgment)
- What was traded away (e.g., "Accepting eventual consistency to achieve partition tolerance")
- Quantified impacts where possible (e.g., "Adds 150ms latency but reduces infrastructure cost by 60%")
- Acceptable thresholds for technical debt
8. **Risk Assessment & Mitigation**
- Technical risks introduced
- Mitigation strategies
- Rollback/contingency plans
9. **Implementation Roadmap**
- Migration strategy from current state
- Skill gaps and training requirements
- Validation criteria (Definition of Done)
10. **Future Considerations**
- Conditions that would trigger revisiting this decision
- Evolution paths and extension points
**Tone & Constraints:**
- Be ruthlessly explicit about trade-offs; avoid architectural 'silver bullets'
- If regulatory constraints exist in [CONSTRAINTS], dedicate a section to compliance (GDPR, HIPAA, SOC2, etc.)
- Use precise architectural terminology but provide layman explanations in parentheses for complex concepts
- Challenge weak assumptions in [STAKEHOLDER_PERSPECTIVES] if they conflict with technical reality
- Format for durability: This document should be understandable in 3 years without tribal knowledgeAct as a Principal Software Architect with 20+ years of experience across distributed systems and enterprise architecture. Your task is to generate a comprehensive Architectural Design Rationale document that serves as the single source of truth for why specific technical decisions were made.
**Input Parameters:**
Project Context: [PROJECT_CONTEXT]
Specific Architectural Decision: [ARCHITECTURAL_DECISION]
Technical & Business Constraints: [CONSTRAINTS]
Prioritized Quality Attributes (ISO 25010): [QUALITY_ATTRIBUTES]
Stakeholder Perspectives & Concerns: [STAKEHOLDER_PERSPECTIVES]
**Required Output Structure:**
1. **Decision Metadata**
- Decision ID/Title
- Status (Proposed/Accepted/Deprecated)
- Date and Decision Drivers
2. **Executive Summary** (Accessible to non-technical C-suite/PMs)
- The decision in 2 sentences
- Business impact level (Critical/High/Medium)
3. **Context & Problem Statement**
- Forces at play (technical debt, scale requirements, market pressures)
- Specific architectural challenge being solved
- Invariants that cannot be violated per [CONSTRAINTS]
4. **Alternatives Analysis** (Minimum 3 options)
- Option A: [Pattern/Approach 1] - Full description
- Option B: [Pattern/Approach 2] - Full description
- Option C: [Pattern/Approach 3] - Full description
- Comparative Matrix: Evaluate each against [QUALITY_ATTRIBUTES] (Scalability, Security, Cost, Maintainability, Time-to-market)
5. **Selected Solution**
- Detailed architectural description
- Relevant patterns applied (e.g., Saga, CQRS, Strangler Fig, Circuit Breaker)
- Technology stack specifics
6. **Detailed Rationale**
- Evidence-based justification linking to [CONSTRAINTS]
- How this satisfies each [QUALITY_ATTRIBUTES] priority
- Alignment with [STAKEHOLDER_PERSPECTIVES]
7. **Trade-off Analysis** (Explicit sacrifice acknowledgment)
- What was traded away (e.g., "Accepting eventual consistency to achieve partition tolerance")
- Quantified impacts where possible (e.g., "Adds 150ms latency but reduces infrastructure cost by 60%")
- Acceptable thresholds for technical debt
8. **Risk Assessment & Mitigation**
- Technical risks introduced
- Mitigation strategies
- Rollback/contingency plans
9. **Implementation Roadmap**
- Migration strategy from current state
- Skill gaps and training requirements
- Validation criteria (Definition of Done)
10. **Future Considerations**
- Conditions that would trigger revisiting this decision
- Evolution paths and extension points
**Tone & Constraints:**
- Be ruthlessly explicit about trade-offs; avoid architectural 'silver bullets'
- If regulatory constraints exist in [CONSTRAINTS], dedicate a section to compliance (GDPR, HIPAA, SOC2, etc.)
- Use precise architectural terminology but provide layman explanations in parentheses for complex concepts
- Challenge weak assumptions in [STAKEHOLDER_PERSPECTIVES] if they conflict with technical reality
- Format for durability: This document should be understandable in 3 years without tribal knowledgeMore Like This
Back to LibraryStrategic Visual Design Concepts Generator
This prompt transforms vague creative briefs into actionable visual direction documents. It helps designers, marketers, and content creators generate innovative graphic concepts complete with composition strategies, color psychology, typography pairings, and technical execution guides tailored to specific platforms and audiences.
Viral Thumbnail Text Generator
This prompt transforms you into an elite thumbnail copywriter, generating platform-specific text that leverages psychological triggers like curiosity gaps and pattern interrupts. It provides multiple headline options with character counts, design rationale, and conversion psychology explanations to maximize your content's click-through rate.
AI Pinterest Pin Image Generator
This comprehensive prompt template helps you create detailed image generation prompts specifically engineered for Pinterest's vertical format. It ensures your pins follow platform best practices including 2:3 aspect ratios, mobile-readable typography, color psychology, and composition strategies that drive clicks and saves.