@jungjaehoon/mama-os 0.9.2 → 0.9.4

package/templates/bmad/architecture.md

@@ -0,0 +1,343 @@
+# System Architecture: {{project_name}}
+
+**Date:** {{date}}
+**Architect:** {{user_name}}
+**Version:** 1.0
+**Project Type:** {{project_type}}
+**Project Level:** {{project_level}}
+**Status:** Draft
+
+---
+
+## Document Overview
+
+This document defines the system architecture for {{project_name}}. It provides the technical blueprint for implementation, addressing all functional and non-functional requirements from the PRD.
+
+**Related Documents:**
+
+- Product Requirements Document: {{prd_path}}
+- Product Brief: {{product_brief_path}}
+
+---
+
+## Executive Summary
+
+{{executive_summary}}
+
+---
+
+## Architectural Drivers
+
+These requirements heavily influence architectural decisions:
+
+{{architectural_drivers}}
+
+---
+
+## System Overview
+
+### High-Level Architecture
+
+{{high_level_architecture}}
+
+### Architecture Diagram
+
+{{architecture_diagram}}
+
+### Architectural Pattern
+
+**Pattern:** {{architectural_pattern}}
+
+**Rationale:** {{pattern_rationale}}
+
+---
+
+## Technology Stack
+
+### Frontend
+
+{{frontend_stack}}
+
+### Backend
+
+{{backend_stack}}
+
+### Database
+
+{{database_stack}}
+
+### Infrastructure
+
+{{infrastructure_stack}}
+
+### Third-Party Services
+
+{{third_party_services}}
+
+### Development & Deployment
+
+{{dev_deployment_stack}}
+
+---
+
+## System Components
+
+{{system_components}}
+
+---
+
+## Data Architecture
+
+### Data Model
+
+{{data_model}}
+
+### Database Design
+
+{{database_design}}
+
+### Data Flow
+
+{{data_flow}}
+
+---
+
+## API Design
+
+### API Architecture
+
+{{api_architecture}}
+
+### Endpoints
+
+{{api_endpoints}}
+
+### Authentication & Authorization
+
+{{api_auth}}
+
+---
+
+## Non-Functional Requirements Coverage
+
+### NFR-001: {{nfr_001_name}}
+
+**Requirement:** {{nfr_001_requirement}}
+
+**Architecture Solution:** {{nfr_001_solution}}
+
+---
+
+{{additional_nfrs}}
+
+---
+
+## Security Architecture
+
+### Authentication
+
+{{auth_design}}
+
+### Authorization
+
+{{authz_design}}
+
+### Data Encryption
+
+{{encryption_design}}
+
+### Security Best Practices
+
+{{security_practices}}
+
+---
+
+## Scalability & Performance
+
+### Scaling Strategy
+
+{{scaling_strategy}}
+
+### Performance Optimization
+
+{{performance_optimization}}
+
+### Caching Strategy
+
+{{caching_strategy}}
+
+### Load Balancing
+
+{{load_balancing}}
+
+---
+
+## Reliability & Availability
+
+### High Availability Design
+
+{{ha_design}}
+
+### Disaster Recovery
+
+{{dr_design}}
+
+### Backup Strategy
+
+{{backup_strategy}}
+
+### Monitoring & Alerting
+
+{{monitoring_alerting}}
+
+---
+
+## Integration Architecture
+
+### External Integrations
+
+{{external_integrations}}
+
+### Internal Integrations
+
+{{internal_integrations}}
+
+### Message/Event Architecture (if applicable)
+
+{{messaging_architecture}}
+
+---
+
+## Development Architecture
+
+### Code Organization
+
+{{code_organization}}
+
+### Module Structure
+
+{{module_structure}}
+
+### Testing Strategy
+
+{{testing_strategy}}
+
+### CI/CD Pipeline
+
+{{cicd_pipeline}}
+
+---
+
+## Deployment Architecture
+
+### Environments
+
+{{environments}}
+
+### Deployment Strategy
+
+{{deployment_strategy}}
+
+### Infrastructure as Code
+
+{{iac}}
+
+---
+
+## Requirements Traceability
+
+### Functional Requirements Coverage
+
+{{fr_traceability}}
+
+### Non-Functional Requirements Coverage
+
+{{nfr_traceability}}
+
+---
+
+## Trade-offs & Decision Log
+
+{{tradeoffs}}
+
+---
+
+## Open Issues & Risks
+
+{{open_issues}}
+
+---
+
+## Assumptions & Constraints
+
+{{assumptions}}
+
+---
+
+## Future Considerations
+
+{{future_considerations}}
+
+---
+
+## Approval & Sign-off
+
+**Review Status:**
+
+- [ ] Technical Lead
+- [ ] Product Owner
+- [ ] Security Architect (if applicable)
+- [ ] DevOps Lead
+
+---
+
+## Revision History
+
+| Version | Date     | Author        | Changes              |
+| ------- | -------- | ------------- | -------------------- |
+| 1.0     | {{date}} | {{user_name}} | Initial architecture |
+
+---
+
+## Next Steps
+
+### Phase 4: Sprint Planning & Implementation
+
+Run `/sprint-planning` to:
+
+- Break epics into detailed user stories
+- Estimate story complexity
+- Plan sprint iterations
+- Begin implementation following this architectural blueprint
+
+**Key Implementation Principles:**
+
+1. Follow component boundaries defined in this document
+2. Implement NFR solutions as specified
+3. Use technology stack as defined
+4. Follow API contracts exactly
+5. Adhere to security and performance guidelines
+
+---
+
+**This document was created using BMAD Method v6 - Phase 3 (Solutioning)**
+
+_To continue: Run `/workflow-status` to see your progress and next recommended workflow._
+
+---
+
+## Appendix A: Technology Evaluation Matrix
+
+{{tech_evaluation_matrix}}
+
+---
+
+## Appendix B: Capacity Planning
+
+{{capacity_planning}}
+
+---
+
+## Appendix C: Cost Estimation
+
+{{cost_estimation}}

