BMAD Initialization

BMAD Initialization

Goal: Set up BMAD Method structure in the current project.

Initialization Steps

1. Create directory structure:

   bmad/
   ├── config.yaml          # Project configuration
   └── agent-overrides/     # Optional agent customizations
   
   planning-artifacts/
   ├── workflow-status.yaml # Workflow progress tracking
   └── (generated docs)
   
   implementation-artifacts/
   └── stories/             # Story files during implementation
   

2. Collect project information:

   • Project name
   • Project type (web-app, mobile-app, api, library, game, other)
   • Project level:
     • Level 0: Single atomic change (1 story)
     • Level 1: Small feature (1-10 stories)
     • Level 2: Medium feature set (5-15 stories)
     • Level 3: Complex integration (12-40 stories)
     • Level 4: Enterprise expansion (40+ stories)

3. Create project config (bmad/config.yaml):

   project_name: { collected }
   project_type: { collected }
   project_level: { collected }
   user_name: { from system or ask }
   user_skill_level: intermediate
   communication_language: English
   document_output_language: English
   planning_artifacts: ./planning-artifacts
   implementation_artifacts: ./implementation-artifacts
   project_knowledge: ./docs
   

4. Create workflow status (planning-artifacts/workflow-status.yaml):

   project: { project_name }
   level: { project_level }
   last_updated: { timestamp }
   
   phases:
     analysis:
       product-brief: not-started
       research: not-started
     planning:
       prd: { required if level >= 2, else optional }
       tech-spec: { required if level <= 1, else optional }
       ux-design: optional
     solutioning:
       architecture: { required if level >= 2, else optional }
       epics-stories: not-started
     implementation:
       sprint-planning: not-started
       current-sprint: null
   

5. Confirm initialization:

   ✓ BMAD Method initialized!
   
   Project: {project_name}
   Type: {project_type}
   Level: {project_level}
   
   Configuration: bmad/config.yaml
   Status tracking: planning-artifacts/workflow-status.yaml
   
   Recommended next step: {based on level}
   

6. Recommend next workflow based on project level:

   • Level 0-1: /bmad:product-brief or /bmad:quick-spec
   • Level 2+: /bmad:product-brief → /bmad:create-prd

Usage

/bmad:init

The command will interactively guide you through project setup.