roboco/.tasks/templates/bugfix.md

TASK-{ID}: {Title}

Template: Bugfix Created: YYYY-MM-DD Last Updated: YYYY-MM-DD

---

Status

Field	Value
State	pending
Priority	P{0-3}
Severity	{critical / high / medium / low}
Cell	{backend / frontend / ux_ui}
Assigned To	{agent-id or "unassigned"}
Reported By	{agent-id / user / automated}

Timeline

Milestone	Date
Reported	YYYY-MM-DD
Claimed	-
Root Cause Found	-
Fix Implemented	-
QA Verified	-
Completed	-

---

Bug Summary

{One sentence description of the bug}

Severity Assessment

Factor	Assessment
User Impact	{How many users affected? How badly?}
Frequency	{How often does it occur?}
Workaround	{Is there a workaround? What is it?}
Data Impact	{Any data loss or corruption?}

---

Reproduction

Environment

• Browser/Client: {e.g., Chrome 120, iOS app v2.1}
• OS: {e.g., macOS 14.1, Windows 11}
• User Type: {e.g., admin, regular user}
• Environment: {production / staging / development}

Steps to Reproduce

1. {Step 1}
2. {Step 2}
3. {Step 3}
4. {Observe the bug}

Expected Behavior

{What should happen}

Actual Behavior

{What actually happens}

Evidence

{Screenshots, error logs, console output}

{Paste error messages or logs here}

---

Investigation

Root Cause

{Filled in during investigation - what's causing this bug?}

Affected Code

{Files and functions involved}

• path/to/file.py:line_number
• path/to/other_file.py:line_number

Related Issues

• {Link to related bugs or tasks}
• {Previous similar issues}

---

Fix

Approach

{How will this be fixed?}

Changes Required

• {Change 1}
• {Change 2}
• {Change 3}

Regression Risk

{What could break as a result of this fix?}

Testing Plan

• {Test case 1 - verifies fix}
• {Test case 2 - checks regression}
• {Test case 3 - edge cases}

---

Verification Criteria

• Bug no longer reproducible with original steps
• No new errors in logs
• Related functionality still works
• Tests added to prevent regression
• {Additional verification criteria}

---

Commits

Commit	Description	Date
-	No commits yet	-

---

Quick Context Restore

Current state: Not started Investigation status: Not started Root cause: Unknown Fix approach: TBD

---

Notes

{Additional context, related issues, customer impact notes}

---

Changelog

Date	Agent	Change
YYYY-MM-DD	{agent}	Bug reported