---
name: git-committer-atomic
description: Plan and create atomic commits ordered by dependencies
version: 1.1.0
tags: [git, workflow, atomic]
owner: engineering
status: active
---

# Git Committer Atomic Skill

## Overview

Split changes into atomic commits ordered by dependency.

## Usage

```
/git-committer-atomic
```

## Identity
**Role**: Git Operations Specialist
**Objective**: Break down the current set of changes into atomic, logical commits, ensuring dependencies are committed before consumers.

## Context
You are working in a dirty git state. Your goal is to reach a clean git state (`git status` clean) by creating a series of well-structured commits.

## Workflow Rules

### 1. Analysis Phase
- Run `git status --porcelain` to see all changes.
- Analyze dependencies between changed files.
- **Dependency Hierarchy** (Commit in this order):
  1.  **Infrastructure**: Config files, build scripts, strict types (`tsconfig.json`, `package.json`).
  2.  **Core/Utils**: Shared libraries, helper functions, base classes.
  3.  **Domain/Models**: Database schemas, entity definitions, DTOs.
  4.  **Services**: Business logic, API handlers.
  5.  **Features/UI**: React components, pages, routes.
  6.  **Tests**: Unit and integration tests (can be committed with features if tight, but often separate).

### 2. Execution Loop
While `git status` is not clean:
1.  **Identify** the next logical group of files based on the hierarchy above.
2.  **Stage** these files: `git add <file1> <file2>`.
    - If a file contains multiple logical changes (e.g., a fix AND a feature), instruct the user to use `git add -p` or split it yourself if capable.
3.  **Verify** (Mental Check): Does this commit compile/make sense on its own?
4.  **Commit**: Generate a conventional commit message (ref: `git-commit-conventional`).
    - Format: `type(scope): description`
    - Example: `feat(utils): add date formatting helper`
5.  **Repeat**.

## Constraints
- **Atomic**: Each commit must do one thing.
- **Buildable**: Avoid leaving the repo in a broken state between commits if possible.
- **No "WIP"**: Do not create "Work in progress" commits unless explicitly asked.

## Agent Compatibility
- **Claude**: Use strict ordering.
- **Cursor**: Focus on file grouping logic.
- **Gemini**: verification of dependency graph logic.

## Outputs

- Ordered list of atomic commits with rationale.

## Related Skills

- `/git-commit-conventional` - Message formatting