claude-code-bmad-skills

https://github.com/aj-geddes/claude-code-bmad-skills

"Please install BMAD Method v6 from this repository"

~/.claude/
├── skills/bmad/                    # BMAD skills
│   ├── core/
│   │   └── bmad-master/SKILL.md    # Core orchestrator (2.8KB)
│   ├── bmm/                        # Main Method Module
│   │   ├── analyst/SKILL.md        # Business Analyst (4.5KB)
│   │   ├── pm/SKILL.md             # Product Manager (4.8KB)
│   │   ├── architect/SKILL.md      # System Architect (4.6KB)
│   │   ├── scrum-master/SKILL.md   # Scrum Master (5.1KB)
│   │   ├── developer/SKILL.md      # Developer (5.0KB)
│   │   └── ux-designer/SKILL.md    # UX Designer (6.8KB)
│   ├── bmb/                        # Builder Module
│   │   └── builder/SKILL.md        # Builder (7.1KB)
│   └── cis/                        # Creative Intelligence System
│       └── creative-intelligence/SKILL.md  # Creative Intelligence (5.2KB)
│
└── config/bmad/                    # BMAD configuration
    ├── config.yaml                 # Global config
    ├── helpers.md                  # Reusable utility sections (7.3KB)
    ├── templates/                  # Document templates
    │   ├── product-brief.md
    │   ├── tech-spec.md
    │   ├── prd.md
    │   └── architecture.md
    └── agents/                     # Agent status files (created per project)

/create-agent

> What role should this agent perform?
"QA Engineer"

> What are the 3-7 key responsibilities?
- Create comprehensive test plans
- Execute automated test suites
- Report bugs with reproduction steps
- Analyze test coverage
- Validate acceptance criteria

> What workflows will this agent execute?
- /create-test-plan
- /execute-tests
- /bug-report
- /test-coverage

[Builder generates SKILL.md following BMAD patterns]

✓ QA Engineer skill created!
File: ./custom-agents/qa-engineer/SKILL.md

Installation: Copy to ~/.claude/skills/bmad/bmb/qa-engineer/

/create-workflow

> What does this workflow achieve?
"Deploy application to production"

> What are the 3-10 steps?
1. Run pre-deployment checks
2. Build production artifacts
3. Run database migrations
4. Deploy to staging
5. Run smoke tests
6. Deploy to production
7. Verify deployment
8. Update documentation

[Builder generates command .md file]

✓ Workflow created!
Command: /deploy
File: ./custom-workflows/deploy.md

User: "I want to build a task management SaaS application"

Claude Code:
  [Detects: New project, likely Level 2-3 complexity]

> This looks like a substantial project (SaaS platform).
>
> I recommend using the BMAD Method for structured development.
>
> Initialize BMAD? Run: /workflow-init

User: /workflow-init

Claude Code:
  [Creates directory structure]
  [Creates project config]
  [Detects no existing requirements]

> ✓ BMAD initialized!
>
> Project Level: Not yet determined
> Next: Create product brief (/product-brief)

User: /product-brief

Claude Code (Business Analyst role):
  [Interactive product brief creation]
  [Market analysis, user personas, core features]

> ✓ Product brief created!
>
> Core Features: Task management, team collaboration, time tracking
> Target Users: Small teams (5-20 people)
> Recommended Level: 2 (Medium complexity, 5-15 stories)
>
> Next: Create PRD (/prd)

User: /prd

Claude Code (Product Manager role):
  [Reads product brief]
  [Interactive PRD creation]
  [24 functional requirements, 8 NFRs defined]

> ✓ PRD created: bmad-outputs/prd.md
>
> Summary:
> - 24 Functional Requirements
> - 8 Non-Functional Requirements
> - 4 Epics defined
>
> Next: Create architecture (/architecture)

User: /architecture

Claude Code (System Architect role):
  [Reads PRD automatically]
  [Designs system to meet all requirements]
  [Justifies each technology choice against NFRs]

> ✓ Architecture created: bmad-outputs/architecture.md
>
> Tech Stack:
> - Backend: Python + FastAPI (NFR-001: Performance)
> - Frontend: React + TypeScript (NFR-003: Maintainability)
> - Database: PostgreSQL (NFR-002: Data integrity)
> - Cache: Redis (NFR-001: Performance)
>
> Coverage:
> - Functional Requirements: 100% (24/24)
> - Non-Functional Requirements: 100% (8/8)
>
> Next: Validate with gate check (/solutioning-gate-check)

User: /solutioning-gate-check

Claude Code (System Architect role):
  [Validates architecture automatically]
  [Checks coverage, quality, completeness]

> ✓ Gate Check Passed! Score: 96/100
>
> ✓ FR Coverage: 100% (24/24 requirements addressed)
> ✓ NFR Coverage: 100% (8/8 requirements met)
> ✓ Quality Checks: 23/25 passed
>
> Ready for implementation!
>
> Next: Plan sprint (/sprint-planning)

