hotfix

Coordinate emergency Git-based hotfixes with severity checks and QA approval gates.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill hotfix-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hotfix
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/hotfix
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill hotfix-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The hotfix workflow resolves urgent production bugs by forcing a disciplined process—severity assessment, traceable records, controlled branching, approvals, QA gates, and post-deploy verification—so critical issues get fixed fast without destabilizing the game.

Core Features & Use Cases

  • Severity triage and workflow routing: Classifies issues as S1/S2 or S3-and-below, confirming whether to bypass normal sprint processes.
  • Audit-tracked hotfix documentation: Creates a structured hotfix record including problem, root cause, fix, testing, approvals, and rollback plan.
  • Controlled implementation with QA re-entry gate: Coordinates approvals from lead-programmer, qa-tester, and producer, then determines the required QA scope (smoke check vs targeted team-qa vs full QA) before deployment.
  • Backed-by-deploy verification: Updates bug status, deploys via merges to both release and development branches, and verifies in the deployed build before closing the incident.

Quick Start

Use /hotfix with the bug-id or a clear description of what is broken so the team can assess severity and start an emergency fix workflow.

Frequently Asked Questions about hotfix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage an emergency hotfix workflow for a critical production bug?

An emergency hotfix workflow assesses incident severity, creates a traceable record, and coordinates approvals with rollback planning. You start by confirming severity to bypass normal sprint processes, then branch from a chosen base ref for minimal-change implementation.

When do I need to bypass normal development cycles for an urgent git branching hotfix?

You need an urgent git branching hotfix when a production incident requires fast remediation. The workflow classifies issues as S1/S2 or S3-and-below, confirming whether to bypass normal sprint processes for critical game-breaking bugs.

How does incident response handle QA gates and deployment verification for production fixes?

Incident response determines required QA scope—smoke check, targeted team-qa, or full QA—based on code touchpoints. Deployment verification involves merging to release and development branches, then verifying the fix in the deployed build before closing the incident.

Can I use parallel approval workflows for incident response without destabilizing the game?

Yes, the incident response workflow coordinates parallel approvals from lead-programmer, qa-tester, and producer. This ensures critical issues get fixed fast with rollback planning and post-deploy verification without destabilizing the game.

What's the best way to document a rollback plan during a severity triage hotfix?

The best way is creating an audit-tracked hotfix record that includes problem, root cause, fix, testing, approvals, and rollback plan. This structured documentation is generated during severity triage and maintained throughout the emergency fix workflow.

Does the hotfix workflow require explicit user invocation and write access to git branch creation?

Yes, the hotfix workflow requires explicit user invocation and severity confirmation via AskUserQuestion. Git branch creation is guarded by user approval, and write access to hotfix record paths is required to maintain audit-tracked documentation.