Initial commit

commands/bmad-architecture.md

@@ -0,0 +1,126 @@
+---
+description: Generate BMAD architecture document from PRD
+---
+
+# 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:
+
+```bash
+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!**