Bug Tracking & Resolution
Guidelines for reporting, tracking, and resolving bugs across FLYPILOT projects.
Task Systems by Organization
| Organization | System | Bug Prefix |
|---|---|---|
| FLYPILOT | Linear | FLY-### |
| OMG Interactive | Shortcut | sc-### |
| Learned Media | Asana | Task URL |
All systems sync to Linear for unified visibility across the agency.
Bug Reporting
Required Information
Every bug report must include:
- Title: Clear, descriptive summary
- Environment: Browser, device, OS
- Steps to Reproduce: Numbered list
- Expected Behavior: What should happen
- Actual Behavior: What actually happened
- Screenshots/Video: Visual evidence
- Severity: Critical, High, Medium, Low
Bug Report Template
## Bug: [Short Description]
### Environment
- **URL**: [staging/production URL]
- **Browser**: Chrome 120, Firefox 121
- **Device**: Desktop / iPhone 14
- **OS**: macOS 14.2 / iOS 17.2
- **User Type**: Admin / Logged In / Guest
### Steps to Reproduce
1. Navigate to [URL]
2. Click [element]
3. Enter [data]
4. Submit form
### Expected Behavior
The form should submit and display success message.
### Actual Behavior
Form submission fails with error "undefined is not a function".
### Screenshots/Video
[Attach screenshots or Loom link]
### Console Errors
TypeError: undefined is not a function at handleSubmit (form.js:45)
### Severity
[ ] Critical - Site unusable
[x] High - Major feature broken
[ ] Medium - Feature impaired
[ ] Low - Minor issue
### Additional Context
- Only happens when discount code is applied
- Works fine without discount code
Severity Levels
Critical
- Site completely down
- Security vulnerability
- Data loss or corruption
- Payment processing failure
Response: Immediate attention, drop other work
High
- Major feature not working
- Blocking user workflow
- Affects many users
- Visible to all users
Response: Fix within 24 hours
Medium
- Feature partially working
- Workaround available
- Affects subset of users
- Visual issues on major browsers
Response: Fix within 48-72 hours
Low
- Minor visual issues
- Edge cases
- Enhancement requests
- Documentation issues
Response: Address in next sprint
Bug Lifecycle
┌─────────┐ ┌──────────┐ ┌───────────┐
│ Reported │────>│ Triaged │────>│ Assigned │
└─────────┘ └──────────┘ └───────────┘
│
v
┌─────────┐ ┌──────────┐ ┌───────────┐
│ Closed │<────│ Verified │<────│In Progress│
└─────────┘ └──────────┘ └───────────┘
Status Definitions
| Status | Description |
|---|---|
| Reported | Bug submitted, awaiting triage |
| Triaged | Reviewed, severity assigned |
| Assigned | Developer assigned to fix |
| In Progress | Actively being worked on |
| Ready for QA | Fix deployed to staging |
| Verified | QA confirmed fix |
| Closed | Fix deployed to production |
Triage Process
Daily Triage
- Review all new bugs
- Verify reproduction steps
- Assign severity
- Identify duplicates
- Assign to sprint/developer
Triage Questions
- Can we reproduce it?
- How many users affected?
- Is there a workaround?
- Is it regression or new?
- Related to recent changes?
Resolution Process
Developer Steps
- Acknowledge: Comment on ticket within 4 hours
- Investigate: Identify root cause
- Fix: Implement solution
- Test: Verify fix locally
- PR: Submit with bug reference
- Deploy: Push to staging
- Notify: Move to "Ready for QA"
Fix Commit Message
fix(cart): correct total calculation with discounts
Bug was caused by applying discount after tax instead of before.
This fix reorders the calculation to apply discount first.
Fixes FLY-456
Regression Bugs
Definition
A bug in functionality that previously worked.
Handling
- Priority: Automatically High or Critical
- Root Cause: Required - what change caused it?
- Prevention: Add test to prevent recurrence
Regression Report
## Regression: [Feature] stopped working
### When it broke
- **Last known working**: 2026-01-15
- **First reported broken**: 2026-01-18
- **Likely cause**: PR #123 (merged 2026-01-16)
### Impact
- All users affected
- Core checkout flow blocked
### Investigation
Bisected commits, identified issue in PR #123 change to tax calculation.
Bug Metrics
Track Monthly
| Metric | Target |
|---|---|
| Bugs found in QA | > 90% |
| Bugs found in production | < 10% |
| Critical bugs | 0 |
| Average resolution time | < 48 hours |
| Regression rate | < 5% |
Resolution Time Targets
| Severity | Target |
|---|---|
| Critical | 4 hours |
| High | 24 hours |
| Medium | 72 hours |
| Low | 1 sprint |
Communication
Bug Found Notification
@dev-team Bug found in staging
**Ticket**: FLY-456
**Severity**: High
**Feature**: Checkout discount application
**Summary**: Discount codes not applying to cart total
**Staging URL**: staging.site.com/cart
**Steps**: Apply code "SAVE10", total unchanged
Please review when available.
Bug Fixed Notification
@qa-team Ready for verification
**Ticket**: FLY-456
**Fix PR**: #789
**Staging**: Updated and deployed
**Testing notes**:
- Apply discount code "SAVE10"
- Verify 10% reduction in cart total
- Test with multiple items
Let me know if issues persist.
Production Bugs
Production bugs should be reported immediately in Slack with @channel mention for Critical severity.