# Git Workflow

> Git branching, commit, and PR workflow for Mission Control development Use when this capability is needed.

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

---


# Git Workflow

## Branch Naming
```
feature/{ticket-id}-short-description   # New features
fix/{ticket-id}-short-description       # Bug fixes
agent/{agent-name}                      # Agent worktrees (reserved)
```

## Commit Format
```
{type}({scope}): {short description}

Types: feat, fix, refactor, test, docs, chore
Scope: phase number, module name, or "agents"

Examples:
feat(16-01): add tmux-setup.sh and agent-start.sh
fix(api): correct pagination offset in tasks route
```

## Per-Task Commit Rule
- Stage only files modified by the current task
- Never `git add -A` or `git add .`
- One commit per logical change

## Pre-commit Checklist
1. `npx tsc --noEmit` → 0 errors
2. `npm run build` → succeeds (if touching routes or components)
3. No secrets or .env files staged
4. No console.log in production code

## Worktree Usage
Agent worktrees at `~/mission-control/worktrees/{coder,designer,chief}`:
- Each on branch `agent/{name}`
- Run `tools/worktree-setup.sh` to initialize
- Agent works in worktree; merge to main via PR

## Protected
- `main` branch: never force push
- External actions (deploy, publish) require Tier 3 approval

---
> Source: [ProfFroggo/froggo-mission-control](https://github.com/ProfFroggo/froggo-mission-control) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->