git-conventions

name	git-conventions
description	Use when starting new work (feature or fix branch), or when commit message validation fails. Provides branch creation wizard and commit format reference.

Git Conventions

Overview

Team conventions for git workflow: branch naming and commit message format. Commit validation is enforced automatically via PreToolUse hook.

Commit Message Format

Valid Patterns

Pattern	Example
type: Description	feat: Add user authentication
Merge ...	Merge branch 'master' of ...
Revert "..."	Revert "feat: Add feature"
Initial commit	Initial commit

Rules

• Types: feat, fix, docs, chore, test
• Description: Capital letter, then at least one more character
• Format: type: Description (space after colon required)
• Passthrough: Merge/Revert/Initial commits skip validation

Quick Reference

✅ feat: Add user authentication
✅ fix: Resolve memory leak
✅ test: Add unit tests for auth
✅ docs: Update README
✅ chore: Update dependencies

❌ added new feature     (no type)
❌ feat:Add feature      (missing space)
❌ feat: add feature     (lowercase)
❌ feature: Add          (invalid type)

Branch Creation (/start-work)