Commit Changes
Create a git commit using conventional commits format.
Commit Style
- •Format:
type(scope): descriptionortype: 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.
- •Show current status: Run
git statusto see all changes - •Show diff summary: Run
git diff --statfor overview,git difffor details if needed - •Interactive staging: Ask which files/changes to include in this commit
- •Draft message: Based on staged changes, draft a conventional commit message
- •Review: Show the proposed message and ask for approval or edits
- •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:
code
docs: add design documentation index
Example medium commit:
code
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:
code
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