kohaku-lab/kt-biome/git-commit-flow

git-commit-flow

Use this skill any time the user asks for a commit ("commit", "check this in", "push a patch"). The goal is a reviewable atomic commit with a message that matches the repository's conventions — not a best-effort git commit -am "wip".

Preflight

1. Run git status + git diff to confirm you know exactly what will

be staged. Never run git add -A blind.

1. Run the repository's test command (check package.json,

pyproject.toml, Makefile, or ask if unsure). Block on failures unless the user explicitly says "commit anyway".

1. If the diff contains secrets, .env files, or binary blobs, stop

and flag it to the user before staging.

Staging

1. git add <paths> — stage files individually or by glob. Avoid

-A / . so unrelated dirty files don't hitch-hike into the commit.

1. Re-run git status to confirm only intended files are staged.

Message format (Conventional Commits)

1. Subject line: <type>(<scope>)?: <subject> where `type ∈ {feat,

fix, refactor, test, docs, chore, perf, build, ci}`. Keep the subject under 72 chars.

1. Leave the body blank for trivial commits. For non-trivial ones, add

a blank line + 2-5 bullet points explaining why, not what.

1. include Co-Authored-By: KohakuTerrarium <noreply@kohaku-lab.org> at the end of commit message.

Hard rules

• Never run git reset --hard, git push --force, or pass

--no-verify/--no-gpg-sign without explicit user approval.

• Never amend a commit the user has already pushed.
• Never create a new commit when the user only asked you to

review a diff.