package/templates/bmad/bmm-workflow-status.template.yaml

@@ -0,0 +1,66 @@
+# BMAD Method Workflow Status
+# Generated: {{TIMESTAMP}}
+# Project: {{PROJECT_NAME}}
+
+project_name: "{{PROJECT_NAME}}"
+project_type: "{{PROJECT_TYPE}}"
+project_level: "{{PROJECT_LEVEL}}"
+communication_language: "English"
+output_language: "English"
+last_updated: "{{TIMESTAMP}}"
+
+# Workflow Status Tracking
+# Status values:
+#   - "required" - Must be completed
+#   - "optional" - Can be skipped
+#   - "recommended" - Strongly suggested
+#   - "conditional" - Required based on project level
+#   - "{file-path}" - Completed (path to output file)
+#   - "skipped" - Explicitly skipped
+
+workflow_status:
+  # Phase 1: Analysis (Optional but recommended)
+  - name: product-brief
+    phase: 1
+    status: "optional"
+    description: "Create comprehensive product brief"
+
+  - name: brainstorm-project
+    phase: 1
+    status: "optional"
+    description: "Structured brainstorming session"
+
+  - name: research
+    phase: 1
+    status: "optional"
+    description: "Market and competitive research"
+
+  # Phase 2: Planning (Required - choose one based on project level)
+  - name: prd
+    phase: 2
+    status: "{{PRD_STATUS}}"  # required for level 2+, recommended for level 1
+    description: "Product Requirements Document"
+
+  - name: tech-spec
+    phase: 2
+    status: "{{TECH_SPEC_STATUS}}"  # required for level 0-1, optional for 2+
+    description: "Technical Specification"
+
+  - name: create-ux-design
+    phase: 2
+    status: "optional"
+    description: "UX/UI design workflow"
+
+  # Phase 3: Solutioning (Conditional on project level)
+  - name: architecture
+    phase: 3
+    status: "{{ARCHITECTURE_STATUS}}"  # required for level 2+
+    description: "System architecture design"
+
+  - name: solutioning-gate-check
+    phase: 3
+    status: "optional"
+    description: "Validate architecture against requirements"
+
+  # Phase 4: Implementation (Required)
+  # Note: Implementation tracked in sprint-status.yaml

