ifixkart-admin/.agents/skills/fix_bug/SKILL.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- Backend: FastAPI app with all models, services, schemas, routes
- Admin Panel: Next.js dashboard with all modules
  (CRM, POS, repairs, warranties, billing, notifications, etc.)
- Ecommerce: storefront (submodule) + product catalog
- AI Agents: .agents/ skill library for Antigravity IDE
- Docs: architecture, billing, notification gateway markdown
- Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
2026-10-13 12:59:47 +05:30

38 lines
1.5 KiB
Markdown

---
name: "Fix Bug"
description: "Reproduce a bug, patch the root cause, add regression coverage, and validate"
---
# Skill: Fix Bug
## 1. Purpose
To isolate the exact conditions causing a system failure, apply a permanent patch to the root cause, and write a regression test.
## 2. When to Use
When a bug report is raised or test assertions fail in production/local environments.
## 3. Preconditions
* Access to local logs showing error tracebacks.
* Test environment configured to execute regression scripts.
## 4. Step-by-Step Checklist
1. Read error traceback logs to identify the module and file.
2. Write a minimal reproduction test case that successfully fails.
3. Debug the logic flow (e.g. check for null variables or missing try-except wrappers).
4. Apply the patch to the root cause (do not just patch the symptoms).
5. Execute the reproduction test case and ensure it now passes.
## 5. Validation Checklist
* The reproduction test case executes and passes.
* Entire existing test suite passes (zero regression breakages).
* Logic changes do not introduce performance downgrades.
## 6. Examples
```python
# Symptom patch (Bad): if x is None: return 0
# Root cause patch (Good): ensure database query defaults are instantiated during model creation.
```
## 7. Failure Cases
* Adding conditional checks that temporarily hide errors, leading to silent database state corruption.
* Fixing code without writing a regression test, allowing the bug to return in future refactors.