What problem does it solve?
It solves the problem of turning a messy working tree into a clean, reviewable set of conventional commits without guessing how to group related changes or losing track of what should land together.
Core Features & Use Cases
- Plan-only commit structuring: Analyzes unstaged and staged diffs and writes a structured commit plan into COMMITS.md for review before anything is committed.
- Conventional-commit grouping: Groups files into coherent changes with appropriate types (feat, fix, docs, test, refactor, style, perf, chore, ci, build) and realistic scopes based on actual file paths and repo history.
- Safe, state-aware regeneration: Detects whether an existing COMMITS.md plan is current by comparing HEAD and a tree fingerprint, preserving a user’s ## Notes when regenerating.
- Optional execution chain: When explicitly approved, it can create a branch, commit each planned group with the plan’s exact headlines/bullets, push, and open a PR—while avoiding attribution trailers.
Quick Start
Run the skill to generate a plan in COMMITS.md, then say go when you want it to execute the branch → commits → push → PR workflow.