bd-workflow
Installation
SKILL.md
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
Related skills
More from lambdamechanic/sk
rust-guidelines
Pragmatic Rust conventions to keep code readable, testable, and performant for this project.
5dumbwaiter-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.
5testing-patterns
Testing patterns and standards for this codebase, including async effects, fakes vs mocks, and property-based testing.
4template-skill
Replace with description of the skill and when Claude should use it.
4sk
How to use the repo-scoped sk CLI to manage Claude Skills in this codebase.
1