@@ -6,10 +6,10 @@ Run `git rev-parse --show-toplevel` to get the repo basename. If in a git repo,
66
77## 2. Fetch ready tasks
88
9- - In a repo: ` br ready -t repo:<basename> `
10- - Not in a repo: ` br ready `
9+ - In a repo: ` br ready -t repo:<basename> --json `
10+ - Not in a repo: ` br ready --json `
1111
12- If no tasks are ready, run ` br blocked ` , report what's stuck, and ask the user how to proceed.
12+ If no tasks are ready, run ` br blocked --json ` , report what's stuck, and ask the user how to proceed.
1313
1414## 3. Rank and select (up to 5)
1515
@@ -20,11 +20,26 @@ From the ready list, pick the best tasks to work on now:
20203 . ** Unblocks others** — if you can tell a task is a dependency for blocked work, prefer it
21214 . ** Skip vague/unclear tasks** — if a task title is ambiguous, deprioritize it
2222
23- Select up to 5 tasks. If only 1 is ready, just pick it.
23+ Create an implementation plan:
24+ * Select up to 5 tasks. If only 1 is ready, just pick it.
25+ * Identify which can be done in true parallel (e.g. multiple agents, parallel file edits)
26+ * Note any logical sequencing needed
27+
2428
2529## 4. Start and execute
2630
2731- Run ` br start <id> ` for each selected task
2832- If 1 task: begin implementation directly
2933- If 2+ tasks: use the ` dispatching-parallel-agents ` skill to work them in parallel (each agent gets a worktree)
3034- Tell the user which tasks you're picking up and why
35+ - execute the plan from above
36+ - As each task is completed:
37+ * verify the implementation works
38+ * run /simplify on the solution
39+ * close the task: ` br close <id> `
40+ - show the final summary
41+
42+ ## Best practices:
43+ - Use parallel file edits when tasks touch different files
44+ - Update br task status immediately before starting and after completing each task
45+ - If a task fails, leave it in_progress and report the issue to the user, and also note it by using ` br edit --append `
0 commit comments