speckit-hotfix
Speckit Hotfix Skill
The user input to you can be provided directly by the agent or as a command argument - you MUST consider it before proceeding with the prompt (if not empty).
User input:
$ARGUMENTS
The text the user typed after /speckit.hotfix in the triggering message is the incident description. Assume you always have it available in this conversation even if $ARGUMENTS appears literally below. Do not ask the user to repeat it unless they provided an empty command.
⚠️ EMERGENCY WORKFLOW - EXPEDITED PROCESS ⚠️
Given that incident description, do this:
-
Run the script
.specify/scripts/bash/create-hotfix.sh --json "$ARGUMENTS"from repo root and parse its JSON output for HOTFIX_ID, BRANCH_NAME, HOTFIX_FILE, POSTMORTEM_FILE, and TIMESTAMP. All file paths must be absolute. IMPORTANT You must only ever run this script once. The JSON is provided in the terminal as output - always refer to it to get the actual content you're looking for. -
Load
.specify/extensions/workflows/hotfix/hotfix-template.mdto understand required sections. -
Write the hotfix incident log to HOTFIX_FILE using the template structure:
- Fill incident timeline with TIMESTAMP from script output
- Assess severity from description (P0 = service down, P1 = major feature broken, P2 = workaround available)
- Describe the incident clearly
- Leave "Immediate Fix Applied" section empty (to be filled during planning)
- Leave root cause analysis preliminary (to be refined)
- Document impact assessment from description
-
Report completion with Next Steps:
⚠️ HOTFIX WORKFLOW INITIATED (EXPEDITED)
**Hotfix ID**: [HOTFIX_ID]
**Branch**: [BRANCH_NAME]
**Incident Time**: [TIMESTAMP]
**Severity**: [P0/P1/P2]
**Hotfix Report**: [HOTFIX_FILE]
📋 **Next Steps (URGENT):**
1. Review incident details and confirm severity
2. Notify stakeholders of incident status
3. Run `/speckit.plan` to create expedited fix plan
4. Run `/speckit.tasks` to create minimal task breakdown
5. Run `/speckit.implement` to apply hotfix immediately
⚠️ **Post-Deployment:**
- Monitor production after deployment
- Schedule post-mortem within 24-48 hours
- Create follow-up `/speckit.bugfix` for proper fix with tests
💡 **Note**: This is the ONLY workflow that permits test-after approach due to emergency
Note: Hotfix workflow bypasses normal TDD process due to emergency nature. Tests must be added AFTER fix is deployed. This is the ONLY workflow that permits this deviation from the constitution.
Next Steps
- Create Expedited Plan
- Break Down Into Tasks