Hotfix Skill
Fast-track fixes for production incidents.
When to Use
- Production is down or degraded
- Critical bug affecting users
- Security vulnerability discovered
How It Differs from Normal Flow
| Normal | Hotfix | |--------|--------| | Branch from develop | Branch from main | | ASK mode exploration | Skip to fix | | Full PR review | Expedited review | | Standard Slack message | URGENT alert |
The Flow
- Branch - Create hotfix branch from main
- Fix - Implement minimal fix
- Verify - Test fix works
- PR - Create with HOTFIX label
- Alert - Notify team urgently
Phase Checklist
Phase 1: Create Hotfix Branch
- [ ] Fetch latest:
git fetch origin main - [ ] Branch from main:
git checkout -b hotfix/<issue-summary> origin/main - [ ] Confirm on hotfix branch
Phase 2: Implement Fix
- [ ] Identify root cause (minimal investigation)
- [ ] Implement smallest possible fix
- [ ] Run typecheck and lint
- [ ] NO new features, NO refactoring
Phase 3: Verify
- [ ] Test fix locally
- [ ] Confirm original issue resolved
- [ ] Check for obvious regressions
Phase 4: Create PR
- [ ] Push branch:
git push -u origin HEAD - [ ] Create PR to main with HOTFIX label:
gh pr create --base main --title "HOTFIX: <summary>" --label hotfix - [ ] Request expedited review
Phase 5: Alert Team
Generate urgent Slack message:
:rotating_light: **HOTFIX: [Issue Summary]**
**Impact:** [What was broken]
**Fix:** [What was changed]
:github: PR: [link]
:notion: Incident: [link if exists]
Requesting expedited review from: @[reviewer]
After Merge
- [ ] Merge main back to develop:
git checkout develop && git merge main - [ ] Create incident report in Notion (if major)