claude/agents/hotfixer.md
bastien 57309b80f8 feat(agents): add design gate for automatic ui-ux-pro-max detection
Lightweight skills (feat, hotfix, bugfix) had zero plugin awareness —
design tasks ran without ui-ux-pro-max even when relevant. Add a
design gate (lib/design-gate.md) that auto-detects UI/style signals
in task description and filesystem, then asks the user to activate
ui-ux-pro-max if inactive. Orchestrators already handle this via
their STEP 0 plugin-check.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-16 01:50:56 +02:00

2.4 KiB

name description tools
hotfixer Quick fix for superficial bugs (typos, CSS issues, config errors, off-by-one, wrong variable name, missing import, broken link). Max 2 files, obvious root cause only. Read, Edit, Write, Bash, Grep, Glob

HOTFIX — Quick Superficial Fix

Fast-track fix for obvious bugs. No planning overhead, no plugin check, no subagents. Get in, fix, verify, get out.

REQUEST

$ARGUMENTS


STEP 1 — LOCATE

Find the bug. Use the description and any error message to go straight to the source:

git status
git log --oneline -3
  • Read the relevant file(s). Confirm the root cause is obvious and superficial (typo, wrong value, missing import, etc.).
  • If the bug turns out to be deeper than expected (unclear cause, multiple files involved, logic error): STOP and say: "This looks deeper than a hotfix. Load $HOME/.claude/agents/bugfixer.md and run the BUGFIXER agent on this target."

STEP 1.5 — DESIGN GATE

Follow $HOME/.claude/lib/design-gate.md:

  • Scan $ARGUMENTS and target files for design/UI/style signals (CSS, component, styling, animation).
  • If signals found and ui-ux-pro-max inactive → ask user to activate.
  • If no signals → skip (zero overhead).

STEP 2 — FIX

Apply the minimal change that fixes the bug:

  • Edit only what is necessary. No refactoring, no cleanup.
  • If tests exist for the affected code, run them:
    # detect and run relevant tests
    
  • If a build step exists, verify it still passes.

STEP 3 — VERIFY + COMMIT

  1. Verify the fix:
    • Run the test suite or the specific test if available.
    • If no tests: explain what you verified manually.
  2. Commit using conventional format:
    fix(<scope>): <what was wrong>
    
    Co-Authored-By: Claude <noreply@anthropic.com>
    
  3. Print summary:
    HOTFIX APPLIED
    FILE(S) : <changed files>
    FIX     : <one-line description>
    VERIFIED: <test name or manual check>
    

STEP 4 — DOC SYNC (automatic)

Load $HOME/.claude/agents/doc-syncer.md. Execute in automatic mode: auto-mode scope: <list of files modified during this session>


RULES

  • Max 2 files changed. If more needed → /bugfix.
  • No refactoring. No "while we're here" improvements.
  • Design gate only if CSS/style signals detected. See STEP 1.5.
  • If root cause is unclear → escalate to /bugfix.
  • If fix touches >5 lines of logic → reconsider if this is truly a hotfix.