About surgical-patch
surgical-patch is a development skill for fixing failures with the narrowest change that addresses the responsible mechanism. It preserves unrelated behavior and user changes, then stops after focused regression proof passes.
Key features
- 01Reproduce failures when economical
- 02Trace symptoms to their responsible mechanism
- 03Change only the layer owning the behavior
- 04Preserve unrelated behavior and user changes
- 05Run focused regression proof and nearest gate
Use cases
- 01Applying a narrowly scoped defect fix
- 02Adding regression proof for a specific failure
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/surgical-patchin Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMESurgical patch
Reproduce failure first when economical; otherwise capture strongest available evidence.
- Trace symptom to responsible mechanism.
- Change narrowest layer that owns incorrect behavior.
- Preserve unrelated behavior and user changes.
- Avoid cleanup, renaming, and abstraction outside fix.
- Add only regression proof relevant to task.
Run focused proof plus nearest affected gate. Stop when failure is fixed and regression proof passes.
Comments
Markdown supported