name: flywheel-candidate-fix description: Generate candidate fix PRs for one issue in this repository. Use when working on the 3-candidate fix model, TDD fix flow, and strict branch/PR naming conventions. allowed-tools: Read,Grep,Glob,LS,Edit,MultiEdit,Write,Bash(git *),Bash(gh *),Bash(uv run pytest *),Bash(uv run ruff *)

Flywheel Candidate Fix

Goal

Produce a small, reviewable candidate PR that addresses one issue using TDD and project conventions.

Workflow

1. Read issue details and target files.
2. RED: add/adjust a failing regression test for the issue.
3. GREEN: implement minimal fix to pass test.
4. Run targeted checks:
   • uv run pytest ...
   • uv run ruff check ...
5. Create candidate branch and PR with project naming convention:
   • Branch: claude/issue-<id>-candidate-<n>-<run_id>
   • PR title prefix: [AUTOFIX][ISSUE-<id>][CANDIDATE-<n>]
6. Include in PR body:
   • Summary
   • Tests run
   • Risks/limitations
   • Closes #<id> when appropriate

Safety Rules

• Never push directly to master.
• Keep scope to one issue.
• Avoid workflow or secret changes.

Output Checklist

• Test file(s) added/changed
• Source file(s) changed
• Commands executed
• PR URL