| name | git-conventional-commits |
| description | Splits working tree changes into logical Git commits with conventional messages (feat, fix, test, chore, refactor, style, docs). Proposes commits one at a time and waits for explicit user approval before each git commit. Use when the user asks to commit, split commits, stage by topic, or use conventional / semantic commit messages. |
Conventional commits — logical splits and approval loop
Allowed types
Exactly one: feat | fix | test | chore | refactor | style | docs.
| Type | Use for |
|---|
feat | New user-visible behavior |
fix | Bug fixes |
test | Tests only |
chore | Deps, CI, tooling, housekeeping |
refactor | Restructure, same behavior |
style | Format/lint autofix, no logic |
docs | README, AGENTS, rules/skills, doc comments |
Format: type: imperative subject — lowercase type, space after colon, ~72 chars, no trailing period.
Local enforcement: .husky/commit-msg → yarn lint:commit. git commit --no-verify only when must bypass hooks.
Workflow (default when user wants multiple commits)
- Inspect:
git status, git diff, git diff --staged
- Full quality gate:
yarn testbatch:verify one terminal (testing-terminal-isolation.mdc). Dev scoped gate during edits does not substitute. Changelog-only exception: only i18n/*/documents/changeLog.md + full gate already passed after substantive edits
- Storybook gate: changed
src/components/** — stories/mocks. Skip changelog-only repair
- Changelog gate: update
changeLog.md before commit; prefer same commit as product work — fantasia-changelog-en-us
- Plan: ordered commits — type + subject + paths
- Approval loop (when user asked per-commit approval): present next commit → wait explicit OK →
git add those paths only → git commit
- Single commit / no step-by-step: valid
type: message after gates
Rules
- Never commit without approval when user requested per-commit approval
- Never mix unrelated concerns in one commit
- Prefer small reviewable chunks
refactor for production moves; chore for repo/meta- No skipping changelog for substantive work
- No skipping Storybook for
src/components/** product commits
Final cleanup override
Final cleanup → fantasia-final-cleanup: verify, changelog, logical commits, push — may commit without per-commit approval unless user interrupts.
Related
Types
Shared types → types/. See types-folder.mdc.
