Beads Development Workflow

A strict plan → build process using beads (bd CLI) for task management and multi-agent execution.

Prerequisites

• bd CLI installed and available on $PATH
• Git repository initialised with a base branch (e.g. main)

Two Phases

Phase 1: Planning (no beads, no task tracking)

Freeform dialogue to thoroughly understand the problem before committing to execution.

• Explore: read relevant code, ask questions, gather requirements
• Experiment: write throwaway proof-of-concepts, run commands, add small tests to validate assumptions
• Dispose: all exploratory artefacts are removed once they've served their purpose — nothing from this phase is kept in the codebase
• Document: produce a final plan as a simple markdown file (default Plan.md in the project root, unless the repo uses a different planning-doc convention)