hotfix

name	hotfix
description	Record lightweight hotfixes. Use for one-line fixes that don't warrant light-workflow. Invoke with /hotfix "description" to create, or /hotfix H001 to update.

Hotfix Skill

Purpose

Record lightweight one-line fixes that don't warrant full light-workflow or regressing treatment. Hotfixes are already applied when recorded — this skill captures what was broken, what was changed, and how it was verified.

---

Mode A: Create Mode — /hotfix "description"

Step 1: Ensure Infrastructure

Check if .crabshell/hotfix/ exists. If not, create it. Check if .crabshell/hotfix/INDEX.md exists. If not, create it with header:

# Hotfix Index

| ID | Title | Status | Date |
|----|-------|--------|------|

Step 2: Determine Next H{NNN} ID

Glob .crabshell/hotfix/H*.md filenames. Find the highest existing number. Next ID = that number + 1, zero-padded to 3 digits. If no H-pages exist, start at H001.

Step 3: Generate Slug

Convert the description to a lowercase-hyphenated slug (strip special characters, max 40 chars).

Step 4: Create Hotfix Document

Write .crabshell/hotfix/H{NNN}-{slug}.md with this content:

---
type: hotfix
id: H{NNN}
title: "{description}"
status: done
created: {YYYY-MM-DD}
tags: []
---

# H{NNN} — {description}

## Problem
{1-2 sentences: what was broken}

## Fix
{what was changed and where — file:line reference}

## Verification
{how it was verified — command output or observation}

## Log
### [{YYYY-MM-DD HH:MM}] Created
{creation context}

Fill in Problem, Fix, and Verification from context. If context is insufficient, use placeholder text and inform the user to update.

Step 5: Update INDEX.md

Append a new row to .crabshell/hotfix/INDEX.md:

| [[H{NNN}-{slug}|H{NNN}]] | {description} | done | {YYYY-MM-DD} |

Step 6: Report

State the created file path, ID, and title. Document-first: the file write in Steps 4-5 is the primary output.

---

Mode B: Update Mode — /hotfix H001

Step 1: Find Document

Glob .crabshell/hotfix/H{NNN}-*.md matching the given ID. If not found, list available IDs from INDEX.md.

Step 2: Read Document

Read the full content and display it.

Step 3: Append Log Entry

Append a new log entry under the ## Log section:

### [{YYYY-MM-DD HH:MM}] Updated
{update context from user}

---

Design Principles

• Status defaults to done — hotfixes are already applied when recorded.
• No agents, no review cycle — just record what happened.
• Minimal template — 4 sections only (Problem, Fix, Verification, Log).
• Document-first — write to file before reporting in conversation.