# Git Workflow

> Standard git workflow conventions for branching, commits, and PRs. Apply to all code changes.

- Skill: `aselimc/git-workflow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add aselimc/git-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aselimc/git-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: aselimc (https://skillmd.com/u/aselimc)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/aselimc/git-workflow

---


# Git Workflow

## Branch Naming
- `feat/<description>` - New features
- `fix/<description>` - Bug fixes
- `refactor/<description>` - Code refactoring
- `docs/<description>` - Documentation changes
- `test/<description>` - Test additions/fixes

## Commit Messages (Conventional Commits)
```
<type>: <short description>

[optional body]
```
Types: `feat`, `fix`, `chore`, `docs`, `test`, `refactor`, `perf`, `ci`

## PR Conventions
- Descriptive title under 72 chars
- Link related issues
- Include summary of changes and test evidence
- Squash-merge to main

## Rules
- Branch from `main`
- Never force-push shared branches
- Tag releases with semver (vMAJOR.MINOR.PATCH)
- Keep commits atomic (one logical change per commit)