name	commit-smart
description	Atomic Git Commit

Created: 2026-02-09-00-00 Last Updated: 2026-02-09-00-00

Atomic Git Commit

Create an atomic git commit for the changes made in this session.

First, run git status to see all changes (staged, unstaged, and untracked files).
Identify only the files you touched in this session. Do not commit files modified by other agents or processes.

For tracked files (modified):

git commit -m "<scoped message>" -- path/to/file1 path/to/file2

For brand-new (untracked) files:

git restore --staged :/ && git add "path/to/file1" "path/to/file2" && git commit -m "<scoped message>" -- path/to/file1 path/to/file2

Quote paths with special characters: Any path containing brackets [], parentheses (), or other shell metacharacters must be quoted:
```
git add "src/app/[candidate]/page.tsx"
git commit -m "message" -- "src/app/[slug]/page.tsx"
```

Use a scoped, descriptive message (e.g., feat(auth): add login form, fix(api): handle null response)
Keep the first line under 72 characters
DO NOT add Co-Authored-By: Codex or any AI co-author line - commits should appear as user-authored

NEVER run these commands unless the user explicitly requests them in writing:

If unsure, STOP and ask the user before proceeding.

Run git status - review what changed
Run git diff --staged and git diff - understand the changes
Identify files from your session only
Check if docs need updating - if the change introduces a gotcha, design decision, or behavior change, add a brief note to the relevant .md file (e.g., CODEX.md, QUICK-REFERENCE.md). Keep it minimal.
Compose a clear commit message
Execute the appropriate commit command
Run git status again to verify success

name	commit-smart
description	Atomic Git Commit