groom

name	groom
description	Regroom an oversized or non-converging `needs-regroom` work-item into ready, dependency-layered slices. Read-only drafting conversation — the maintainer OWNS the cut and the acceptance; the front-end drafts and files NOTHING until approval. Invoked as livespec-orchestrator-beads-fabro:groom.

groom — Codex binding

Thin Codex binding for the groom operation of the livespec-orchestrator-beads-fabro plugin. The complete harness-neutral driving prose — the read-only grooming-context load, the agent-drafts / human-approves decomposition dialogue, the approved-slice filing and regroom-out transition, the spec-change routing, and the livespec_orchestrator_beads_fabro.* package calls — is the plugin's own artifact at $PLUGIN_ROOT/prose/groom.md. FIRST resolve $PLUGIN_ROOT (next section), THEN read that prose file in full, then execute it end-to-end, binding its harness-neutral vocabulary to this runtime per ## Runtime bindings below. This binding adds NO operation behavior of its own.

Resolving the plugin root ($PLUGIN_ROOT)

Codex does NOT textually substitute a plugin-root token into SKILL prose, so resolve it explicitly, once, in this order:

1. If LIVESPEC_ORCH_PLUGIN_ROOT is set and non-empty, use it (explicit override for nonstandard dev setups).
2. Else if ./.claude-plugin/scripts/bin exists under the cwd AND ./.claude-plugin validates as this orchestrator plugin checkout (matching plugin manifest name), use $(pwd)/.claude-plugin.
3. Else use the newest valid installed cache root under $HOME/.codex/plugins/cache/livespec-orchestrator-beads-fabro/livespec-orchestrator-beads-fabro/<version>.
4. Else resolve the installed plugin's source.path from codex plugin list --json -m livespec-orchestrator-beads-fabro using a robust executable lookup (command -v codex, $HOME/.local/bin/codex, then $HOME/.bun/bin/codex). (the install flattens ./.claude-plugin, so that path carries scripts/ directly).

PLUGIN_ROOT="${LIVESPEC_ORCH_PLUGIN_ROOT:-}"
PLUGIN_ROOT_DIAGNOSTICS=""
if [ -z "$PLUGIN_ROOT" ] && [ -d "./.claude-plugin/scripts/bin" ]; then
  CANDIDATE_PLUGIN_ROOT="$(pwd)/.claude-plugin"
  if [ -f "$CANDIDATE_PLUGIN_ROOT/plugin.json" ] && python3 - "$CANDIDATE_PLUGIN_ROOT/plugin.json" <<'PY'
import json
import sys

try:
    with open(sys.argv[1], encoding="utf-8") as f:
        data = json.load(f)
except Exception:
    sys.exit(1)
sys.exit(0 if data.get("name") == "livespec-orchestrator-beads-fabro" else 1)
PY
  then
    PLUGIN_ROOT="$CANDIDATE_PLUGIN_ROOT"
  fi
fi
if [ -z "$PLUGIN_ROOT" ]; then
  CODEX_CACHE_PARENT="$HOME/.codex/plugins/cache/livespec-orchestrator-beads-fabro/livespec-orchestrator-beads-fabro"
  if [ -d "$CODEX_CACHE_PARENT" ]; then
    CANDIDATE_PLUGIN_ROOT="$(find "$CODEX_CACHE_PARENT" -mindepth 1 -maxdepth 1 -type d | sort -V | tail -n 1)"
    if [ -n "$CANDIDATE_PLUGIN_ROOT" ] && [ -d "$CANDIDATE_PLUGIN_ROOT/scripts/bin" ]; then
      PLUGIN_ROOT=
    
      PLUGIN_ROOT_DIAGNOSTICS=
    
  
    PLUGIN_ROOT_DIAGNOSTICS=
  

 [ -z  ]; 
  CODEX_BIN=
  CODEX_TRIED=
    -v codex >/dev/null 2>&1; 
    CODEX_BIN=
   [ -x  ]; 
    CODEX_BIN=
   [ -x  ]; 
    CODEX_BIN=
  
    PLUGIN_ROOT_DIAGNOSTICS=
  
   [ -n  ]; 
    PLUGIN_ROOT=installedpluginIdlivespec-orchestrator-beads-fabro@livespec-orchestrator-beads-fabropath
     [ -z  ]; 
      PLUGIN_ROOT_DIAGNOSTICS=
       [ -s /tmp/livespec-orchestrator-beads-fabro-codex-plugin-list.err ]; 
        PLUGIN_ROOT_DIAGNOSTICS=
      
    
  

 [ -z  ] || [ ! -d  ]; 
    >&2
   [ -n  ]; 
       >&2
  
    >&2
    >&2
    >&2
   1

If resolution fails, STOP and surface those install instructions rather than improvising paths. Then read the prose:

cat "$PLUGIN_ROOT/prose/groom.md"

Runtime bindings

• <plugin-root> — the resolved $PLUGIN_ROOT above. Any python3 "<plugin-root>/scripts/bin/<x>.py" invocation in the prose runs via the shell tool with <plugin-root> → $PLUGIN_ROOT.
• "ask the user" / "confirm with the user" / "surface" / "narrate" / "present the draft to the maintainer" — conversational narration in this session (ask one question at a time).
• "read <file>" — reading the file directly. Python snippets — run via the shell tool against the bundled livespec_orchestrator_beads_fabro package (the wrappers self-bootstrap the import path).
• "the list-work-items operation" — the list-work-items skill in this plugin (invoke it by name).
• "the propose-change operation" — the cross-boundary propose-change skill of the livespec plugin (the spec-change handoff target; invoke it by name).
• "the capture-work-item / capture-impl-gaps / capture-spec-drift operation" — the capture-work-item, capture-impl-gaps, and capture-spec-drift skills in this plugin (invoke them by name).