How does this skill improve token efficiency?

By running an interactive Python script to handle the Q&A and file generation, it avoids having Claude Code manually process and output large templates, saving approximately 2,300 tokens per feature.

Can I use this on any branch?

The tool is designed to be used on the main repository while on a contribution branch (e.g., contrib/username) during the initial planning phase of a feature.

What is the BMAD framework?

BMAD stands for Business Model, Architecture, and Design. It is a structured framework used to ensure all business and technical aspects of a feature are planned before development starts.

What documents does the bmad-planner generate?

It generates a comprehensive directory containing requirements.md (business context), architecture.md (technical design), epics.md (work breakdown), and support files like CLAUDE.md and README.md.

BMAD Planning Assistant

Name: BMAD Planning Assistant
Author: stharrold

bystharrold

Productivity & Workflow

Facilitates interactive requirements gathering and architectural design through a three-persona Q&A system to generate standardized project documentation.

About

The BMAD Planner is a comprehensive planning skill for Claude Code designed to automate the creation of Business Model, Architecture, and Design (BMAD) documentation. By utilizing an interactive Python-based tool, it guides users through a structured Q&A process led by specialized Analyst, Architect, and Project Manager personas. This workflow ensures that all technical requirements, system architectures, and epic breakdowns are defined before development begins, significantly reducing token consumption by up to 92% compared to manual context reproduction and ensuring project consistency.

Key Features

Interactive three-persona Q&A (Analyst, Architect, and Project Manager)
Automated generation of requirements.md, architecture.md, and epics.md
0 GitHub stars
High token efficiency saving ~2,300 tokens per feature session
Pre-configured templates for standardized technical documentation
Integrated Git workflow for committing planning docs to contrib branches

Use Cases

Generating comprehensive Product Requirements Documents (PRD) and technical designs before coding.
Breaking down complex features into prioritized epics with clear dependency mapping.
Standardizing the planning phase across development teams using Claude Code.

About

Key Features

Interactive three-persona Q&A (Analyst, Architect, and Project Manager)
Automated generation of requirements.md, architecture.md, and epics.md
0 GitHub stars
High token efficiency saving ~2,300 tokens per feature session
Pre-configured templates for standardized technical documentation
Integrated Git workflow for committing planning docs to contrib branches

Use Cases

Generating comprehensive Product Requirements Documents (PRD) and technical designs before coding.
Breaking down complex features into prioritized epics with clear dependency mapping.
Standardizing the planning phase across development teams using Claude Code.