make-commit git:20260909.eb38ca7A

Immutable. This exact content is served forever at /api/v1/blob/332cac0ddcfefb80.

---
name: make-commit
description: Review staged changes and make a git commit.
user-invocable: true
disable-model-invocation: true
---
# Make Commit

- Review the staged changes to fully understand the context.
- Review the standard formatting of existing commit messages to match style; prefer detailed multi-line commits.
- Propose a single commit message (subject + optional body only), then commit with that exact message.

## Passing a Multi-Line Message

Never put `\n` inside a double-quoted `-m` argument.
Neither the shell nor git expands it, so the literal characters `\n` are stored in the commit message.

Pipe the exact message to `git commit -F -` instead:

```bash
git commit -F - <<'MSG'
Subject line

Body line one.
Body line two.
MSG
```

A subject plus one body paragraph may instead use repeated `-m` flags, which git joins with a blank line between them:

```bash
git commit -m "Subject line" -m "Body paragraph."
```