lavra-work-single

SINGLE-BEAD PATH

Used when exactly one bead is being worked on. Full-quality interactive flow with built-in review, fix loop, and learn phases.

State machine: IMPLEMENTING -> REVIEWING -> FIXING -> RE_REVIEWING -> LEARNING -> DONE

Flags:

• --skip-review: skip the /lavra-review subagent call in Phase 3 step 3. Self-review (step 2) still runs. Used by the sequential epic loop, which runs a single review pass after all beads complete.
• EPIC_PLAN={...}: epic locked decisions injected by the sequential loop. Treat identically to a parent epic read in Phase 1 step 1.

---

<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 1: Quick Start

1. Read Bead and Clarify

   If a bead ID was provided:

   bd show {BEAD_ID} --long
   

   Read the bead description completely including:

   • What section (implementation requirements)
   • Context section (research findings, constraints)
   • Decisions section (Locked = must honor, Discretion = agent's flexibility budget, Deferred = do NOT implement)
   • Testing section (test cases to implement)
   • Validation section (acceptance criteria)
   • Dependencies section (blockers)
   • Comments (INVESTIGATION/FACT/PATTERN/DECISION/LEARNED from research phase -- treat as implementation constraints with the same weight as Locked Decisions)

   If the bead has a parent epic, also read the epic's decision sections:

   bd show {BEAD_ID} --json | jq -r '.[0].parent // empty'
   # If parent exists:
   bd show {PARENT_EPIC_ID}
   

   Extract ## Locked Decisions, ## Agent Discretion, and ## Deferred sections. Locked = must honor. Discretion = deviation budget. Deferred = do NOT implement (these are explicitly out of scope).