project-surgeon

What problem does it solve?

project-surgeon helps you safely take over an existing codebase by deeply analyzing and auditing it before making carefully planned, test-preserving improvements.

Core Features & Use Cases

• 4-phase governed runtime (read-only to start): analysis → review → planning → execution, with explicit user approval gates and no skipping phases.
• 7-dimension code review (Bug Fixer protocol reuse): systematically catalog security, logic, resource, performance, error handling, dependency, and consistency issues without fixing during the review phase.
• Disk-persisted reports + session resume: writes analysis and review reports to disk and maintains workflow state for reliable continuation.
• Risk-prioritized execution plan: converts selected findings into phased tasks organized by risk/priority to stabilize first, refactor next, and harden production readiness.
• Regression protection via Preservation Gate: runs the test suite before/after each task, auto-reverts on new failures, and uses a 3-Strike recovery path for errors.

Quick Start

Run project-surgeon on your existing project directory (for example, your workspace root) and ask it to take over the codebase for refactoring and comprehensive quality auditing.