git-workflow

# Git Workflow Skill

Execute safe, reproducible Git workflows with **MANDATORY semantic commit enforcement**, auto-injected commit templates via prepare-commit-msg hook, and institutional memory capture via post-commit hooks.

## When to Use

Use this skill proactively when:
- **Committing any changes** - Enforces semantic prefix (feat:, fix:, docs:, etc.)
- **Creating feature branches** - Ensures branch names align with commit types
- **Validating commit messages** - Checks format before pushing
- **Understanding git hooks** - Shows what happens automatically
- **Staging files safely** - Prevents secrets from being committed
- **Team collaboration** - Ensures consistent conventions across all contributors

## Core Principle: Semantic Commits Are MANDATORY

**Every commit MUST start with a semantic type prefix.** This is not optional.

**Required format:** `<type>(<scope>): <subject>`

**Valid types:** feat, fix, docs, refactor, test, chore, ci, perf, style, revert

**Examples:**
```
feat(monitoring): add Prometheus metrics exporter
fix(nginx): correct worker process count
docs(readme): update installation instructions
```

**Why mandatory:**
- Git becomes institutional memory (searchable, categorized history)
- Auto-generates release notes and changelogs
- Enables automation (CI/CD triggers based on type)
- Pattern recognition for AI agents
- Compliance and audit trails

**Full specification:** See `references/commit-conventions.md` (loaded JIT when needed)

## Git Hooks Architecture

This repository uses **3 automated hooks** that run during commit lifecycle:

### 1. pre-commit Hook (Before Commit)
**Purpose:** Keeps `.codex/agents-index.yaml` synchronized with `.claude/agents/*.md`
**Triggers:** Only when staging changes to `.claude/agents/`
**What it does:** Regenerates agent index, stages updated manifest
**Can fail:** Yes - fix errors, rerun `make codex-agents-index`, retry commit
**Location:** `tools/scripts/git-hooks/pre-commit` (symlinked to `.git/hooks/pr