hotfix

Creates emergency hotfix branches with audit records, approvals, and rollback plans.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Critical production bugs cannot wait for the normal sprint cycle, but rushing a fix without process creates untracked changes and regressions. This Skill provides a structured emergency workflow that fixes the issue fast while preserving a full audit trail. ## Core Features & Use Cases - Severity Triage: Classifies bugs as S1 (critical) or S2 (major) and redirects lower-severity issues to the normal bug fix workflow. - Documented Hotfix Records: Creates a hotfix record in production/hotfixes/ capturing problem, root cause, fix, testing, approvals, and rollback plan. - Approval Workflow: Collects sign-off from lead-programmer, qa-tester, and producer subagents before deployment. - Use Case: A game-breaking crash is reported on the release build. Invoke the hotfix workflow to create a hotfix branch from the release tag, implement the minimal fix, document the root cause, and route approvals before merging back to both release and development branches. ## Quick Start Run /hotfix with a bug ID or description, such as asking to hotfix the save-file corruption crash reported in issue 142.

Frequently Asked Questions about hotfix

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

FAQPage Schema
How do I create an emergency hotfix for a production bug?

Invoke the hotfix workflow with a bug ID or description. It assesses severity, creates a hotfix record in production/hotfixes/, branches from the release tag, implements the minimal fix, and collects approvals before deployment.

What severity levels qualify for a hotfix workflow?

Only S1 (critical: game unplayable, data loss, security vulnerability) and S2 (major: significant feature broken with workaround) qualify. S3 or lower severity issues are redirected to the normal bug fix workflow.

Does a hotfix branch merge back into the development branch?

Yes, hotfix branches merge to both the release branch and the development branch. This ensures the fix is not lost when future development continues from the main development line.

When should I not use the hotfix workflow?

Avoid it for low-severity bugs that can wait for the normal sprint cycle, and for fixes requiring more than 4 hours of work. Complex fixes should be escalated to the technical-director for a scope decision instead.

What approvals are required before deploying a hotfix?

Three approvals are required: the lead-programmer reviews fix correctness and side effects, the qa-tester runs targeted regression tests, and the producer approves deployment timing and communication.