beads

name	beads
description	Beads task tracker integration for SDP workflows.

@beads

Beads integration for SDP. Mapping: .beads-sdp-mapping.jsonl (sdp_id → beads_id).

Quick Reference

Action	Command
Ready tasks	bd ready
Show task	bd show <id>
Update status	bd update <id> --status completed
Create	bd create --title="..." --type=task
Dependencies	bd dep add <task> <depends-on>
Sync	scripts/beads_transport.sh export

Integration Points

• @build/@oneshot — Check bd ready before WS, bd update after
• @design — bd create for new WS, bd dep add for dependencies
• Mapping — .beads-sdp-mapping.jsonl links WS ID to beads ID

Recovery

Symptom	Fix
Skill produces no output	Check working directory is project root with docs/workstreams/backlog/
"checkpoint not found"	Run sdp-orchestrate --feature <ID> to create initial checkpoint
"workstream files missing"	Run sdp-orchestrate --index to verify, then @feature to regenerate
Skill hangs / no progress	Check .sdp/log/events.jsonl for last event; use sdp reset --feature <ID> if stuck
Review loop exceeds 3 rounds	Use @review --override "reason", @review --partial, or @review --escalate

See Also

• @build — Uses beads for dependency check
• @oneshot — Wave execution
• AGENTS.md — bd ready, bd show, bd update, bd close, scripts/beads_transport.sh export