bd-workflow
bd (beads) Workflow Guide
This document expands the abbreviated rules in AGENTS.md. Read this whenever you interact with task tracking, planning docs, or MCP helpers.
Why bd?
- Dependency-aware: track blockers, dependents, and discovered-from links.
- Git-friendly: bd auto-syncs to
.beads/issues.jsonl, so repos capture task history. - Agent-optimized: machine-readable JSON output (
--json) plus "ready" filtering. - Single source of truth: prevents duplicate trackers, markdown TODOs, or ad-hoc spreadsheets.
Quick Start Commands
bd ready --json -n 0 # find unblocked work
bd create "Issue title" -t task -p 2 --json
bd update bd-42 --status in_progress --json
bd close bd-42 --reason "Completed" --json
More from lambdamechanic/skills
dumbwaiter-mcp
Provider-agnostic wait-for-change skill that uses the Dumbwaiter MCP server to wait on PR events (GitHub first) via wait.start/status/cancel/await, with progress notifications and durable state.
60rust-guidelines
Pragmatic Rust conventions to keep code readable, testable, and performant for this project.
9landing-the-plane
Checklist for finishing work, pushing a branch, and opening a ready-for-review PR with tests and tracker updates.
8python
Default Python stack for Lambda: uv + Astral tools, typed code, schemas, and Hypothesis.
6typescript
Default TypeScript stack for Lambda: pnpm workspaces + Turbo, strict TS, and sensible DX helpers.
6galahad
how to approach tests, types and coverage
5