Software_development_department hotfix
install
source · Clone the upstream repo
git clone https://github.com/tranhieutt/software_development_department
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/tranhieutt/software_development_department "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/hotfix" ~/.claude/skills/tranhieutt-software-development-department-hotfix && rm -rf "$T"
manifest:
.claude/skills/hotfix/SKILL.mdsource content
When this skill is invoked:
Explicit invocation only: This skill should only run when the user explicitly requests it with
. Do not auto-invoke based on context matching./hotfix
-
Assess the emergency — Read the bug description or ID. Determine severity:
- S1 (Critical): Product unplayable, data loss, security vulnerability — hotfix immediately
- S2 (Major): Significant feature broken, workaround exists — hotfix within 24 hours
- If severity is S3 or lower, recommend using the normal bug fix workflow instead
-
Create the hotfix record at
:production/hotfixes/hotfix-[date]-[short-name].md## Hotfix: [Short Description] Date: [Date] Severity: [S1/S2] Reporter: [Who found it] Status: IN PROGRESS ### Problem [Clear description of what is broken and the user impact] ### Root Cause [To be filled during investigation] ### Fix [To be filled during implementation] ### Testing [What was tested and how] ### Approvals - [ ] Fix reviewed by lead-programmer - [ ] Regression test passed (qa-tester) - [ ] Release approved (producer) ### Rollback Plan [How to revert if the fix causes new issues] -
Create the hotfix branch (if git is initialized):
git checkout -b hotfix/[short-name] [release-tag-or-main] -
Investigate and implement the fix — Focus on the minimal change that resolves the issue. Do NOT refactor, clean up, or add features alongside the hotfix.
-
Validate the fix — Run targeted tests for the affected system. Check for regressions in adjacent systems.
-
Update the hotfix record with root cause, fix details, and test results.
6b. Collect approvals — Use the Task tool to request sign-off:
— Review the fix for correctness and side effectssubagent_type: lead-programmer
— Run targeted regression tests on the affected systemsubagent_type: qa-tester
— Approve deployment timing and communication plansubagent_type: producer
- Output a summary with: severity, root cause, fix applied, testing status, and what approvals are still needed before deployment.
Rules
- Hotfixes must be the MINIMUM change to fix the issue — no cleanup, no refactoring, no "while we're here" changes
- Every hotfix must have a rollback plan documented before deployment
- Hotfix branches merge to BOTH the release branch AND the development branch
- All hotfixes require a post-incident review within 48 hours
- If the fix is complex enough to need more than 4 hours, escalate to technical-director for a scope decision
Protocol
- Question: Confirms severity (S1/S2 = proceed; S3+ = defer to normal workflow)
- Options: Skip — severity drives path
- Decision: User approves fix approach before implementation begins
- Draft: Hotfix summary shown before committing fix
- Approval: "May I write to
?"production/hotfixes/hotfix-[date]-[name].md
Output
Deliver exactly:
- Hotfix summary: severity, root cause (1 sentence), fix applied, files changed
- Rollback plan: documented steps to revert if the fix causes regressions
- Approvals needed: list of sign-offs still outstanding before deployment
- Post-incident review: scheduled within 48 hours (link to
)/postmortem-writing