BMAD Architecture - Generate Technical Architecture

Use the architect subagent to create comprehensive technical architecture for this project following BMAD methodology.

Task Delegation

First check if the PRD exists, then launch the architect subagent to handle the complete architecture generation workflow.

Process

Step 1: Verify Prerequisites

Check that PRD exists before delegating to architect:

ls bmad-backlog/prd/prd.md 2>/dev/null || echo "PRD not found"

If PRD NOT found:

❌ Error: PRD not found at bmad-backlog/prd/prd.md

Architecture generation requires a PRD to work from.

Please run: /titanium-toolkit:bmad-prd first
(Or /titanium-toolkit:bmad-start for complete guided workflow)

Stop here - do not launch architect without PRD.

If PRD exists: Continue to Step 2.

Step 2: Launch Architect Subagent

Use the Task tool to launch the architect subagent in its own context window:

Task(
  description: "Generate BMAD architecture",
  prompt: "Create comprehensive technical architecture document following BMAD methodology.

Input:
- PRD: bmad-backlog/prd/prd.md
- Research findings: bmad-backlog/research/*.md (if any exist)

Output:
- Architecture document: bmad-backlog/architecture/architecture.md

Requirements:
1. Read the PRD to understand requirements
2. Check for research findings and incorporate recommendations
3. Generate architecture using bmad_generator MCP tool
4. Review tech stack with user and get approval
5. Validate architecture using bmad_validator MCP tool
6. Run vibe-check to validate architectural decisions
7. Store result in Pieces for future reference
8. Present summary with next steps

**IMPORTANT**: Keep your summary response BRIEF (under 500 tokens). Just return:
- Confirmation architecture is complete
- Proposed tech stack (2-3 sentences)
- MVP cost estimate
- Any critical decisions made

DO NOT include the full architecture content in your response - it's already saved to the file.

Follow your complete architecture workflow from the bmad-methodology skill.

Project path: $(pwd)",
  subagent_type: "architect"
)

The architect subagent will handle:

• Reading PRD and research findings
• Generating architecture document (1000-1500 lines)
• Tech stack selection and user approval
• Validation (structural and vibe-check)
• Pieces storage
• Summary presentation

Step 3: Return Results

The architect will return a summary when complete. Present this to the user.

What the Architect Creates

The architect subagent generates bmad-backlog/architecture/architecture.md containing:

• System Overview: High-level architecture diagram (ASCII), component descriptions
• Technology Stack: Complete stack with rationale for each choice
• Component Details: Detailed design for each system component
• Database Design: Complete SQL schemas with CREATE TABLE statements
• API Design: Endpoint specifications with request/response examples
• Security Architecture: Auth, rate limiting, encryption, security controls
• Infrastructure: Deployment strategy, scaling plan, CI/CD pipeline
• Monitoring: Metrics, logging, tracing, alerting specifications
• Cost Analysis: MVP costs and production projections
• Technology Decisions Table: Each tech choice with rationale

Integration with Research

If research findings exist in bmad-backlog/research/, the architect will:

• Read all RESEARCH-*-findings.md files
• Extract vendor/technology recommendations
• Incorporate into architecture decisions
• Reference research in Technology Decisions table
• Use research pricing in cost estimates

Voice Feedback

Voice hooks announce:

• "Generating architecture" (when starting)
• "Architecture complete" (when finished)

Cost

Typical cost: ~$0.08 per architecture generation (Claude Sonnet 4.5 API usage in bmad_generator tool)

---

This command delegates to the architect subagent who creates the complete technical blueprint!