patch-or-fix

Classify bug fixes as patches or root-cause fixes with documented rationale.

6|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/anotherben/claude-harness --skill patch-or-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: patch-or-fix
Source: https://github.com/anotherben/claude-harness/tree/main/skills/patch-or-fix
Command: npx skills add https://github.com/anotherben/claude-harness --skill patch-or-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Patches often address symptoms without addressing root causes. This Skill guides evaluators to determine when a patch is merely masking a failure and how to rewrite changes to fix the underlying issue, ensuring durable software quality.

Core Features & Use Cases

  • Root-cause analysis workflow: Systematically diagnose whether a change fixes the root cause or merely patches symptoms.
  • Structured fix documentation: Produce concrete, implementable fixes with real code changes and clear justification.
  • Code-review guidance: Provide a reproducible verdict that can be copied into PR notes and design reviews for faster approvals.

Quick Start

Provide a bug fix scenario and ask the skill to produce a real, deployable fix.

Frequently Asked Questions about patch-or-fix

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

FAQPage Schema
What is the difference between a patch and a root-cause fix in software engineering?

A patch masks failure symptoms without addressing the underlying issue, while a root-cause fix resolves the actual defect. Diagnosing this distinction requires evidence gathering and structured stepwise reasoning to ensure durable software quality and prevent recurring bugs.

How do I perform root-cause analysis for a bug fix during code review?

Perform root-cause analysis by systematically gathering evidence, diagnosing whether the change addresses the underlying defect or merely patches symptoms, and documenting structured fixes with clear justification to guide the code review process.

How do I document a bug fix verdict for a pull request?

Document a bug fix verdict by producing a reproducible output that classifies the change as a patch or root-cause fix, includes the diagnostic rationale, and provides concrete code changes to copy directly into PR notes for faster approvals.

Can I get deployable code changes instead of just diagnostic notes for a bug fix?

Yes, providing a bug fix scenario generates concrete, implementable fixes with real code changes and clear justification. The output is designed to be deployable rather than just offering diagnostic observations or theoretical recommendations.

When should I use a structured diagnosis workflow for software bug fixes?

Use a structured diagnosis workflow when evaluating pull requests or design reviews to ensure changes do not merely mask failures. It enforces explicit root-cause analysis across the development lifecycle to maintain durable software quality.