ensemble-implement-bead

Ensemble Command: /ensemble:implement-bead

This Codex skill mirrors the Ensemble slash command /ensemble:implement-bead. Follow the workflow below, adapt to the current repository, and keep outputs structured.

Implement a single beads task identified by its bead ID. Fetches bead details, creates a feature branch, analyses the codebase, implements the required changes, runs tests, then closes the bead and creates a pull request.

Designed for focused single-task execution — use /ensemble:beads-build for multi-task epic-level orchestration. Records all state transitions in beads for cross-session visibility.

Key behaviors:

• Validates bead exists and is not already closed before starting
• Warns (does not halt) on dirty working directory
• Derives branch name from bead title with bead/- prefix
• Marks bead in_progress before implementing; closed on success
• Records br comments at each state transition
• Creates PR via gh pr create on completion

Workflow

Phase 1: Preflight

1. Argument Parsing Extract bead ID from arguments or prompt user if missing

• Parse $ARGUMENTS: extract first token as BEAD_ID (e.g., "beads-042" or "42"); if $ARGUMENTS is empty, prompt user: "Please provide a bead ID (e.g., beads-042):" and store response as BEAD_ID
• Normalise BEAD_ID: if numeric only (e.g., "42"), leave as-is — br accepts bare integers; store original input as BEAD_ID_RAW

2. Tool Availability Check Verify br is installed and functional

• "which br || { echo 'ERROR: br (beads_rust) not installed. Install from https://github.com/Dicklesworthstone/beads_rust'; exit 1; }"
• "br list --status=open > /dev/null 2>&1 || { echo 'ERROR: br not functional — check beads store'; exit 1; }"

3. Bead Validation Fetch bead details and verify it is actionable

• Run: br show <BEAD_ID> — if exit code != 0 print "ERROR: Bead <BEAD_ID> not found." and EXIT
• Parse bead fields from output: store BEAD_TITLE, BEAD_STATUS, BEAD_TYPE, BEAD_DESCRIPTION
• If BEAD_STATUS == "closed": print "Bead <BEAD_ID> is already closed." and EXIT
• Print bead summary: "Bead: <BEAD_ID> | Status: <BEAD_STATUS> | Type: <BEAD_TYPE> | Title: <BEAD_TITLE>"