Develop Bug — Automated Bug-Fix Lifecycle Orchestrator

This skill orchestrates the complete bug-fix lifecycle, calling each skill in sequence and maintaining an implementation report that records every significant decision and issue encountered along the way. It is the bug-anchored sibling of develop-story / develop-task: the bug report file is the primary input and the primary audit surface (in addition to the co-located implementation report).

The distinguishing gap this skill fills: no existing skill takes an open bug report all the way to a closed, verified, documented fix. create-bug-report creates the file; qa-fix writes an interim fix record but is PR-gated and stops at ready-for-qa. develop-bug runs the whole lifecycle and writes the ## Resolution Summary that closes the bug.

Setup — Pipeline Hooks (one-time, per project)

The pipeline runs hands-free when two Claude Code hooks (PreCompact for graceful pause; Stop for forced continuation) are registered in .claude/settings.json. Strongly recommended — without the Stop hook, the orchestrator relies on prose-level "never stop between steps" rules that have been observed to fail under context pressure.

Install both with one command (idempotent, preserves existing settings, --dry-run available):

bash .agents/skills/develop-bug/scripts/install-hooks.sh

The hooks are shared with develop-story / develop-task and are keyed off the pipeline lock's skill field — installing them once covers all three pipelines. Full reference — every hook, escape valves, interaction diagram, troubleshooting: references/develop-pipeline-hooks.md. Deep PreCompact pause/resume semantics: references/develop-pipeline-pause.md. Lock-advance helper: references/advance-pipeline-lock.sh.

Hooks noop outside pipeline runs — zero overhead when no .claude/state/develop-pipeline.lock is present.