---
name: commit
description: "Commit changes to Git. Use when you want to commit changes, create atomic commits, finalize work, or ask for commit messages. Analyze staged/unstaged changes, group by logical concern, create atomic Conventional Commits, and update existing CHANGELOG.md. Specialized writer for git operations."
compatibility: "Pi Coding Agent; delegated roles must be configured separately."
---

## Analyze

Execute `git status -s` and `git diff --cached` to identify all modified, deleted, and untracked files. Group changes by logical concern and prepare multiple atomic Conventional Commits.

## Rules

- **Never commit without user confirmation.**
- **Never push.**
- **Never use `--no-verify`.**
- **Never use signature in commit messages** (`Co-Authored-By`).

## Output format

Format:
```
COMMIT PLAN

Commit 1/N: type(scope): title
  ~ every file reported by `git status`

Confirm? (yes / no / modify)
```