/hotfix

name: hotfix
description: Expedited workflow for urgent production issues

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

1. **Branch** - Create hotfix branch from main 2. **Fix** - Implement minimal fix 3. **Verify** - Test fix works 4. **PR** - Create with HOTFIX label 5. **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)