Prompt file imported from ranjbar-dev/task-management (.github/prompts/fix-bug.prompt.md). Fill in {{description}}, {{steps}}, {{expected}}, {{actual}}, {{files}} before use. Copyright stays with the author.

Fix Bug

Name: fix-bug
Author: ranjbar-dev

Debug and fix a bug with regression test coverage.

Context

You are the Testing agent (analysis) + relevant implementation agent (fix). This is the one exception to the spec-first gate — bugs can be fixed without a spec.

Inputs

Bug description: {{ description }}
Steps to reproduce: {{ steps }}
Expected behavior: {{ expected }}
Actual behavior: {{ actual }}
Affected files: {{ files }} (if known)

Process

1. Reproduce & Analyze

Trace the bug from the described symptoms to the root cause
Identify the minimal set of files involved
Document the root cause in a comment

2. Write Regression Test FIRST

Before fixing anything, write a test that fails due to the bug:

// tests/unit/...or.../tests/e2e/...
it('should [expected behavior] (regression: [bug summary])', () => {
  // This test should FAIL before the fix and PASS after
})

3. Implement the Fix

Make the minimal change to fix the root cause
Do not refactor unrelated code in the same change
Add a comment at the fix site: // Fix: [brief description of what was wrong]

4. Verify

Confirm the regression test now passes
Run existing tests to ensure no regressions
Check TypeScript compilation
Check ESLint + Prettier

Output

[modified source files]
[new or modified test files]

Bug Fix Comment Template

At the fix site in the source code:

// Fix: [one-line description]
// Root cause: [what was wrong]
// Regression test: tests/unit/path/to/test.test.ts

Quality Checks

Root cause identified — not just symptoms treated
Regression test written BEFORE the fix
Regression test fails without fix, passes with fix
Minimal change — no drive-by refactoring
Existing tests still pass
TypeScript compiles with zero errors
ESLint + Prettier pass

# Fix Bug Debug and fix a bug with regression test coverage. ## Context You are the Testing agent (analysis) + relevant implementation agent (fix). This is the **one exception** to the spec-first gate — bugs can be fixed without a spec. ## Inputs - **Bug description:** {{ description }} - **Steps to reproduce:** {{ steps }} - **Expected behavior:** {{ expected }} - **Actual behavior:** {{ actual }} - **Affected files:** {{ files }} (if known) ## Process ### 1. Reproduce & Analyze - Trace the bug from the described symptoms to the root cause - Identify the minimal set of files involved - Document the root cause in a comment ### 2. Write Regression Test FIRST Before fixing anything, write a test that fails due to the bug: ```typescript // tests/unit/...or.../tests/e2e/... it('should [expected behavior] (regression: [bug summary])', () => { // This test should FAIL before the fix and PASS after }) ``` ### 3. Implement the Fix - Make the minimal change to fix the root cause - Do not refactor unrelated code in the same change - Add a comment at the fix site: `// Fix: [brief description of what was wrong]` ### 4. Verify - Confirm the regression test now passes - Run existing tests to ensure no regressions - Check TypeScript compilation - Check ESLint + Prettier ## Output ``` [modified source files] [new or modified test files] ``` ## Bug Fix Comment Template At the fix site in the source code: ```typescript // Fix: [one-line description] // Root cause: [what was wrong] // Regression test: tests/unit/path/to/test.test.ts ``` ## Quality Checks - [ ] Root cause identified — not just symptoms treated - [ ] Regression test written BEFORE the fix - [ ] Regression test fails without fix, passes with fix - [ ] Minimal change — no drive-by refactoring - [ ] Existing tests still pass - [ ] TypeScript compiles with zero errors - [ ] ESLint + Prettier pass

{ "prompt": "# Fix Bug\n\nDebug and fix a bug with regression test coverage.\n\n## Context\n\nYou are the Testing agent (analysis) + relevant implementation agent (fix). This is the **one exception** to the spec-first gate — bugs can be fixed without a spec.\n\n## Inputs\n\n- **Bug description:** {{ description }}\n- **Steps to reproduce:** {{ steps }}\n- **Expected behavior:** {{ expected }}\n- **Actual behavior:** {{ actual }}\n- **Affected files:** {{ files }} (if known)\n\n## Process\n\n### 1. Reproduce & Analyze\n- Trace the bug from the described symptoms to the root cause\n- Identify the minimal set of files involved\n- Document the root cause in a comment\n\n### 2. Write Regression Test FIRST\nBefore fixing anything, write a test that fails due to the bug:\n\n```typescript\n// tests/unit/...or.../tests/e2e/...\nit('should [expected behavior] (regression: [bug summary])', () => {\n // This test should FAIL before the fix and PASS after\n})\n```\n\n### 3. Implement the Fix\n- Make the minimal change to fix the root cause\n- Do not refactor unrelated code in the same change\n- Add a comment at the fix site: `// Fix: [brief description of what was wrong]`\n\n### 4. Verify\n- Confirm the regression test now passes\n- Run existing tests to ensure no regressions\n- Check TypeScript compilation\n- Check ESLint + Prettier\n\n## Output\n\n```\n[modified source files]\n[new or modified test files]\n```\n\n## Bug Fix Comment Template\n\nAt the fix site in the source code:\n\n```typescript\n// Fix: [one-line description]\n// Root cause: [what was wrong]\n// Regression test: tests/unit/path/to/test.test.ts\n```\n\n## Quality Checks\n\n- [ ] Root cause identified — not just symptoms treated\n- [ ] Regression test written BEFORE the fix\n- [ ] Regression test fails without fix, passes with fix\n- [ ] Minimal change — no drive-by refactoring\n- [ ] Existing tests still pass\n- [ ] TypeScript compiles with zero errors\n- [ ] ESLint + Prettier pass", "variables": [ "description", "steps", "expected", "actual", "files" ], "notes": "Debug and fix a bug with regression test coverage.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/ranjbar-dev/task-management", "path": ".github/prompts/fix-bug.prompt.md", "ref": "ac50686920d4a7214a5c2652cab7f87163cfb4ec", "url": "https://github.com/ranjbar-dev/task-management/blob/ac50686920d4a7214a5c2652cab7f87163cfb4ec/.github/prompts/fix-bug.prompt.md", "key": "ranjbar-dev/task-management/.github/prompts/fix-bug.prompt.md" } } }

fix-bug

About