# Git Conventions

> Git command rules, commit message conventions, and safe usage patterns. Use when the user asks to commit, create a branch, check differences, write a commit message, or perform any git operation. Also use when discussing version control workflows or git safety. Use when this capability is needed.

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

---

# Git Conventions

## When to use
- User asks to commit, stage, diff, or perform any git operation
- User asks to create a branch or write a commit message
- User asks to check differences with a previous version
- User mentions "git", "commit", "branch", "diff", or "version control"
- User is ready to commit after completing a task

## Overview

Rules for safe and consistent git usage.

## Command rules

1. Never use the command `push`.
2. Never use the option `force` `--force`.
3. Never amend commit to modify files, prefer adding more commits (fix commit) and explain the error/reason.
4. Before running a new git command, ask to add it in the allow list.
5. Do not hesitate to use git when checking differences with the previous version.
6. A task should be committed when tests pass (with assertions) and code coverage is verified.

## Commit message

A git commit message must start with:

- `feat(agt):` for feature
- `fix(agt):` when fixing the codebase
- `refac(agt):` for refactoring, mostly to prepare or finish a feat
- `chore(agt):` to cleanup the codebase, removing dead code
- `doc(agt):` when touching to .md files or documentation
- `test(agt):` when touching test only

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

