The Rewrite Plan skill enables developers to generate a comprehensive and structured plan for rewriting code across multiple files. This skill is particularly useful in scenarios where a systematic approach is required to ensure that code modifications are made safely and with clear ownership delineation. By producing a detailed audit trail, the skill helps maintain code integrity throughout the editing process, preventing the common pitfalls associated with large-scale refactoring efforts.

When utilizing this skill, users provide specific inputs such as the project’s design system and a brief outlining their intent for the rewrite. The skill then outputs a set of files, including a human-readable narrative (plan.md), an ownership classification (ownership.json), and an ordered list of steps (steps.json) that detail the necessary modifications. Each step includes a rationale and an associated risk level, ensuring that developers can prioritize their work effectively and avoid unnecessary disruptions to the codebase.

This skill is designed for teams working on complex projects where multiple contributors are involved. It ensures that everyone understands which parts of the code they are responsible for, thereby reducing the risk of conflicts and errors during the editing process. The structured output also aids in tracking progress and facilitates better communication among team members.

In summary, the Rewrite Plan skill is an essential tool for developers looking to implement a methodical approach to code rewrites. It not only helps in organizing the workflow but also ensures that the resulting changes are manageable and reviewable, ultimately leading to a more stable codebase.