Techcle Wiki

BMAD QUICK START

2 min read

BMAD Quick Start Guide

OpenCode Slash Commands

Main Development Agents

/architect          # Winston - Technical Architecture
/dev                # Amelia - Implementation
/pm                 # John - Product Management
/sm                 # Bob - Scrum Master / Sprint Planning
/ux-designer        # Sally - UX Design
/quinn              # Quinn - QA Engineering
/analyst            # Mary - Business Analysis
/tech-writer        # Technical Documentation

Quick Flow (Fast Iteration)

/quick-flow-solo-dev    # Barry - Solo dev for simple tasks
/quick-dev              # Fast implementation (with or without spec)
/quick-spec             # Fast specification creation

Specialized Agents

/tea                        # Murat - Test Architecture
/innovation-strategist      # Innovation & Strategy
/creative-problem-solver    # Creative Problem Solving
/storyteller                # Narrative & Communication
/brainstorming-coach        # Brainstorming Facilitation
/design-thinking-coach      # Design Thinking

Common Workflows

/party-mode                     # Multi-agent collaboration
/create-architecture            # Architecture workflow
/create-prd                     # PRD creation workflow
/create-epics-and-stories       # Break down PRD into stories
/dev-story                      # Implement a story
/sprint-planning                # Sprint planning
/check-implementation-readiness # Validate before implementation
/code-review                    # Adversarial code review

Typical Workflow

1. Create Project

task projects:create NAME=my-feature FORMAT=bmad CATEGORY=infrastructure

2. Architecture Phase

/architect

Tell Winston:

Create architecture for .ai/projects/infrastructure/my-feature/

Winston creates:

  • architecture.md
  • Updates metadata.json → bmadPhase: "3-solutioning"

3. Story Creation (Optional - PM can help)

/pm

Tell John:

Create epics and stories for .ai/projects/infrastructure/my-feature/

John creates:

  • epics-stories.md
  • stories/story-e1-s1.md, etc.

4. Implementation

/dev

Tell Amelia:

Implement story at .ai/projects/infrastructure/my-feature/stories/story-e1-s1.md

Amelia:

  • Reads story file
  • Implements tasks in order
  • Writes tests
  • Updates story file with completion status

Key Locations

  • Projects: .ai/projects/{category}/{project-name}/
  • BMAD Installation: _bmad/
  • Agent Instructions: _bmad/AGENT-GUIDE.md
  • Workflows: _bmad/bmm/workflows/

Project Phases

  1. Analysis - brief.md, research
  2. Planning - prd.md, ux-design.md
  3. Solutioning - architecture.md, epics-stories.md
  4. Implementation - stories/, sprint-status.yaml

Tips

  • Agent Names: Use short commands like /architect, /dev, not /bmad-agent-bmm-architect
  • Fresh Context: Start new conversation for each agent to avoid token bloat
  • Direct File Access: Agents work directly in .ai/projects/ - no symlinks needed
  • Story Files: The contract between planning and implementation
  • Hybrid Mode: Mix BMAD with existing Kiro/Codev projects

Graph View