# Git Workflow

> Use this skill for all version control tasks, including committing, branching, pushing, and reviewing history.

- Skill: `tomevault-io/git-workflow-212` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/git-workflow-212`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-workflow-212/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-212

---


# Git Workflow & Safety Protocols

## 1. Safety & Confirmation

### 1.1 Dangerous Operations
**Explicit user confirmation is REQUIRED for:**
*   `git commit` (unless user pre-authorized)
*   `git push`
*   `git reset --hard`
*   `git clean -fd`
*   `git checkout` (if current branch has changes)

### 1.2 Command Standards
*   **Atomic Commits**: One logical change per commit.
*   **No Parallel Git**: Git relies on the index lock. Never run multiple git commands in parallel.
*   **Rollback Protocol**: `checkout` rollbacks require confirmation.

---

## 2. Conventional Commits Specification

**Format**: `<type>(<scope>): <subject>`

**Supported Input Parameters (Mental Model):**
*   **Action**: enum [commit, push, branch, log, status]
*   **Commit Type**: enum [feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert]
*   **Commit Scope**: string (optional, e.g., auth, api, ui)
*   **Commit Message**: string (max 50 chars)

| Type | Description |
| :--- | :--- |
| `feat` | A new feature |
| `fix` | A bug fix |
| `docs` | Documentation only changes |
| `style` | Changes that do not affect the meaning of the code (white-space, formatting, etc) |
| `refactor` | A code change that neither fixes a bug nor adds a feature |
| `perf` | A code change that improves performance |
| `test` | Adding missing tests or correcting existing tests |
| `build` | Changes that affect the build system or external dependencies |
| `ci` | Changes to our CI configuration files and scripts |
| `chore` | Other changes that don't modify src or test files |
| `revert` | Reverts a previous commit |

---

## 3. Branching Strategy
*   **Feature Branches**: `feat/short-description`
*   **Bugfix Branches**: `fix/issue-id-description`
*   **Chore Branches**: `chore/description`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/till-crazy-tears-us-apart) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->