bug-fix-iteration

Category: Tools & Productivity | Uploader: Bulugulu | Downloads: 0 | Version: v1.0（Latest）

Systematic approach to fixing bugs reported via pasted logs. Prevents the agent from making broad changes that introduce regressions when only a targeted fix is needed. [GENERATED BY MOTIF — review and customize]

Changelog: Source: GitHub https://github.com/Bulugulu/motif-cli

Directory Structure

Current level: examples/generated/skills/project/bug-fix-iteration/

📄 SKILL.md 2.1 KB

SKILL.md

---
name: bug-fix-iteration
description: "Systematic approach to fixing bugs reported via pasted logs. Prevents the agent from making broad changes that introduce regressions when only a targeted fix is needed. [GENERATED BY MOTIF — review and customize]"
---

# Bug Fix Iteration

Systematic approach to fixing bugs reported via pasted logs. Prevents the agent from making broad changes that introduce regressions when only a targeted fix is needed.

## When to Use

- User pastes error logs, stack traces, or console output
- User says 'it's still broken' or 'that didn't work'
- Especially when: previous fix attempt didn't resolve the issue
- Don't skip when: the error seems 'obvious' -- still follow the process

## Instructions

1. Read the pasted logs carefully
   - identify the exact error message and location
2. If error is ambiguous, ask the user one clarifying question before proceeding
3. Check if this is a known issue pattern (same file/component as previous bugs)
4. Propose a targeted fix that addresses only the specific error
5. Do NOT refactor or modify unrelated code in the same change
6. Apply the fix
7. Ask user to test and report back
8. If fix doesn't work after 2 attempts, step back and investigate root cause more broadly

## Best Practices

- Read the entire error message, not just the first line
- Fix one thing at a time -- don't bundle multiple changes
- **Avoid:** Don't refactor code that isn't related to the bug
- Always ask the user to verify the fix worked

## Common Pitfalls

| Problem | Solution |
|---|---|
| Agent modifies unrelated code, causing new bugs | Only touch files directly related to the reported error |
| Agent proposes sweeping refactor instead of targeted fix | Fix the bug first; propose refactoring separately if needed |
| Going in circles with the same fix approach | After 2 failed attempts, investigate root cause from a different angle |

## Key Constraints

- Never modify files unrelated to the reported bug
- Always ask the user to verify after applying a fix
- After 2 failed fix attempts, change your investigation approach

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

bug-fix-iteration

Directory Structure

SKILL.md

Report

Notice