What problem does it solve?
This Skill standardizes Git workflow management to reduce manual friction, ensures a predictable commit history with a 2-commit per task approach, and helps prevent merge conflicts through automated preflight checks and safer operations.
Core Features & Use Cases
- Preflight environment validation: automatically verifies tooling (nvm/git/yarn), branch state, and dependencies before work begins.
- 2-commit strategy enforcement: guarantees one feature/implementation commit and one documentation/notes commit per task.
- Automated Conventional Commit messages: generates standardized messages with appropriate scope and type.
- Progress reporting & safe recovery: provides phase-based progress updates and clear rollback/recovery guidance during conflicts.
- Use Case: for a task defined in 03_plan.md (e.g., 2.3), implement the feature in a dedicated commit, then document it in a separate docs commit, maintaining a clean history.
Quick Start
Use this skill to set up the environment, generate consistent commits, and follow a guided workflow to complete a task.
- Run the preflight setup: ./tools/git_setup.sh
- Generate commits for a task: ./tools/commit_generator.sh 2.3 feature
- Stage and commit according to the generator output
- Push and review through your standard PR process