bds-workflowlisted
Install: claude install-skill seungyeop-lee/beads-starter
# Beads Workflow
Project-specific beads workflow conventions for any file-modifying task.
## Initialization
Before any workflow step below, verify `bd where` succeeds. If `bd` is not installed or `bd where` fails (the repo has not been initialized for bd), invoke the `bds-setup` skill to install bd and run the init flow, then resume.
## Agent Workflow
Every file-modifying task, including trivial doc edits, follows these 10 steps:
```dot
digraph agent_workflow {
rankdir=TB;
node [shape=box, style=filled, fillcolor="#f8f8f8"];
edge [color="#333333"];
register [label="1. Register\nEnsure issue exists"];
await [label="2. Await approval\nWait for user"];
progress [label="3. In Progress\nbd update --status=in_progress"];
execute [label="4. Execute\nModify files"];
report [label="5. Report\nSummarize, request review"];
branch [label="6. Branch" shape=diamond fillcolor="#ffe0b2"];
commit [label="7. Commit\nStage only issue files"];
comment [label="8. Comment\nbd comments add"];
notes [label="9. Notes (if needed)\nbd update --notes"];
close [label="10. Close\nbd close"];
register -> await;
await -> progress [label="approved"];
progress -> execute;
execute -> report;
report -> branch;
branch -> commit [label="done"];
branch -> execute [label="feedback" style=dashed];
commit -> comment;
comment -> notes;
notes -> close;
discovery [label="mid-execution disco