| name | commit-pipeline |
| description | Orchestrate a complete commit flow: use commit-planner to define batches, stage the selected batch, generate the message with commit-messages, and execute git commit safely. |
Commit Pipeline
Run a full plan -> stage -> message -> commit flow.
Use this skill when the user wants to finish commits end-to-end instead of only planning or only writing messages.
Skills Used
$commit-planner: define coherent commit batches$commit-messages: draft a structured commit message for the staged batch
Core Rule
Never commit files that are outside the selected batch.
If staging state does not match the selected batch, fix staging first before generating the message.
Workflow
- Capture working tree state.
git status --shortgit diff --name-onlygit diff --staged --name-only
- Run
$commit-planner.
- Produce batch options with goal, file list, and type/scope.
- Select one batch as the next commit.
- Stage only the selected batch.
- If index is dirty with unrelated files, unstage first:
git restore --staged <path>.
- Stage selected files only:
git add <paths...>.
- Verify:
git diff --staged --name-only must match the chosen batch.
- Run
$commit-messages on staged changes.
- Generate title +
Why/What/Risk/Tests/Live Docs.
- Ensure claim discipline: staged facts only.
- Commit with the generated message.
git commit -m "<title>" -m "Why:\n- ...\n\nWhat:\n- ...\n\nRisk:\n- ...\n\nTests:\n- ...\n\nLive Docs:\n- ..."
- Verify commit result.
git show --stat --name-only --oneline -1- Confirm no accidental files were included.
- Repeat from step 2 for the next batch until done.
Output Format
Use this structure when reporting execution:
Pipeline Run:
- Selected batch: ...
- Staged files: ...
- Commit title: ...
- Commit hash: ...
- Remaining changes: ...
Safety Checks
- Stop if
git diff --staged --name-only includes non-batch files.
- Stop if message claims behavior not present in staged diff.
- Do not auto-add untracked files unless they are explicitly part of the selected batch.
Bad Patterns
- running
$commit-messages before staging is finalized
- committing all changes with
git add . in a mixed working tree
- combining unrelated hygiene and feature slices into one commit without rationale
Output Checklist
Before finishing, verify:
- each commit corresponds to one batch from
$commit-planner
- staged files exactly match the batch before message generation
- commit message comes from staged reality
- commit hash and remaining work are reported
