bead-driven-development

Coordinate cross-session planning and execution with beads and reviews.

3|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/peabody124/reproducible_agent_environment --skill bead-driven-development
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bead-driven-development
Source: https://github.com/peabody124/reproducible_agent_environment/tree/main/skills/bead-driven-development
Command: npx skills add https://github.com/peabody124/reproducible_agent_environment --skill bead-driven-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solves the coordination problem for planning and execution across cross-session contexts.

Core Features & Use Cases

  • Orchestrates planning and execution across major tasks with beads and reviews.
  • Cross-session tracking via beads to maintain context across sessions and tools.
  • Unified workspace workflow for planning, temporary scripts, and investigations.

Quick Start

To begin, enable beads and superpowers in your Claude Code environment, initialize the unified workspace with the bead-driven prompts, and follow the Phase-based workflow to create a plan, add beads, and execute tasks with code reviews and investigations.

Frequently Asked Questions about bead-driven-development

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

FAQPage Schema
How do I maintain task context and planning state across different coding sessions?▼

Cross-session tracking uses beads to maintain context across sessions and tools. Bead-driven development coordinates planning and execution by creating a unified scratch workspace that persists task status and syncing via bd commands.

What's the best way to orchestrate structured planning with integrated code reviews in Claude Code?▼

Orchestrating planning with code reviews requires a phase-based workflow using beads and superpowers plugins. The workflow creates a unified workspace for planning, adds beads for task tracking, and executes tasks with integrated code reviews and investigations.

Do I need specific plugins to enable bead-driven workflows for task execution?▼

Bead-driven workflows require the beads and superpowers plugins in your Claude Code environment. You must enable both plugins and initialize the unified workspace with the bead-driven prompts before following the phase-based execution workflow.

Can I use a unified scratch workspace for temporary scripts and code investigations?▼

A unified scratch workspace supports planning, temporary scripts, and investigations. The bead-driven workflow creates this workspace to coordinate major tasks, track execution status, and manage code reviews across cross-session contexts.

Why does cross-session coordination fail when managing complex development tasks?▼

Cross-session coordination fails without structured task tracking to maintain context across sessions and tools. Bead-driven development solves this by applying beads to coordinate planning, execution status, and syncing via bd commands.