From 49b3353688adf50c5baac4c5041d64ebf9a88830 Mon Sep 17 00:00:00 2001 From: Ryan Snodgrass Date: Wed, 3 Dec 2025 15:32:39 -0800 Subject: [PATCH] docs: encourage batch close and parallel creation in bd prime output MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Update examples to show `bd close ...` for batch closing - Add quick reference entry for closing multiple issues at once - Add tip about using parallel subagents for creating multiple issues - Add comment in example about running bd create in parallel Cherry-picked from PR #452 (prime.go changes only) Co-Authored-By: Ryan Snodgrass 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- cmd/bd/prime.go | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/cmd/bd/prime.go b/cmd/bd/prime.go index 5776aacb..02cdeebe 100644 --- a/cmd/bd/prime.go +++ b/cmd/bd/prime.go @@ -167,8 +167,8 @@ func outputCLIContext() error { - ` + "`bd sync --status`" + ` - Check sync status without syncing` completingWorkflow = `**Completing work:** ` + "```bash" + ` -bd close # Mark done -bd sync --from-main # Pull latest beads from main +bd close ... # Close all completed issues at once +bd sync --from-main # Pull latest beads from main git add . && git commit -m "..." # Commit your changes # Merge to main when ready (local merge, not push) ` + "```" @@ -185,8 +185,8 @@ git add . && git commit -m "..." # Commit your changes - ` + "`bd sync --status`" + ` - Check sync status without syncing` completingWorkflow = `**Completing work:** ` + "```bash" + ` -bd close # Mark done -bd sync # Push to remote +bd close ... # Close all completed issues at once +bd sync # Push to remote ` + "```" } @@ -224,7 +224,9 @@ bd sync # Push to remote - ` + "`bd update --status=in_progress`" + ` - Claim work - ` + "`bd update --assignee=username`" + ` - Assign to someone - ` + "`bd close `" + ` - Mark complete +- ` + "`bd close ...`" + ` - Close multiple issues at once (more efficient) - ` + "`bd close --reason=\"explanation\"`" + ` - Close with reason +- **Tip**: When creating multiple issues/tasks/epics, use parallel subagents for efficiency ### Dependencies & Blocking - ` + "`bd dep add `" + ` - Add dependency (issue depends on depends-on) @@ -250,6 +252,7 @@ bd update --status=in_progress # Claim it **Creating dependent work:** ` + "```bash" + ` +# Run bd create commands in parallel (use subagents for many items) bd create --title="Implement feature X" --type=feature bd create --title="Write tests for X" --type=task bd dep add beads-yyy beads-xxx # Tests depend on Feature (Feature blocks tests)