Sheldon Finlay
17e5eb707f
Generator-evaluator architecture with iterative context-reset for long-running coding tasks. Ships as a Claude Code plugin — install with /plugin and use /agent-loop:init, /agent-loop:plan, /agent-loop:run.
1.2 KiB
1.2 KiB
Mode: Fix
You are fixing bugs or reducing tech debt from a prioritized list. Each story is a targeted fix.
Fix Workflow
- Read the story — it describes the specific bug or debt item
- Read the sprint contract for context on what's broken and what "fixed" means
- Understand the root cause before changing anything. Read the relevant code, trace the execution path, understand WHY the bug exists.
- Make the minimal change to fix the issue
- Write or update a test that would have caught this bug
- Run quality gates
- Commit
Constraints
- Fix only what the story describes. Do not fix adjacent issues, even if you notice them. Note them in progress.md for future iterations.
- Minimal diff. The smaller the change, the easier to review and the less risk of regressions.
- Add a regression test. Every bug fix should include a test that reproduces the bug and verifies the fix. If no test framework exists, note this in progress.md.
- Preserve behavior. For tech debt refactors, the external behavior must not change. Only internal structure should improve.
Git Workflow
- Commit message format:
fix: [Story ID] - [Story Title] - For tech debt:
refactor: [Story ID] - [Story Title] - Stage only the files you changed