Work Issue End-to-End
Drive issue work from selection to PR with minimal back-and-forth.
Phase 1: Preflight + Selection
- Confirm repo is in a safe starting state (usually clean tree on
main). - If issue number is missing, list open issues and ask user to pick one.
- Fetch issue details (including comments) and create branch
<number>-<kebab-title>.
Phase 2: Implement
- Prefer TDD for behavior changes (red/green/refactor).
- Implement non-behavioral wiring/types directly.
- Run
make validateduring development. - Keep scope aligned with issue constraints.
Phase 3: Review
- Run
code-reviewskill. - Run
review-with-geminiwhen available. - Apply straightforward fixes automatically.
- If blocking feedback remains, pause and present options:
- fix and re-review,
- proceed with explicit override,
- stop and document learnings.
Phase 4: Finalize
- Run full checks (
make validate-fullwhen available, else project equivalent). - Commit cleanly.
- Push branch and open PR with summary + test plan +
Closes #<issue>. - Comment on issue with PR link and validation status.
Phase 5: Handoff
After PR creation, ask whether to:
- merge now,
- leave for user merge,
- keep iterating on branch.
Prefer ending in a clean local state on latest main unless user wants continued branch work.