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 .