What problem does it solve?
This Skill provides a structured approach to Git workflow and versioning, ensuring code changes are manageable, reviewable, and reversible.
Core Features & Use Cases
- Structured Workflow: Offers guidelines for a disciplined Git workflow, including trunk-based development and feature branching.
- Commit Best Practices: Emphasizes atomic commits, descriptive messages, and separating concerns.
- Branching Strategy: Explains the use of feature branches, release branches, and when to use feature flags.
- Worktrees: Describes how to use worktrees for parallel development without conflicts.
- Pre-Commit Hygiene: Provides a checklist for pre-commit checks, including tests, linting, and type checking.
- Generated Files Handling: Offers guidance on how to handle generated files and create a .gitignore file.
- Debugging with Git: Includes commands for bisecting, viewing recent changes, and finding who last changed a specific line.
- Common Rationalizations: Addresses common misconceptions about Git practices.
- Red Flags: Lists signs of poor Git practices.
- Verification: Provides a checklist for ensuring each commit meets quality standards.
Quick Start
Apply the git-workflow-and-versioning skill to your next code change, ensuring each commit is atomic, messages are descriptive, and branches are short-lived.