Commit Message

Writes the message from what the diff actually did, not from what the plan said it would do.

Two modes:

Rule source order

1. The project's own git rules — .claude/rules/git*.md, CONTRIBUTING.md, docs/**/commit*.md, or an obvious convention in git log --oneline -30. If the repo has a convention, it wins.
2. Conventional-commit fallback — 저장소가 아무 규칙도 안 밝힐 때만. 강요가 아니라 기본값이다:

저장소가 다른 규칙(Angular, gitmoji, 자유 형식)을 쓰면 그쪽이 이긴다. 이 표를 근거로 저장소 관행을 바꾸려 들지 마라.

3. No tool trailers by default. Co-Authored-By: …, Session:, 🤖 Generated with … 같은 자동 트레일러를 넣지 않는다. 저장소가 요구하면 그때 넣는다. (PR 본문은 이 규칙의 대상이 아니다.)

Normal mode

/commit-msg [--files <glob...>]

1. Read the real change — git diff --stat, git diff (staged and unstaged), git log --oneline -10 for tone.
2. If the diff carries more than one purpose, do not write one message. Propose a purpose-based phase split (phase 1 = …, phase 2 = …) with the files in each, and let the user pick. Mixing purposes is the thing this skill exists to prevent.
3. Emit the draft(s). Tell the user the exact git add + git commit commands.
4. Stop. Do not stage, do not commit.

Checkpoint mode (--checkpoint S-n)

Only legal when all of these hold. Verify them; if any fails, fall back to normal mode and say why.

• .claude/review/{branch-slug}/run.json exists and has "commit_authorized": true — the user approved slice checkpoint commits for this run at the pipeline's Run Contract step.
• The current branch is not the base branch (run.json.base_branch, minus origin/) and not main/master. On a base branch: abort, tell the user, never commit.
• The slice passed its gate (S-n-gate.json → .verdict == "GREEN"), or the pipeline explicitly passed --allow-red because the slice is being parked (see below).

What gets staged

Only the slice's own files. Never git add -A, never git add ..

SLUG=$(git branch --show-current | tr '/' '-')
# 1) 이 슬라이스가 실제로 건드린 파일 = 게이트가 기록한 changed_files (글롭이 아니라 실측)
jq -r '.changed_files[].path' ".claude/review/$SLUG/S-{n}-gate.json"

• Stage exactly those paths, minus anything under .claude/review/ (산출물은 절대 커밋하지 않는다).
• A path that is untracked and outside the slice's target globs → do not stage it silently. List it in the run report as unstaged_out_of_scope and leave it in the working tree.
• If staging leaves the working tree dirty with unrelated pre-existing edits, that is fine — they were never yours. Never stash them.

Message shape

<prefix>(<scope>): <슬라이스 제목>

- <주요 변경 1 — 파일이 아니라 동작 기준>
- <주요 변경 2>

Slice: S-{n}  ·  Decisions: D-1, D-3
Gate: GREEN (fix 1회)  ·  Agent-review: BLOCKING 0 / 이월 2

• <scope> = the layer or module the slice actually lands in, taken from the changed paths. Omit it if the slice spans too many to name honestly.
• The trailing Slice: / Gate: lines are the batch run's audit trail — they make a later git log --oneline legible as a slice ledger. Drop them in normal mode.
• 커밋 메시지 안에 리뷰어에게 보내는 변명·TODO를 쓰지 않는다. 이월 항목은 fix-queue가 들고 있다.

After committing

git rev-parse --short HEAD      # → run.json 의 해당 슬라이스 commit_sha 로 기록

Report: S-{n} 체크포인트 커밋 <sha> — <제목>. One line. Do not print the whole diff.

Parked slice (--allow-red)

A slice that failed and is being parked is committed only if its code is in a non-breaking state — the gate's diagnostics check (check 1) has no errors. It failed on convention or on an unresolved BLOCKING review finding, which the user will judge at the review desk.

If diagnostics are not clean, do not commit. Say so and hand it back: the pipeline stashes the slice (B5) rather than leaving a broken tree for the next slice. A broken checkpoint commit is worse than none — it makes every later slice's diff unbisectable.

The message keeps the normal prefix (the convention has no wip:) and says it is parked in the title:

<prefix>(<scope>): <슬라이스 제목> — 보류(미완)

- <어디까지 됐는지>

Slice: S-{n}  ·  Decisions: D-4
Gate: RED (미해결: <항목>)  ·  검수 데스크에서 판단 필요

Hard constraints

• Never git push. Ever. In any mode.
• Never git commit --amend on a commit the user made, and never on a commit that is already pushed.
• Never git add -A / git add . — always explicit paths.
• Never commit in normal mode. Never commit in checkpoint mode without run.json.commit_authorized.
• Never git stash, never git reset --hard, never touch other people's uncommitted work.
• Never commit .claude/review/** artifacts, or anything the repo's .gitignore misses that is obviously an artifact (*.log, coverage output, node_modules).
• Never add AI attribution trailers to the commit message.