- 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
1.5 KiB
1.5 KiB
| name | description |
|---|---|
| Fix Bug | 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
- Read error traceback logs to identify the module and file.
- Write a minimal reproduction test case that successfully fails.
- Debug the logic flow (e.g. check for null variables or missing try-except wrappers).
- Apply the patch to the root cause (do not just patch the symptoms).
- 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
# 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.