project-surgeon-bug-fixer

Review code across seven dimensions and apply user-approved bug fixes.

65|8|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/EasyCode-Obsidian/workflow-architect --skill project-surgeon-bug-fixer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-surgeon-bug-fixer
Source: https://github.com/EasyCode-Obsidian/workflow-architect/tree/main/claude/skills/project-surgeon-bug-fixer
Command: npx skills add https://github.com/EasyCode-Obsidian/workflow-architect --skill project-surgeon-bug-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you find and fix real defects in your code through a structured review process, preventing silent failures and risky “guess-and-fix” changes.

Core Features & Use Cases

  • 7-Dimension Code Audit: Systematically reviews security, logic errors, concurrency issues, performance issues, error handling, dependency risks, and consistency.
  • Safe Fix Workflow (No Fix Without Approval): Presents findings first, applies only user-approved fixes, and runs verification after each change.
  • Standalone or Integrated with Project-Surgeon: Works alone on a target (file/directory/bug description) or integrates with project-surgeon execution states like 3-Strike escalation and milestone checkpoints.
  • Report Persistence & Traceability: Produces structured review reports and (in integrated mode) stores them under the project-surgeon workflow folder.

Quick Start

Use the skill to review and fix bugs in a specific target by invoking it with the argument "src/server.js".

Frequently Asked Questions about project-surgeon-bug-fixer

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

FAQPage Schema
How do I perform a systematic code review to find security and logic bugs?

A systematic code review audits security, logic errors, concurrency, performance, error handling, dependency risks, and consistency. It identifies real defects, presents findings, and runs verification after applying approved fixes to prevent regressions.

How do I fix bugs without causing regressions in my codebase?

Prevent regressions by using a safe fix workflow that requires explicit approval before applying any changes. It runs verification after each fix to ensure the defect is resolved without introducing new failures.

What is the best way to audit dependency risks and error handling in a specific file?

Target a specific file or directory to audit dependency risks and error handling. The process evaluates consistency and concurrency issues, then generates a structured report of all findings for traceability before any changes are applied.

Can I integrate a bug fixing workflow into milestone checkpoints or escalation triggers?

Yes, bug fixing workflows can integrate into milestone checkpoints and 3-Strike escalation triggers. It operates standalone on a bug description or integrates with project workflows, storing structured review reports under designated workflow folders for traceability.

Does the code review process apply fixes automatically without user confirmation?

No, the code review process strictly requires user confirmation before applying any targeted fixes. It ensures you maintain control over all changes and prevents risky guess-and-fix modifications to your codebase.