commit-style

Commit Changes

Create a git commit using conventional commits format.

Commit Style

• Format: type(scope): description or type: description
• Types: feat, fix, docs, chore (minimal set)
• Scope: Optional, use when it adds clarity (e.g., feat(auth):, fix(ipc):)
• No AI attribution by default: Do not add "Generated with Claude Code" or Co-Authored-By lines unless required by the project standards (always check, first)
• No emojis: Keep messages plain text

Verbosity Rules

• Small changes (~1-4 files, simple modification): Title only, ~50-72 chars
• Medium changes (5-7 files, related modifications): Title + 1-3 sentence body
• Large changes (8+ files or significant feature): Title + bullet point list

Workflow

Note: For steps where it says to ask for directions, use your question tools, if available.

1. Show current status: Run git status to see all changes
2. Show diff summary: Run git diff --stat for overview, git diff for details if needed
3. Interactive staging: Ask which files/changes to include in this commit
4. Draft message: Based on staged changes, draft a conventional commit message
5. Review: Show the proposed message and ask for approval or edits
6. Commit: Execute the commit (without --no-verify unless requested)

Instructions

Follow this workflow step by step. Be concise in your communication. When showing diffs, summarize large changes rather than dumping everything.

For the commit message:

• Use imperative mood ("Add feature" not "Added feature")
• First line should be under 72 characters
• If body is needed, separate from title with blank line
• Body lines should wrap at 72 characters

Example small commit:

docs: add design documentation index

Example medium commit:

feat(auth): implement OAuth token refresh

Add automatic token refresh when access token expires within 5 minutes.
Tokens are persisted to OS keychain via frontend IPC.

Example large commit:

docs: overhaul documentation

- Add cross-platform backend path resolution to frontend-architecture.md
- Clarify multi-turn conversation status in backend-adapter.md
- Create ROADMAP.md with phase breakdown
- Add asset authoring timeline to animation-system.md
- Create design docs index page