wf-patch

Executes a gated branch-and-merge ritual for small single-issue fixes and chores.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill wf-patch-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wf-patch
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded-rituals/plugins/wf-rituals/skills/wf-patch
Command: npx skills add https://github.com/23min/aiwf --skill wf-patch-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Small fixes like typos, config nudges, and one-line bug fixes often land as careless commits with no review, no regression test, and no audit trail. This Skill enforces a disciplined patch workflow so every minor change gets a dedicated branch, independent review, a CHANGELOG entry, and explicit human approval before commit, merge, and push. ## Core Features & Use Cases - Gated mutation workflow: Three explicit human approval gates (commit, wrap, push) plus a conditional correction gate ensure no commit, merge, promote, push, or branch deletion happens unprompted. - Independent review enforcement: Dispatches a fresh-context reviewer over the staged diff with a fingerprint check (git diff --cached) before and after dispatch, so subagent mutations cannot silently corrupt the commit. - Defect pinning and changelog discipline: Every defect fix lands with a regression test or gate rule, and every patch adds a CHANGELOG.md entry under ## [Unreleased], with named escapes stated at the commit gate. - Use Case: A user asks to fix a one-line bug tracked as gap G-0042. The Skill creates a patch/G-0042-fix-slug worktree branch, implements the fix with a regression test, runs the full local CI gate, obtains independent review, and walks through commit, merge, tracker closure (aiwf promote), cleanup, and push — each behind explicit approval. ## Quick Start Ask the assistant to run the wf-patch ritual to fix a specific small bug or typo on its own patch branch with review and approval gates.

Frequently Asked Questions about wf-patch

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

FAQPage Schema
How do I land a small bug fix with proper review and approval gates?

Use a patch workflow that cuts a dedicated branch from mainline in its own worktree, implements the fix with a regression test, runs the full local CI gate, and gets an independent reviewer to examine the staged diff. Commit, merge, and push each wait behind explicit human approval gates.

When should I use a patch workflow instead of a full milestone?

Use a patch when the change maps to one issue or a single-line summary, needs no spec or acceptance criteria, and lands in one merge to mainline. If unrelated changes get bundled, acceptance criteria emerge, or planning discussion starts, switch to a heavier milestone ritual.

Does every small fix need a regression test and CHANGELOG entry?

Yes. A defect fix lands with the check that pins it, such as a failing-without-the-fix regression test or lint rule, and every patch adds a CHANGELOG.md entry under Unreleased. The only escapes are stated explicitly at the commit gate so the human can veto them.

Why does the workflow forbid bundling commit, merge, and push approvals?

Bundling hides outward or irreversible actions inside routine approvals. The commit gate covers the reviewed diff, the wrap gate covers an enumerated merge-close-cleanup sequence, and the push gate always stands alone because pushing is the only action that leaves the machine.

What happens if the merge to mainline conflicts or the tracker closure fails?

Any deviation from the approved wrap sequence, such as a merge conflict, check finding, or dirty state, aborts the sequence and re-gates from the point of deviation. A refused tracker closure means the merge did not land on mainline, so reconcile and merge first rather than forcing past the guard.

What are the limitations of a lightweight patch workflow?

It does not write specs or acceptance criteria, run a full TDD cycle, or touch planning state and roadmaps. Changes needing test-first development escalate to a TDD cycle on the same branch, and patches stay off-roadmap by design except for closing the tracked item they fix.