decompose-branch

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.