implement-issue

name	implement-issue
description	Use when given a GitHub issue number and base branch to implement end-to-end
metadata	{"author":"aaddrick"}

Implement Issue

End-to-end issue implementation via orchestrator script.

Announce at start: "Using implement-issue to run orchestrator for #$ISSUE against $BRANCH"

Arguments:

• $1 — GitHub issue number (required)
• $2 — Base branch name (required)

Invocation

Immediately launch the orchestrator:

.claude/scripts/implement-issue-orchestrator.sh \
  --issue $ISSUE_NUMBER \
  --branch $BASE_BRANCH

Or with explicit agent override:

.claude/scripts/implement-issue-orchestrator.sh \
  --issue $ISSUE_NUMBER \
  --branch $BASE_BRANCH \
  --agent patch-engineer

Monitoring

Check progress via status.json:

jq . status.json

Watch live:

watch -n 5 'jq -c "{state,stage:.current_stage,task:.current_task,quality:.quality_iterations}" status.json'

Stages

Stage	Agent	Description
setup	default	fetch, worktree, research, evaluate, plan
implement	per-task	execute each task from plan
task-review	spec-reviewer	verify task achieved goal
fix	per-task	address review findings
simplify	cdd-code-simplifier	clean up code
test	bats-test-validator	run test suite (shellcheck + BATS)
lint	default	run shellcheck and actionlint
review	code-reviewer	internal code review
pr	default	create/update PR
spec-review	spec-reviewer	verify PR achieves issue goals
code-review	code-reviewer	final code quality check
complete	default	post summary

Schemas

Located in .claude/scripts/schemas/implement-issue-*.json

Logging

Logs written to logs/implement-issue/issue-N-timestamp/:

• orchestrator.log — main log
• stages/ — per-stage Claude output
• context/ — parsed outputs (tasks.json, etc.)
• status.json — final status snapshot

Exit Codes

Code	Meaning
0	Success, PR created and approved
1	Error during a stage
2	Max iterations exceeded
3	Configuration/argument error

Agent Selection

Tasks are assigned to specialist agents based on the issue type:

Agent	Use For
patch-engineer	Minified JS patches in build.sh, sed/regex patterns
packaging-specialist	.deb, .rpm, AppImage packaging, control files
electron-linux-specialist	BrowserWindow, Wayland/X11, DBus tray, native theme
ci-workflow-architect	GitHub Actions workflows, release automation
bash-script-craftsman	Shell scripts, launcher, build system

Integration

Called by handle-issues via batch-orchestrator.sh.

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.