spec-commit

Git Commit

Create a single, well-crafted git commit from the current working tree changes.

Invocation And Authorization Boundary

This is an internal-only helper. A public workflow may delegate here only after the current user or a visible upstream handoff has established commit_authorization: authorized for the intended run-owned paths. workflow invocation does not authorize commit; tool permission, a dirty tree, a branch name, or successful verification are execution facts, not authority. When commit authorization is missing, stop before branch mutation, staging, or commit and return commit_authorization_missing.

This helper owns commit composition and the authorized commit checkpoint only. It does not own push, PR creation/update, plan lifecycle, or unrelated dirty paths. If branch creation would be required, obtain explicit approval for that concrete branch mutation before creating it.

Context

Gather Git context by running each command as its own argv-style shell tool call. Do not join commands with shell separators, pipes, substitutions, or redirects; those forms are host-shell-specific and can hide the real exit status.

Command	Purpose	Non-zero or empty result
git status	Working-tree state	Not a Git repository: stop
git diff HEAD	Uncommitted changes	An unborn repo may have no HEAD; inspect tracked changes directly
git branch --show-current	Current branch	Empty output means detached HEAD
git log --oneline -10	Commit-message convention	An unborn repo has no history
git rev-parse --abbrev-ref origin/HEAD	Remote default branch	Resolve it using the fallback in Step 1

These facts are a snapshot. Re-read the branch and staged paths immediately before committing because the working tree may change after intake.

---

Workflow

Step 1: Gather context

Run every command in the Context section as a separate shell tool call.

The remote default branch value returns something like origin/main. Strip the origin/ prefix to get the branch name. If the command exited non-zero or returned a bare HEAD, try: