git-atomic-commit（git 原子提交）

Git Atomic Commit

Always produce small commits where each commit has one logical purpose and passes checks.

Required Guardrails

1. Run git-run-checks before the first commit and after each meaningful commit group.
2. Never mix refactor + behavior change + formatting in one commit unless unavoidable.
3. Keep commit ordering dependency-safe (prerequisites first).

Atomic Slicing Process

1. Inspect changes with git status --short and git diff.
2. Draft commit slices by concern:

- mechanical move/rename - API or schema changes - behavior changes - tests - docs/chore

1. Stage only one slice (git add -p or path-based staging).
2. Verify staged diff with git diff --cached.
3. Commit with a Conventional Commit message (delegate to git-conventional-commit).
4. Repeat until working tree is clean.

Quality Checks per Slice

• Commit compiles and tests at least at smoke level.
• Message explains intent, not implementation trivia.
• Follow-up commits do not silently depend on unstaged files.

Optional Helper Script

Use ./scripts/suggest-slices.sh to get candidate commit groupings from file paths.

Boris-Inspired Operating Rules

• Read first, code less, and edit only what is necessary.
• Keep context tight and decisions explicit.
• Prefer deterministic command sequences over ad-hoc experimentation.
• Surface assumptions and risks before finalizing each commit.

Claude Mapping (Optional)

• Use parallel agents only for independent subproblems; merge results into one coherent commit plan.
• Keep each subagent assigned to one commit slice to avoid overlap.