/clean-copy

name: clean-copy
description: Reimplement the current branch on a new branch with a clean, narrative-quality git commit history. Use when asked to make a clean copy branch, clean up commit history by replaying work, or rebuild a branch as reviewable commits.

Clean copy

Reimplement the current branch on a new branch with a clean, narrative-quality commit history suitable for reviewer comprehension.

Workflow

1. Gather context:

• Source branch: `git branch --show-current`.
• Working tree: `git status --short`.
• Commits since main: `git log main..HEAD --oneline`.
• Diff summary: `git diff main...HEAD --stat`.

2. Validate the source branch:

• Ensure there are no uncommitted changes or merge conflicts.
• Confirm the source branch is up to date with `main`.

3. Choose the new branch name:

• Use the user's requested name when provided.
• Otherwise use `<source-branch>-clean`.

4. Analyze the diff:

• Study all changes between the source branch and `main`.
• Understand the final intended state before recreating it.

5. Create the clean branch from `main`. 6. Plan the commit storyline:

• Break the implementation into self-contained logical steps.
• Each step should read like a stage of development in a tutorial.

7. Reimplement the work:

• Recreate the final changes step by step.
• Commit after each coherent idea.
• Use clear commit subjects and descriptions.
• Use `git commit --no-verify` for intermediate commits so hooks do not block temporarily incomplete states.

8. Verify correctness:

• Confirm the final clean branch state exactly matches the original source branch.
• Run the final commit without `--no-verify` so normal checks run.

9. Open a pull request using the `pr` skill.

• Include a link to the original branch in the PR description.

Rules

• Never add yourself or an AI tool as an author, contributor, or co-author.
• Never include AI attribution in commits or PR content.
• The final clean branch must be identical to the source branch.
• Do not force push unless the user explicitly asks for it.