sdd-hotfix

Implements post-merge bug fixes with TDD, code review, and conditional QA, security, and SRE reviews.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/asengardeon/btt-sdd-pipeline --skill sdd-hotfix-asengardeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-hotfix
Source: https://github.com/asengardeon/btt-sdd-pipeline/tree/main/.claude/skills/sdd-hotfix
Command: npx skills add https://github.com/asengardeon/btt-sdd-pipeline --skill sdd-hotfix-asengardeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a bug is found in production after a spec has already been merged, or a small improvement arrives with no originating spec, running the full PRD/TRD pipeline is overkill — but skipping rigor entirely is unacceptable. This Skill formalizes a lightweight hotfix path that keeps TDD, code review, and the relevant quality gates without generating product or architecture documents. ## Core Features & Use Cases - Scoped hotfix workflow: Creates a hotfix/<slug> or fix/<slug> branch from main, requires a GitHub issue before any branch exists, and opens a draft PR referencing it with Closes #N. - Objective review criteria: Code review always runs; QA runs when an acceptance criterion exists; security runs when the diff touches auth, sessions, or sensitive data; SRE runs only on infrastructure, CI/CD, or dependency changes. - In-place artifact updates: Review artifacts (code-review.md, qa-report.md, etc.) are edited in the related spec directory with a hotfix-<date> history line, or in a dedicated spec directory when no origin spec exists. - Use Case: A production login bug is reported two weeks after its feature shipped. Use this Skill to create the issue, branch, failing test, fix, and run code review plus security review — all recorded against the original spec. ## Quick Start Use the sdd-hotfix skill to fix the production bug where session tokens expire prematurely, starting from a GitHub issue and following TDD.

Frequently Asked Questions about sdd-hotfix

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

FAQPage Schema
How do I fix a production bug after its spec was already merged?▼

Use the hotfix workflow: confirm or create a GitHub issue, branch from main as hotfix/<slug> or fix/<slug>, implement with strict TDD, and run code review plus any applicable QA, security, or SRE reviews. Review artifacts are updated in-place in the related spec directory with a hotfix-<date> history line.

When should I use a hotfix instead of the full PRD/TRD pipeline?▼

Use a hotfix for a specific production bug or a small low-risk improvement with no originating spec. If the change introduces new acceptance criteria, significant architecture decisions, or more than one slice of effort, it is a feature and should go through the normal PRD pipeline instead.

Which reviews are required for a hotfix?▼

Code review is always mandatory. QA runs when there is a concrete acceptance criterion to validate, security runs when the diff touches authentication, sessions, or sensitive data, and SRE runs only for infrastructure, CI/CD, or dependency changes. Skipped reviews must be recorded with justification.

Can a hotfix proceed without a GitHub issue or remote?▼

No. A GitHub issue is a mandatory gate — the workflow stops before branch creation if no authenticated GitHub remote is configured, and every hotfix PR must reference its issue with Closes #N. There is no no-GitHub alternative for hotfixes.

What happens if a hotfix grows in scope during implementation?▼

If the correction grows in scope or risk mid-execution, stop and migrate to the full spec-driven pipeline rather than continuing as a hotfix. The hotfix path is only for changes concrete enough to skip PRD and TRD without skipping rigor.