beads-workflow

What problem does it solve?

Beads workflow provides a structured method to convert large markdown planning documents into granular, self-contained beads (tasks with explicit dependencies) that AI agents can execute reliably. It bridges planning and implementation, enabling scalable multi-agent collaboration.

Core Features & Use Cases

• Self-contained beads: Each bead includes background, rationale, and implementation details to reduce context switching.
• Dependency-aware planning: Beads explicitly declare blockers and relationships to manage orchestration.
• Beads Viewer integration: Leverage BV for prioritization, triage, and planning insights.
• Plan-to-beads conversion: Precise prompts and tooling to transform markdown plans into executable beads.
• Polish and testing: Built-in prompts for polishing beads and verification workflows.

Quick Start

To begin, provide your markdown plan to the beads workflow using the prompts described in SKILL.md, then use the bd CLI to create beads, declare dependencies, and start polishing rounds.