wtf.hotfix

Create a hotfix branch from main with tests and open a PR.

7|2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/xiduzo/wtf --skill wtf-hotfix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wtf.hotfix
Source: https://github.com/xiduzo/wtf/tree/main/skills/wtf.hotfix
Command: npx skills add https://github.com/xiduzo/wtf --skill wtf-hotfix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a fast, controlled path to deliver emergency production fixes when the standard Epic→Feature→Task workflow would slow remediation, ensuring stability with a traceable, test-backed approach.

Core Features & Use Cases

  • Narrow, non-breaking hotfix scope focused on restoring production functionality with minimal risk.
  • Branch from main, implement the fix with tests, and open a PR back to main.
  • Maintains an auditable trail of issue references, changes, tests, and review decisions for fast postmortem analysis.

Quick Start

Create a hotfix branch from main, implement a narrow fix with tests, and open a PR back to main.

Frequently Asked Questions about wtf.hotfix

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

FAQPage Schema
How do I ship an emergency production hotfix without waiting for the full Epic and Feature workflow?

To ship an emergency production hotfix, you can bypass the standard Epic→Feature→Task workflow by branching directly from main, implementing a narrow fix with tests, and opening a PR back to main.

What is a hotfix branch in git and when should I use it for a production outage?

A hotfix branch is a targeted git branch created directly from main to address a critical production outage. You should use it when scope is narrow and restoring functionality quickly is more essential than following the full development workflow.

Do I need a steering document to create a targeted hotfix branch?

Yes, you need a verified steering document to create a targeted hotfix branch. The hotfix process requires this document alongside a main branch to maintain a deterministic path from bug identification to PR.

What is the best way to maintain an auditable trail for an emergency production fix?

The best way to maintain an auditable trail for an emergency production fix is to automate branch creation, testing, and PR preparation. This ensures issue references, changes, tests, and review decisions are recorded for fast postmortem analysis.

When should I avoid bypassing the standard workflow for a git branch?

You should avoid bypassing the standard workflow when the production issue is not an emergency or when the scope of the fix is broad. This approach requires a minimal change footprint to ensure stability and reduce risk during critical outages.