package/templates/bmad/prd.md

@@ -0,0 +1,198 @@
+# Product Requirements Document: {{project_name}}
+
+**Date:** {{date}}
+**Author:** {{user_name}}
+**Version:** 1.0
+**Project Type:** {{project_type}}
+**Project Level:** {{project_level}}
+**Status:** Draft
+
+---
+
+## Document Overview
+
+This Product Requirements Document (PRD) defines the functional and non-functional requirements for {{project_name}}. It serves as the source of truth for what will be built and provides traceability from requirements through implementation.
+
+**Related Documents:**
+
+- Product Brief: {{product_brief_path}}
+
+---
+
+## Executive Summary
+
+{{executive_summary}}
+
+---
+
+## Product Goals
+
+### Business Objectives
+
+{{business_objectives}}
+
+### Success Metrics
+
+{{success_metrics}}
+
+---
+
+## Functional Requirements
+
+Functional Requirements (FRs) define **what** the system does - specific features and behaviors.
+
+Each requirement includes:
+
+- **ID**: Unique identifier (FR-001, FR-002, etc.)
+- **Priority**: Must Have / Should Have / Could Have / Won't Have (MoSCoW)
+- **Description**: What the system should do
+- **Acceptance Criteria**: How to verify it's complete
+
+---
+
+{{functional_requirements}}
+
+---
+
+## Non-Functional Requirements
+
+Non-Functional Requirements (NFRs) define **how** the system performs - quality attributes and constraints.
+
+---
+
+{{non_functional_requirements}}
+
+---
+
+## Epics
+
+Epics are logical groupings of related functionality that will be broken down into user stories during sprint planning (Phase 4).
+
+Each epic maps to multiple functional requirements and will generate 2-10 stories.
+
+---
+
+{{epics}}
+
+---
+
+## User Stories (High-Level)
+
+User stories follow the format: "As a [user type], I want [goal] so that [benefit]."
+
+These are preliminary stories. Detailed stories will be created in Phase 4 (Implementation).
+
+---
+
+{{user_stories}}
+
+---
+
+## User Personas
+
+{{user_personas}}
+
+---
+
+## User Flows
+
+{{user_flows}}
+
+---
+
+## Dependencies
+
+### Internal Dependencies
+
+{{internal_dependencies}}
+
+### External Dependencies
+
+{{external_dependencies}}
+
+---
+
+## Assumptions
+
+{{assumptions}}
+
+---
+
+## Out of Scope
+
+{{out_of_scope}}
+
+---
+
+## Open Questions
+
+{{open_questions}}
+
+---
+
+## Approval & Sign-off
+
+### Stakeholders
+
+{{stakeholders}}
+
+### Approval Status
+
+- [ ] Product Owner
+- [ ] Engineering Lead
+- [ ] Design Lead
+- [ ] QA Lead
+
+---
+
+## Revision History
+
+| Version | Date     | Author        | Changes     |
+| ------- | -------- | ------------- | ----------- |
+| 1.0     | {{date}} | {{user_name}} | Initial PRD |
+
+---
+
+## Next Steps
+
+### Phase 3: Architecture
+
+Run `/architecture` to create system architecture based on these requirements.
+
+The architecture will address:
+
+- All functional requirements (FRs)
+- All non-functional requirements (NFRs)
+- Technical stack decisions
+- Data models and APIs
+- System components
+
+### Phase 4: Sprint Planning
+
+After architecture is complete, run `/sprint-planning` to:
+
+- Break epics into detailed user stories
+- Estimate story complexity
+- Plan sprint iterations
+- Begin implementation
+
+---
+
+**This document was created using BMAD Method v6 - Phase 2 (Planning)**
+
+_To continue: Run `/workflow-status` to see your progress and next recommended workflow._
+
+---
+
+## Appendix A: Requirements Traceability Matrix
+
+| Epic ID | Epic Name | Functional Requirements | Story Count (Est.) |
+| ------- | --------- | ----------------------- | ------------------ |
+
+{{traceability_matrix}}
+
+---
+
+## Appendix B: Prioritization Details
+
+{{prioritization_details}}