What problem does it solve?
Use when the user requests Git help or when preparing commits, branches, or PRs. Enforce a clean, repo-agnostic workflow: branching, Conventional Commits, changelog hygiene (when the repo uses one), safe rebasing/merging, and recovery/rollback practices.
Core Features & Use Cases
- Branching: Create a scoped work branch and avoid committing directly to the default branch.
- Conventional Commits: Enforce standardized commit messages to improve history clarity.
- Staging Discipline: Stage changes deliberately to keep commits cohesive.
- Changelog and Versioning: Respect existing changelog and versioning rules when applicable.
- Syncing With Base Branch: Choose merge or rebase per repo convention.
- PR Preparation: Ensure PRs include a clear summary, testing notes, and documentation updates when needed.
- Recovery and Rollback: Support stash, amend, and revert operations to recover from mistakes.
- References: Consult references/git-workflow.md for deeper guidance.
- Extended Guidance: Provide guidance for conflicts, releases, and edge cases.
- Conflict Resolution Defaults: Use git status and diff to guide resolutions and keep changes focused.
Quick Start
Identify the repository's default branch, create a scoped feature branch, commit with Conventional Commits, and open a PR with a clear summary.