Incident Hotfix Skill
[!IMPORTANT]
Mitigate a production incident or urgent regression first, then route to root-cause remediation and a postmortem.
Optional args: slug=, ticket=<id/url>, mode=interactive|autonomous|channel, channel=, auto_continue=true|false, profile=business|hybrid|technical.
Instructions
When the user asks to perform this workflow, execute the following steps:
Incident Hotfix Workflow
Goal: Stop user-facing harm immediately, then hand off to root-cause discipline instead of debugging live.
Steps
- Triage:
- Severity, blast radius, affected environments/markets, and whether the regression is a rollback candidate.
- Load the prior deployment report and rollback path when present; absent a prior verified artifact, record that no rollback target exists instead of assuming one.
- Mitigate first:
- This workflow owns the mitigation choice and its authorization. Prefer rollback, feature flag disable, or config revert over a live code fix, and obtain the human approval grant bound to that fixed action set, target, artifact, and expiry.
- Execute the granted mitigation through
common-devops-operations (operation=recover): it runs preflight and the fixed grant, verifies restoration outward, and returns once here. A fixed restore of an identified prior verified artifact stays recovery; a fresh build is release work for deploy-release.
- Confirm mitigation stopped user-facing harm before investigating root cause. Do not attempt a root-cause code fix under live production pressure.
- Stabilize:
- Monitor logs, metrics, errors, and core user flows until signals return to baseline; missing telemetry is not recovery.
- Record mitigation timestamp, owner, and evidence.
- Route to remediation:
- Once stable, hand off to
dev-fix for root-cause debugging under the normal Propose -> Approve -> Verify cycle.
- Do not skip
dev-fix's root-cause-before-code requirement just because mitigation already shipped.
- Route to learning:
- After
verify-work confirms the permanent fix, route to retro-learn for a postmortem.
- The confirmed root cause becomes a permanent eval case in the skill or workflow that should have prevented it.
Runtime Contract
- Use only for production incidents or urgent regressions with active user-facing harm; non-urgent bugs go directly to
dev-fix.
- Required inputs: incident signal (alert, report, or error spike) plus a proposed mitigation path (rollback, flag, or config revert).
- Block the mutation — while continuing safe scoped analysis and escalation — when identity is unresolved, organizational authority or an unexpired approval grant is missing, the required MCP capability is absent or disconnected, the grant is expired or revoked, or host enforcement of the approved scope cannot be verified. Never invent an emergency exception, self-approve, broaden a role, or retry an uncertain write without reconciling state.
- Security-forensic and containment work retains
cyber-triage authority and custody requirements.
- Route from the actual outcome: stable and ready for root-cause work ->
dev-fix; blocked, unstable, or unresolved -> recommended_next_workflow: null with the pending action in next_action, never a default fix handoff.
- Preserve the prior evidenced lifecycle; an incident receipt is an operations result, not a release or rollback record, and it never advances or downgrades
feature_status.
Handoff Payload
slug, operator_profile (carried, not re-inferred), severity, classified mitigation effect, mitigation applied, stabilization evidence, operations report, outcome report, next_action, next workflow.
Blocking Questions
- Ask max 3 at a time with a recommended default and 2-3 options.
Output Template
# Incident Hotfix: [Name]
## Severity And Blast Radius
## Mitigation Applied
- Effect class: [recover | deploy_bearing]; authority: [owner/ref @ expiry]; target/artifact: [scope]
## Stabilization Evidence
| Signal | Before | After |
| --- | --- | --- |
| [signal] | [value] | [value] |
## Blocked Or Refused Actions
- [action] — [reason code]
## Root Cause Handoff
<!-- Emit the record below only for feature-linked work, replacing `feature_status` with the prior evidenced value; omit it when lifecycle is unknown. Choose routing from the actual outcome; a blocked or unstable incident uses `null` and records the pending action in `next_action`. -->
## Outcome Report
{schema_version: 1, run_id: "[run-id]", slug: "[slug]", workflow: incident-hotfix, feature_status: partially_implemented, started_at: "[timestamp]", completed_at: "[timestamp]", requirement_trace: {brd_objectives: [], requirements: [], acceptance_criteria: [], srs: []}, completed_evidence: [], missing_evidence: [], decision_needed: [], recommended_next_workflow: dev-fix, cost: {source: unavailable}, agent: {identity: "[agent-identity]", model: "[model]"}}
## Next Workflow
dev-fix | verify-work | retro-learn
- Blocked or unstable: `recommended_next_workflow: null`
## Cost Report
Call `get_session_cost(workflow="incident-hotfix")` before final handoff.
1---2name: incident-hotfix3description: "Mitigate a production incident or urgent regression first, then route to root-cause remediation and a postmortem."4metadata:5 source: https://skillmd.com/skills/hoangnguyen0403/incident-hotfix6 internal: true7 triggers:8 keywords:9 - incident hotfix10 - workflow11---1213# Incident Hotfix Skill1415> [!IMPORTANT]16> Mitigate a production incident or urgent regression first, then route to root-cause remediation and a postmortem.1718Optional args: slug=<feature>, ticket=<id/url>, mode=interactive|autonomous|channel, channel=<id>, auto_continue=true|false, profile=business|hybrid|technical.1920## Instructions2122When the user asks to perform this workflow, execute the following steps:232425# Incident Hotfix Workflow2627Goal: Stop user-facing harm immediately, then hand off to root-cause discipline instead of debugging live.2829## Steps30311. Triage:32 - Severity, blast radius, affected environments/markets, and whether the regression is a rollback candidate.33 - Load the prior deployment report and rollback path when present; absent a prior verified artifact, record that no rollback target exists instead of assuming one.342. Mitigate first:35 - This workflow owns the mitigation choice and its authorization. Prefer rollback, feature flag disable, or config revert over a live code fix, and obtain the human approval grant bound to that fixed action set, target, artifact, and expiry.36 - Execute the granted mitigation through `common-devops-operations` (`operation=recover`): it runs preflight and the fixed grant, verifies restoration outward, and returns once here. A fixed restore of an identified prior verified artifact stays recovery; a fresh build is release work for `deploy-release`.37 - Confirm mitigation stopped user-facing harm before investigating root cause. Do not attempt a root-cause code fix under live production pressure.383. Stabilize:39 - Monitor logs, metrics, errors, and core user flows until signals return to baseline; missing telemetry is not recovery.40 - Record mitigation timestamp, owner, and evidence.414. Route to remediation:42 - Once stable, hand off to `dev-fix` for root-cause debugging under the normal Propose -> Approve -> Verify cycle.43 - Do not skip `dev-fix`'s root-cause-before-code requirement just because mitigation already shipped.445. Route to learning:45 - After `verify-work` confirms the permanent fix, route to `retro-learn` for a postmortem.46 - The confirmed root cause becomes a permanent eval case in the skill or workflow that should have prevented it.4748## Runtime Contract49- Use only for production incidents or urgent regressions with active user-facing harm; non-urgent bugs go directly to `dev-fix`.50- Required inputs: incident signal (alert, report, or error spike) plus a proposed mitigation path (rollback, flag, or config revert).51- Block the mutation — while continuing safe scoped analysis and escalation — when identity is unresolved, organizational authority or an unexpired approval grant is missing, the required MCP capability is absent or disconnected, the grant is expired or revoked, or host enforcement of the approved scope cannot be verified. Never invent an emergency exception, self-approve, broaden a role, or retry an uncertain write without reconciling state.52- Security-forensic and containment work retains `cyber-triage` authority and custody requirements.53- Route from the actual outcome: stable and ready for root-cause work -> `dev-fix`; blocked, unstable, or unresolved -> `recommended_next_workflow: null` with the pending action in `next_action`, never a default fix handoff.54- Preserve the prior evidenced lifecycle; an incident receipt is an operations result, not a release or rollback record, and it never advances or downgrades `feature_status`.55## Handoff Payload56- `slug`, `operator_profile` (carried, not re-inferred), severity, classified mitigation effect, mitigation applied, stabilization evidence, operations report, outcome report, `next_action`, next workflow.57## Blocking Questions58- Ask max 3 at a time with a recommended default and 2-3 options.5960## Output Template6162```md63# Incident Hotfix: [Name]6465## Severity And Blast Radius6667## Mitigation Applied68- Effect class: [recover | deploy_bearing]; authority: [owner/ref @ expiry]; target/artifact: [scope]6970## Stabilization Evidence7172| Signal | Before | After |73| --- | --- | --- |74| [signal] | [value] | [value] |7576## Blocked Or Refused Actions77- [action] — [reason code]7879## Root Cause Handoff8081<!-- Emit the record below only for feature-linked work, replacing `feature_status` with the prior evidenced value; omit it when lifecycle is unknown. Choose routing from the actual outcome; a blocked or unstable incident uses `null` and records the pending action in `next_action`. -->8283## Outcome Report84{schema_version: 1, run_id: "[run-id]", slug: "[slug]", workflow: incident-hotfix, feature_status: partially_implemented, started_at: "[timestamp]", completed_at: "[timestamp]", requirement_trace: {brd_objectives: [], requirements: [], acceptance_criteria: [], srs: []}, completed_evidence: [], missing_evidence: [], decision_needed: [], recommended_next_workflow: dev-fix, cost: {source: unavailable}, agent: {identity: "[agent-identity]", model: "[model]"}}8586## Next Workflow87dev-fix | verify-work | retro-learn88- Blocked or unstable: `recommended_next_workflow: null`8990## Cost Report91Call `get_session_cost(workflow="incident-hotfix")` before final handoff.92```93