salvage-project

Overview

This skill is designed to help developers start over with a project that has gone down the wrong path, whether due to an incorrect tech stack, over-engineering, or incomplete requirements. It guides the user through a structured process of identifying the real requirements, extracting genuine behavior from the existing code, and creating a portable spec bundle that can be used to rebuild the project on a simpler and more maintainable stack. The skill also includes a safety check to ensure that the new project is built from scratch, avoiding accidental overwrites of existing code.

Capabilities

• ▸Recover real requirements from a broken project
• ▸Create a portable spec bundle for rebuilding
• ▸Detect and handle existing salvage bundles
• ▸Guide through a structured process of simplification
• ▸Ensure no code is written until the final stage

Best for

Use this skill when a project has become too complex, is built on an incorrect stack, or has incomplete requirements. It is also useful when a developer wants to start fresh but retain the knowledge gained from the previous project. The skill is particularly helpful in scenarios where a project needs to be rebuilt from a spec bundle, ensuring that the new build is aligned with the original intent but simplified.

Works with

Security considerations

The skill does not execute code, make network calls, or handle sensitive data. It operates entirely within the project directory and relies on user input and confirmation at each stage to ensure safety.

Categories