skills.rest
jbabin91
jbabin91COMMUNITY
Explore all skills by this author →
GitHub

beads-workflow

Convert markdown plans into granular beads with explicit dependencies.

5|Updated Oct 27, 2025
Search Tags:#automation#workflow#planning#beads#execution#team#tests
One-click install
npx skills add https://github.com/jbabin91/autocomplete-rs --skill beads-workflow-jbabin91
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: beads-workflow
Source: https://github.com/jbabin91/autocomplete-rs/tree/main/.agents/skills/beads-workflow
Command: npx skills add https://github.com/jbabin91/autocomplete-rs --skill beads-workflow-jbabin91

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Beads Workflow converts markdown plans into granular beads with dependency structure, bridging planning and execution for AI coding agents. It ensures plans are transformed into self-contained tasks that can be implemented, tested, and polled for progress without losing context.

Core Features & Use Cases

  • Plan to beads: Convert a markdown plan into a set of granular beads with dependencies and rich descriptions.
  • Polish beads: Iteratively refine bead quality across rounds, including cross-model reviews and test-coverage beads.
  • Fresh session: Break polishing plateaus by resetting context and re-evaluating bead structure.
  • Agent teamwork: Coordinate parallel bead execution via Claude Code agent teams and robot-mode planning.
  • Tests & coverage: Attach unit tests and e2e tests beads to feature beads.
  • BD/BV workflow: Use bd and bv commands for creation, updates, dependencies, and automated validation.
  • References: Leverage guidance from planning and polishing references to ensure consistency.

Quick Start

Install the bead workflow toolchain and run the plan-to-beads pipeline using the bd tool to convert a markdown plan into executable beads.

Frequently Asked Questions about beads-workflow

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

FAQPage Schema
How do I convert a markdown plan into executable tasks with dependencies?▼

To convert a markdown plan into executable tasks, this workflow transforms the plan into granular beads with explicit dependencies. Each bead becomes a self-contained task that can be implemented, tested, and polled for progress without losing context.

What is a bead pipeline for automated execution in AI coding agents?▼

A bead pipeline breaks down plans into granular, self-contained tasks called beads. The pipeline covers creation, updating, dependency linking, testing, and team-based deployment, bridging the gap between planning and execution for AI coding agents.

How do I attach unit tests and e2e tests to automated workflow tasks?▼

You can attach unit tests and e2e tests to feature beads during the conversion process. The workflow supports test-coverage bead creation, allowing you to link validation steps directly to your executable tasks.

Can I coordinate parallel execution across AI agent teams?▼

Yes, you can coordinate parallel bead execution using Claude Code agent teams. The workflow supports robot-mode planning and cross-model reviews to manage and execute beads simultaneously across teams.

What's the best way to refine and polish task plans that have plateaued?▼

To refine task plans that have plateaued, use the fresh-session feature to reset context and re-evaluate bead structure. You can also iteratively refine bead quality across rounds using cross-model reviews.

Do I need specific directory structures to use the bd and bv workflow commands?▼

Yes, the workflow enforces a SKILL.md frontmatter with a name and description. It also supports optional scripts, references, and assets directories to ensure the bd and bv commands function correctly during creation and validation.

Related Skills

Explore More Software Engineering Skills→
mayurpisemayurpise
39

draft

Initialize project contexts and create feature tracks with specs and plans.

Community
Advanced
DicklesworthstoneDicklesworthstone
70

agent-swarm-workflow

Coordinate parallel software tasks across multiple agents using Agent Mail and BV prompts.

Community
Advanced
quangdang46quangdang46

flywheel-planner

Plan multi-model software project architectures before coding.

Community
Advanced
o9nno9nn

paperclip-converting-plans-to-tasks

Convert abstract project plans into dependency-structured task issues.

Official
Intermediate