# Git

> Git conventions for commits, branches, and PRs. Apply when writing commit messages, naming branches, staging files, or creating pull requests. Use when this capability is needed.

- Skill: `tomevault-io/git-15` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/git-15`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-15/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/git-15

---


# Git Standards

## Conventional Commits

Format: `type(scope): description`

Types:
- `feat:` - New features
- `fix:` - Bug fixes
- `docs:` - Documentation changes
- `style:` - Code style changes (formatting, no logic change)
- `refactor:` - Code refactoring
- `test:` - Adding or updating tests
- `chore:` - Maintenance tasks

## Commit Messages

- Brief description (50 chars or less for first line)
- Focus on "why" not "what"
- Use imperative mood ("add feature" not "added feature")
- No AI attribution (forbidden)

## Branch Naming

- Use kebab-case: `feature-auth`, `fix-validation`, `docs-readme`
- Prefix with type when appropriate: `feature-*`, `fix-*`, `docs-*`
- No date prefixes

## Files to Never Stage

- `node_modules/` - Dependencies
- `.env*` - Environment files with secrets
- `.DS_Store` - macOS system files
- `dist/`, `build/` - Build artifacts
- `*.log` - Log files
- `.claude/logs/` - Claude logs
- `*.backup` - Backup files
- Credentials files (credentials.json, etc.)

## PR Description Template

```markdown
## Summary
[1-3 bullet points]

## Changes Made
- [Change 1]
- [Change 2]

## Testing
- [Test coverage description]
```

## Quick Reference

| Action | Convention |
|--------|------------|
| New feature | `feat(scope): add X` |
| Bug fix | `fix(scope): resolve X` |
| Breaking change | `feat!:` or `BREAKING CHANGE:` in body |
| Branch for feature | `feature-descriptive-name` |
| Branch for fix | `fix-descriptive-name` |

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/dungle-scrubs) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->