krammerecreate-commits

---

name: kramme:recreate-commits description: Use when asked to recreate commits with narrative-quality history on the current branch.

Reimplement the current branch with a clean, narrative-quality git commit history suitable for reviewer comprehension. By default, recreate commits on the current branch (not a new clean branch).

Steps

1. Validate the source branch

   • Identify the current branch name.
   • If on main or master, stop and ask the user to switch to a feature branch first.
   • Ensure the current branch has no merge conflicts, uncommitted changes, or other issues.
   • Confirm it is up to date with master (or main depending on your repository).

2. Analyze the diff

   • Study all changes between the current branch and master (or main depending on your repository).
   • Form a clear understanding of the final intended state.

3. Prepare the branch

   • By default, work on the current branch. Do NOT create a {branch_name}-clean branch unless explicitly requested.
   • If explicitly asked to use a clean branch, create {branch_name}-clean from the merge base with main/master.

4. Plan the commit storyline

   • Break the implementation down into a sequence of self-contained steps.
   • Each step should reflect a logical stage of development—as if writing a tutorial.

5. Reimplement the work

   • Reset the branch to the merge base with main/master.
   • Recreate the changes, committing step by step according to your plan.
   • Each commit must:
     • Introduce a single coherent idea.
     • Include a clear commit message and description.
     • Add comments or inline GitHub comments when needed to explain intent.

6. Verify correctness

   • Confirm that the final state of the branch exactly matches the final intended state (same as before the reset).
   • Use --no-verify only when necessary (e.g., to bypass known issues). Individual commits do not need to pass tests, but this should be rare.

There may be cases where you will need to push commits with --no-verify in order to avoid known issues. It is not necessary that every commit pass tests or checks, though this should be the exception if you're doing your job correctly. It is essential that the end state of the branch be identical to the original end state before the reset.

Misc

1. Never add yourself as an author or contributor on any branch or commit.
2. Write your pull reuqest following the same instructions as in the pr.md command file.
3. In your pull request, include a link to the original branch.

Your commit should never include lines like:

Copy🤖 Generated with [Claude Code](https://claude.com/claude-code)

or

CopyCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Or else I'll get in trouble with my boss.