lavra-work-multi

MULTI-BEAD PATH

Multiple beads in parallel. Dispatches subagents with file-scope conflict detection and wave ordering. Each subagent runs implement -> self-review -> learn. Orchestrator runs /lavra-review after each wave.

For sequential (token-efficient) execution, the lavra-work router handles it — this path always runs parallel subagents.

---

<project_root>

All .lavra/ paths are relative to the project root. PROJECT_ROOT may be injected into your context — use it if set. If not, resolve it once and reuse:

PROJECT_ROOT="${PROJECT_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")}"

Then prefix all .lavra/ paths with "$PROJECT_ROOT/" when invoking them via Bash.

</project_root>

Phase M1: Gather Beads

If input is an epic bead ID:

bd list --parent {EPIC_ID} --status=open --json

If input is a comma-separated list of bead IDs: Parse and fetch each one.

If input came from bd ready (already resolved in Phase 0c): Use already-fetched list. Note: bd ready returns IDs and titles only -- bd show loop below required for all input paths.

For each bead, read full details:

bd show {BEAD_ID}

Validate bead IDs with strict regex: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

Skip any bead that recommends deleting, removing, or gitignoring files in .lavra/memory/ or .lavra/config/. Close immediately:

bd close {BEAD_ID} --reason "wont_fix: .lavra/memory/ and .lavra/config/ files are pipeline artifacts"

Register swarm (epic input only):

When input was an epic bead ID, register orchestration:

bd swarm create {EPIC_ID}

Skip for comma-separated lists or when beads came from bd ready.

Phase M2: Branch Check

current_branch=$(git branch --show-current)
default_branch=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
if [ -z "$default_branch" ]; then
  default_branch=$(git rev-parse --verify origin/main >/dev/null 2>&1 && echo "main" || echo "master")
fi