From superpowers-plus
Enforces hotfix charter discipline: requires symptom statement, LOC budget, and code review battery on staged diff before first commit on hotfix/* and fix/<TICKET-ID>-* branches. Prevents runaway hotfixes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/superpowers-plus:hotfix-charterThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **Wrong skill?** Branch-naming sanity check → `git-branch-conventions`. Lint/test/IP gate at commit time → `unified-commit-gate`. Per-commit size cap → `pre-push-loc-gate` (`tools/pre-push-loc-gate.sh`). Adversarial code review → `code-review-battery`.
Wrong skill? Branch-naming sanity check →
git-branch-conventions. Lint/test/IP gate at commit time →unified-commit-gate. Per-commit size cap →pre-push-loc-gate(tools/pre-push-loc-gate.sh). Adversarial code review →code-review-battery.
2026-06-10 incident calibration: incident-2026-1507 MR grew to +8,750 / -4,195 LOC across 73 files on a hotfix branch because nobody captured the symptom upfront, set an LOC ceiling, or ran cr-battery on the staged diff before the first commit. This skill forces those three things at the moment the hotfix branch is created.
git checkout -b hotfix/... or git checkout -b fix/<TICKET-ID>-... (NOTE: only fix/<TICKET-ID>- prefix gates; generic fix/anything branches do NOT trigger the charter requirement -- those are feature work and run through branch-flow-gate instead)branch-flow-gate, unified-commit-gate).The hotfix MUST start with a HOTFIX-CHARTER.md file at the repo root containing exactly these three sections:
## Symptom (one sentence)
(What the customer sees. NOT what's broken in the architecture, NOT what
you'd ideally redesign. The observable bug: "Greeting clips at 700ms on
Azure-via-failover path.")
## Diff budget (LOC ceiling)
(An integer. The smallest change that fixes the symptom. incident-2026-1507 minimum
was ~80 LOC; the broken MR shipped at 12,945 LOC because nobody set
this number upfront. Examples: `80`, `200`, `500`. Anything > 500 needs
explicit PM sign-off in this section.)
## cr-battery pre-commit verdict
(Result of running cr-battery on the STAGED diff BEFORE the first commit
on this branch. Must be PASS or PASS_WITH_NITS at the project's quality
floor. The hook below refuses commits if this section reads anything else.
Re-run cr-battery and update this section if the staged diff changes.)
The pre-commit hook at tools/hotfix-charter-check.sh (wire into .git/hooks/pre-commit) reads the current branch name and, if it matches hotfix/* or fix/<TICKET-ID>-*:
HOTFIX-CHARTER.md exists at the repo rootPASS or PASS_WITH_NITSALLOW_NO_CHARTER=1 git commit ... (prints WARNING)Exit codes:
This skill runs FIRST (order: -10), then unified-commit-gate (order: 0) handles lint/test/review. hotfix-charter does NOT replace unified-commit-gate; it runs BEFORE it.
On the FIRST turn after git checkout -b hotfix/... or git checkout -b fix/<TICKET-ID>-...:
If diff grows past budget: update budget with reason or split into follow-up tickets.
npx claudepluginhub bordenet/superpowers-plus --plugin superpowers-plusGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.