feat: enhance architecture templates with Google, Enterprise, and Arc42 variants

[mgiovani]

🏗️ Enhanced Architecture Templates with Professional Variants

This PR significantly enhances the architecture documentation capabilities by providing three comprehensive template variants following industry standards.

🚀 What's Changed

✨ New Architecture Templates

1. Enhanced Google Style Template (architecture_google.md) - 280+ lines

   • Comprehensive template following Google's documentation standards
   • Includes: Overview, System Context, Goals/Non-Goals, Detailed Design, Technology Stack, Security, Performance, Operations
   • Perfect for teams following Google's engineering practices

2. Enterprise Template (architecture_enterprise.md) - 350+ lines

   • Comprehensive enterprise architecture documentation
   • Includes: Executive Summary, Business Architecture, Application Architecture, Data Architecture, Technology Architecture, Governance, Risk Management
   • Perfect for large organizations and TOGAF-style documentation

3. Arc42 Template (architecture_arc.md) - 450+ lines

   • Complete implementation of the Arc42 documentation standard
   • Includes: All 12 Arc42 sections from Introduction/Goals to Glossary
   • Perfect for teams following Arc42 methodology

🔧 Template Features

Consistent Placeholder System

All templates use standardized placeholders:

• {{PROJECT_NAME}} - Project/system name
• {{DATE}} - Current date
• {{VERSION}} - Document version
• {{AUTHORS}} - Document authors
• Plus template-specific placeholders for comprehensive documentation

Industry Best Practices

• Google Style: Based on Google's engineering documentation standards
• Enterprise: Follows TOGAF and enterprise architecture best practices
• Arc42: Complete implementation of the widely-adopted Arc42 template

Template Complexity Levels

• Google Style: Balanced technical focus with business context
• Enterprise: Heavy business focus with comprehensive governance
• Arc42: Structured 12-section approach with detailed technical views

🔄 Breaking Changes

None - This is fully backward compatible:

• Default template remains google_style
• All existing functionality preserved
• Configuration system already supports architecture template variants

🎯 Template Selection

Current Configuration

templates:
  architecture: "google_style"  # Options: google_style, enterprise, arc42

Template Characteristics

Template	Lines	Best For	Key Sections
Google Style	280+	Tech teams, startups	Goals/Non-Goals, Design, Technology Stack
Enterprise	350+	Large orgs, governance	Business Architecture, Risk Management, Compliance
Arc42	450+	Structured teams	12 standardized sections, Quality Requirements

📚 Documentation Updates

• Enhanced Template Customization Guide: Updated docs/development/template-customization.md with architecture template details
• Comprehensive Examples: Added configuration examples for all three variants
• Template Structure Documentation: Detailed explanations of each template's purpose and sections

🎨 Template Highlights

Google Style Template

• Goals and Non-Goals: Clear scope definition
• System Context: Business and technical context
• Technology Stack: Detailed tech decisions with rationale
• Security Considerations: Authentication, authorization, data protection
• Performance and Scalability: Requirements and strategies
• Alternative Designs: Considered options and decisions

Enterprise Template

• Executive Summary: Business value proposition
• Business Architecture: Processes, stakeholders, objectives
• Application Portfolio: Inventory and integration patterns
• Data Architecture: Strategy, governance, compliance
• Technology Standards: Approved technologies and roadmap
• Risk Management: Architecture risks and mitigation
• Implementation Strategy: Phased roadmap with resource requirements

Arc42 Template

• 12 Standardized Sections: Complete Arc42 methodology
• Quality Requirements: Quality tree and scenarios
• Building Block View: Static decomposition with multiple levels
• Runtime View: Dynamic behavior scenarios
• Deployment View: Infrastructure and deployment
• Cross-cutting Concepts: Domain model, patterns, security
• Design Decisions: Important architectural decisions
• Risks and Technical Debts: Identified risks with mitigation

🧪 Testing

Manual Validation

• ✅ All three templates are properly formatted
• ✅ Placeholder system is consistent across templates
• ✅ Markdown rendering verified
• ✅ Template selection logic tested

Template Coverage

• ✅ Google Style: Comprehensive technical documentation
• ✅ Enterprise: Business and technical alignment
• ✅ Arc42: Complete methodology implementation

📖 Usage Examples

Quick Configuration

# .cursor-init.yaml
templates:
  architecture: "enterprise"  # For large organizations

Advanced Usage

templates:
  architecture: "arc42"  # For structured methodology

custom_template_paths:
  - name: "microservices_arch"
    path: ".cursor/templates/custom/microservices-architecture.md"

Command Usage

# All use configured architecture template variant
/init-docs
/update-docs
/sync-docs

🎯 Benefits

1. Professional Standards: Templates follow established industry methodologies
2. Flexibility: Choose complexity level that fits team needs
3. Comprehensive Coverage: From technical details to business alignment
4. Consistent Structure: Standardized placeholders across all variants
5. Documentation Quality: Guidance and examples for each section

📝 Files Changed

Modified Files

• .cursor/templates/architecture/architecture_google.md - Enhanced from basic template
• .cursor/templates/architecture/architecture_enterprise.md - Created comprehensive enterprise template
• .cursor/templates/architecture/architecture_arc.md - Created complete Arc42 template
• docs/development/template-customization.md - Added architecture template documentation

🚀 Next Steps

This PR establishes comprehensive architecture documentation foundation for:

• Framework-specific architecture templates
• Custom template inheritance
• Template validation and quality checks
• Integration with /gen-arch-diagram command

🔗 Related

• Builds on: Enhanced ADR templates (feat: enhance ADR templates with multiple variants and configuration support #13)
• Addresses: Empty architecture template issue
• Enhances: Architecture documentation workflow
• Enables: Professional documentation standards

---

Ready for Review ✅

• All templates comprehensively implemented
• Documentation updated and enhanced
• Industry standards followed
• Consistent placeholder system
• Backward compatibility maintained

[Copilot]

Pull Request Overview

This PR introduces three enhanced architecture documentation templates to support different industry standards and improves the corresponding documentation.

• Added a revamped Google Style Template with complete sections and standardized placeholders.
• Created a new Enterprise Template that incorporates comprehensive business and technical documentation based on enterprise architectural standards.
• Updated the template customization documentation to include details on selecting between Google Style, Enterprise, and Arc42 variants.

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
docs/development/template-customization.md	Expanded documentation to detail the three new architecture template variants and updated file structure listing.
.cursor/templates/architecture/architecture_google.md	Enhanced Google Style template with comprehensive architecture sections.
.cursor/templates/architecture/architecture_enterprise.md	Introduced a complete Enterprise template following TOGAF and enterprise best practices.

Comments suppressed due to low confidence (1)

.cursor/templates/architecture/architecture_enterprise.md:91

• [nitpick] The nested bullet list under Service Inventory (lines 91-93) uses an additional indentation level for SLA and Dependencies. For improved readability and consistency, consider aligning the bullet style and indentation for these nested details.

- **{{SERVICE_1_NAME}}**: {{SERVICE_1_DESCRIPTION}}

[mgiovani]

🔄 Consolidated into PR #17

This PR has been consolidated into the comprehensive template improvements PR #17 which includes:

• ✅ Enhanced architecture templates (this PR)
• ✅ RFC templates
• ✅ Onboarding templates + data model templates
• ✅ All slash commands respecting template configuration

Please review and merge PR #17 instead of this individual PR.

Link to comprehensive PR: #17