What problem does it solve?
Decompose a messy local branch into a sequence of atomic commits ready for review and merge, simplifying PRs and preserving a clean history.
Core Features & Use Cases
- Atomic commits: break large changes into smallest logical units for clear, incremental review.
- Phase-driven workflow: Analyze, Plan, Execute, and Verify with optional human-in-the-loop gates to ensure quality before commits.
- History integrity: verify that the decomposed branch is equivalent to the original feature branch.
Quick Start
Phase 1: Analyze your branch by inspecting commits and changes against the base master (e.g., git log master..HEAD, git diff master...HEAD, git diff --stat master...HEAD).
Phase 2: Plan the decomposition by outlining atomic commits and their dependencies.
Phase 3: Execute the decomposition by creating a new branch (e.g., feature-branch-decomposed) and applying commits in the planned order.
Phase 4: Verify the result by comparing with the original branch (e.g., git diff master..HEAD) to ensure equivalence.