Task: Implement Hotfix handling

Table of Contents

This page documents a task in the Hotfix handling story. It captures the goal, current status, acceptance, and any notes or results.

Goal

Produce three artefacts:

  1. doc/llm/runbooks/hotfix/runbook.org — a step-by-step hotfix runbook (extract error → fetch main → create hotfix/ branch → scaffold story/task → diagnose/fix → commit/push/PR). References How do I start a new feature branch phase? for branch mechanics and How do I start a unit of work with compass? for scaffolding.
  2. Updated How do I start a new feature branch phase? — adds hotfix/<description> to the * Conventions section and a short note distinguishing hotfix branches from feature branches.
  3. Updated v2_doc_sprint.org.mustache — adds a ** Hotfixes section at the end of * Stories, before * Health Review.

Status

Field Value
State DONE
Parent story Hotfix handling
Now Nothing.
Waiting on Nothing.
Next Nothing.
Last touched 2026-05-28

Acceptance

  • Runbook file exists at doc/llm/runbooks/hotfix/runbook.org.
  • Runbook references the branching recipe and compass scaffold recipe by [[id:UUID]] link.
  • Branching recipe * Conventions section lists hotfix/<description>.
  • Sprint template has ** Hotfixes section with table scaffold.

Plan

  1. Scaffold runbook with compass add runbook --slug hotfix.
  2. Fill runbook body with the hotfix procedure steps.
  3. Edit branching recipe to add hotfix convention.
  4. Edit sprint template to add ** Hotfixes section.

Notes

PRs

PR Title
#899 [agile] Add hotfix handling runbook and conventions

Review

# Comment summary File Decision Notes
1 Hardcoded SSH_AUTH_SOCK in step 2 hotfix/runbook.org Fixed Removed; preconditions reference SSH memory
2 Contradiction: hotfix/ convention vs feature/hotfix- output hotfix/runbook.org Fixed Clarified feature/hotfix- is the convention; recipe updated
3 Hardcoded SSH_AUTH_SOCK in step 11; wrong branch name hotfix/runbook.org Fixed Removed SSH export; push uses feature/hotfix-<thing>

Result

Emacs 29.1 (Org mode 9.6.6)