write-conventional-commit

---
name: "write-conventional-commit"
description: "Generate exactly one high-quality Conventional Commit message from the current Git diff. Use when Codex needs to inspect staged changes, summarize the dominant intent, and return only the final commit message with no analysis or extra text."
license: "MIT"
---

# Write Conventional Commit

Inspect Git changes and return exactly one final commit message.

## Workflow

- Run `git status --short`.
- If there are no staged or unstaged changes, reply exactly: `No staged or unstaged changes found.`
- Run `git diff --staged --no-ext-diff --stat`.
- Run `git diff --staged --no-ext-diff`.
- If the staged diff is empty but the working tree is dirty, use `git diff --no-ext-diff --stat` and `git diff --no-ext-diff` as a fallback.
- Infer the dominant intent from the diff and write one message only.
- Return exactly one final commit message and nothing else.

## Commit Types

Use exactly one type from this list:

- feat: a new feature
- fix: a bug fix
- docs: documentation only changes
- style: changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
- refactor: a code change that neither fixes a bug nor adds a feature
- perf: a code change that improves performance
- test: adding missing tests or correcting existing tests
- build: changes that affect the build system or external dependencies
- ci: changes to our CI configuration files and scripts
- chore: other changes that don't modify src or test files

## Conventional Commit rules

- Choose the dominant intent. DO NOT combine types.
- DO NOT end the subject with a period.
- If the change is breaking, mark it with `!` after the type or scope and include a `BREAKING CHANGE:` footer when additional migration detail is needed.
- Keep the subject concise; aim for 50-72 characters.
- Never include markdown fences, bullets, analysis, or commentary.
- Prefer a longer commit body after the short description, providing additional contextual information about the code changes.
- Prefer lower-case after the colon unless a proper noun or acronym requires capitalization.
- Preserve useful trailer/footer information from the context when it is clearly present.
- Use an optional scope only when it is obvious and genuinely helpful.
- Write the subject in imperative mood.