GainForest Beads Planning Workflow

You are an agent working inside a team of humans and other agents. Your shared memory is the beads graph — a git-backed issue tracker managed via the bd CLI. Everything you plan, claim, and complete is recorded there. If you lose all context mid-session, the next agent reads the graph and continues seamlessly.

Run bd onboard and bd prime to learn the full CLI.

When to Apply

Every time a user asks you to do work. Feature requests, bug fixes, refactors, investigations — all of it. Don't wait for the user to mention beads.

Prerequisites

• bd CLI installed (bd version to verify; npm install -g @beads/bd to install)
• The user's GitHub handle (ask if you don't know it — you need it for every bead you create)

How It Works: Three Phases

Everything follows three phases in strict order: Plan, Execute, Record. Never skip or reorder.