bmad-parallel

Detect parallelizable BMAD story tasks and spawn agents with isolated worktrees.

Updated Jan 14, 2026
One-click install
npx skills add https://github.com/kingpinzs/claude_parallel_templates --skill bmad-parallel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-parallel
Source: https://github.com/kingpinzs/claude_parallel_templates/tree/main/bmad/.claude/skills/bmad-parallel
Command: npx skills add https://github.com/kingpinzs/claude_parallel_templates --skill bmad-parallel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This BMAD parallelization skill automatically detects parallelizable tasks within a BMAD story and spawns agents to execute them, reducing manual coordination and accelerating iteration.

Core Features & Use Cases

  • Automatic Task Detection: Scans BMAD stories for parallelizable tasks and proposes concurrent execution.
  • Isolated Worktrees: Creates per-task worktrees/branches to ensure task isolation and clean merges.
  • Agent Orchestration: Spawns Claude-based agents to work on tasks in parallel and aggregates progress.
  • Use Case: When a BMAD story contains multiple independent tasks, this skill launches separate agents to handle each task concurrently, then merges results back into the main branch.

Quick Start

In a BMAD-enabled project, run the BMAD parallel setup to automatically detect parallelizable story tasks and spawn agents for each task.

Frequently Asked Questions about bmad-parallel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parallelize BMAD story tasks across multiple agents?

Parallelizing BMAD story tasks involves automatically detecting independent tasks and spawning dedicated agents for each. The process creates isolated worktrees and branches to execute tasks concurrently, then merges results back into the main branch.

What is the mechanism for isolated worktree creation in concurrent agent execution?

Isolated worktree creation in concurrent agent execution works by assigning each parallelizable task its own worktree and branch. This guarantees task isolation and clean merges while agents execute concurrently.

Does BMAD parallel execution require any specific dependencies or components?

BMAD parallel execution requires no specific dependencies or components. It operates within a BMAD-enabled project, automatically detecting parallelizable story tasks and spawning agents without external dependencies.

Can I use automated agent orchestration for stories with dependent tasks?

Automated agent orchestration is designed for stories with multiple independent tasks. It spawns separate agents to handle each task concurrently, so dependent tasks requiring sequential execution are not suitable for this parallel approach.

Why does a parallelized BMAD story task fail to merge cleanly?

Clean merge failures in parallelized BMAD story tasks can occur if task isolation is compromised. The skill manages per-task logs and branches to ensure transactional consistency and TASK_COMPLETE signaling, preventing merge conflicts.

What's the best way to manage per-task logs and branches during parallel story execution?

The best way to manage per-task logs and branches during parallel story execution is through the skill's built-in orchestration. It automatically handles per-task logging and branch management, ensuring transactional consistency during merges.