User: /sprint-planning

Claude Code (Scrum Master role):
  [Reads PRD + Architecture]
  [Interactive sprint planning]
  [Creates sprint backlog]

> ✓ Sprint 1 planned!
>
> Sprint Goal: Core task management MVP
> Stories: 8 stories (21 points)
> Duration: 2 weeks
>
> Top Priority Stories:
> 1. User authentication (5 points)
> 2. Create/edit tasks (3 points)
> 3. Task lists (3 points)
>
> Ready to create stories? (/create-story)

User: Create story for user authentication

Claude Code (Scrum Master role):
  [References FR-015 from PRD]
  [References Authentication section from Architecture]
  [Creates hyper-detailed story]

> ✓ Story created: bmad-outputs/stories/sprint-1/story-001-user-auth.md
>
> Story: User Authentication (Epic 1)
> Points: 5
> Dependencies: None
> Requirements: FR-015, NFR-004 (Security)
>
> Ready to implement? (/dev-story)

User: /dev-story

Claude Code (Developer role):
  [Reads story file automatically]
  [Implements code following architecture patterns]
  [Writes tests]
  [Updates story file with implementation notes]

> ✓ Story-001 implemented!
>
> Files created:
> - src/api/auth.py (JWT authentication)
> - src/models/user.py (User model)
> - tests/test_auth.py (15 test cases)
>
> Tests: 15/15 passing ✓
> Coverage: 94%
>
> Story file updated with implementation notes.
>
> Next story? Or run tests? (/execute-tests if QA Engineer installed)

User: /brainstorm

Creative Intelligence:
> I'll facilitate a structured brainstorming session.
>
> What are we brainstorming?
"Feature ideas for task management app"

> What's the context?
"MVP launched, need ideas for v2.0"

> I'll use 3 complementary techniques:
> 1. SCAMPER - Generate creative variations
> 2. Mind Mapping - Organize ideas
> 3. SWOT - Strategic assessment

[Executes brainstorming workflow]

> ✓ Brainstorming Complete!
>
> Generated:
> - 32 feature ideas across 6 categories
> - 5 key insights
>
> Top Insights:
> 1. AI-powered task suggestions (SCAMPER: Adapt)
> 2. Team analytics dashboard (Mind Map: Reporting branch)
> 3. Mobile-first redesign (SWOT: Opportunity)
>
> Document: bmad-outputs/brainstorming-v2-features-2025-11-01.md
>
> Next: Research competitor features? (/research)

User: /research

Creative Intelligence:
> What are we researching?
"Competitor task management features"

> What type of research?
"Competitive Research"

> Specific questions:
1. What features do competitors have that we don't?
2. What are their pricing models?
3. What do users complain about?

[Executes research using WebSearch and WebFetch]

> ✓ Research Complete!
>
> Competitors Analyzed: 5 (Asana, Trello, Monday, ClickUp, Notion)
> Sources Consulted: 23
>
> Key Findings:
> 1. All competitors offer mobile apps (we don't)
> 2. AI features becoming standard (task automation, smart suggestions)
> 3. Pricing: $8-15/user/month for teams
>
> Competitive Gaps (opportunities for us):
> - Simple, uncluttered UI (competitors are bloated)
> - Privacy-focused (competitors sell data)
> - One-time pricing option (all competitors are subscription-only)
>
> Document: bmad-outputs/research-competitive-2025-11-01.md
>
> Next: Update PRD with insights? (/prd)

User: /create-ux-design

UX Designer:
> I'll create comprehensive UX design.
>
> [Loads PRD automatically]
> Found 24 user stories to design for.

> Target platforms?
[✓] Web (desktop)
[✓] Web (mobile)
[ ] iOS native
[ ] Android native

> Design level?
2. Detailed (full wireframes with interactions)

> Accessibility?
2. WCAG 2.1 Level AA (recommended)

[Executes UX design workflow]

> ✓ UX Design Complete!
>
> Screens Designed: 12
> User Flows: 5
> Components: 28
> Accessibility: WCAG 2.1 AA compliant
>
> User Flows:
> 1. User Authentication (signup → login → forgot password)
> 2. Task Management (create → edit → complete → delete)
> 3. Team Collaboration (invite → assign → comment)
> 4. Dashboard (overview → filters → analytics)
> 5. Settings (profile → preferences → billing)
>
> Design Tokens Defined:
> - Colors (primary, semantic, neutral)
> - Typography (6 levels)
> - Spacing (8px base scale)
> - Components (button, card, form, modal)
>
> Accessibility Features:
> ✓ Color contrast: 4.5:1 minimum
> ✓ Keyboard navigation
> ✓ Screen reader compatible
> ✓ Touch targets: 44px minimum
> ✓ Responsive (mobile-first)
>
> Document: bmad-outputs/ux-design-task-management-2025-11-01.md
>
> Next: Review with PM, then hand off to Architecture

/workflow-init

/workflow-status

/workflow-init