bmad-planner

What problem does it solve?

This Skill addresses the challenge of creating comprehensive, consistent, and well-structured planning documents (requirements, architecture, epics) before development begins. It eliminates manual document creation, ensures alignment, and saves significant time and AI tokens by providing a structured Q&A process.

Core Features & Use Cases

• Three-Persona Interactive Q&A: Guides you through requirements gathering (Analyst), architecture design (Architect), and epic breakdown (PM) with targeted questions, ensuring all critical aspects are covered.
• Automated Document Generation: Creates requirements.md, architecture.md, and epics.md from rich templates, pre-populating them with your interactive responses.
• Workflow Integration: Seamlessly integrates with the overall development workflow, providing essential context for subsequent specification and implementation phases, saving up to 92% in AI token usage compared to manual planning.
• Use Case: Before starting a new feature, run this tool to interactively define the problem, target users, technical stack, API design, and break down the work into prioritized epics, all committed directly to your contrib branch.

Quick Start

Example: Create planning documents for a new feature

(Run from your main repository on a contrib branch)

python .claude/skills/bmad-planner/scripts/create_planning.py
my-feature stharrold