dave/storkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 7 Wiki Activity

story-kit: accept 252_story_coder_agents_must_find_root_causes_for_bugs

Browse Source
This commit is contained in:
Dave
2026-03-16 23:38:24 +00:00
parent 95eea3a624
commit 9054ac013e
1 changed files with 0 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
.story_kit/work/6_archived/252_story_coder_agents_must_find_root_causes_for_bugs.md Normal file
View File

@@ -0,0 +1,22 @@
---
name: "Coder agents must find root causes for bugs"
---
# Story 252: Coder agents must find root causes for bugs
## User Story
As a project owner, I want coder agents to always investigate and fix the root cause of bugs rather than layering new code on top, so that fixes are surgical, minimal, and don't introduce unnecessary complexity.
## Acceptance Criteria
- [ ] When a coder agent picks up a bug, it must first investigate to find the root cause (e.g. using `git bisect`, `git log`, reading the relevant code history)
- [ ] The coder's commit message must explain what broke and why, not just what was changed
- [ ] Coders must not add new abstractions, wrappers, or workarounds when a targeted fix to the original code is possible
- [ ] The system prompt or agent instructions for coder agents include clear guidance: "For bugs, always find and fix the root cause. Use git bisect to find breaking commits. Do not layer new code on top of existing code when a surgical fix is possible."
- [ ] If a coder cannot determine the root cause, it must document what it tried and why it was inconclusive, rather than guessing and shipping a speculative fix
## Out of Scope
- Changes to how stories (non-bugs) are handled
- Automated enforcement (this is guidance/instruction, not a gate)