Automatically analyzes code changes and creates git commits with conventional commit messages when the user indicates they want to save their work, commit changes, or says 'commit this', 'save my changes', 'let's commit'. Auto-detects commit type, scope, and ticket reference from branch name.
You are tasked with creating git commits using conventional commit format for the changes made during this session.
Analyze what changed:
git status to see current changesgit diff --cached to see staged changes (if any)git diff to see unstaged changesgit diff --name-only and git diff --cached --name-onlyAuto-detect conventional commit components:
Type detection (suggest to user):
*.md files in docs/: suggest docs*test*, *spec*): suggest testpackage.json, files: suggest *.lockbuild.github/workflows/: suggest cifeat or fix based on contextfeat, fix, refactor, chore, docs, style,
perf, test, build, ciScope detection (suggest to user):
agents/*.md → agentscommands/*.md → commandsscripts/* → scriptsdocs/*.md → docs.claude/ → claudeExtract ticket reference:
git branch --show-current{PREFIX}-{NUMBER} (e.g., ENG-123, PROJ-456)Generate conventional commit message:
Format:
<type>(<scope>): <short summary>
<body - optional but recommended>
<footer - ticket reference>
Rules:
Refs: TICKET-123 if ticket in branch nameExample:
feat(commands): add conventional commit support to /commit
Updates the commit command to automatically detect commit type
and scope from changed files, following conventional commits spec.
Extracts ticket references from branch names for traceability.
Refs: ENG-123
Present plan to user:
<type>(<scope>): <summary>"Execute commit:
git add <specific-files> (NEVER use -A or .)git log --oneline -n 1git show --stat HEADReads from .catalyst/config.json:
{
"catalyst": {
"commit": {
"useConventional": true,
"scopes": ["agents", "commands", "scripts", "docs", "config"],
"autoDetectType": true,
"autoDetectScope": true,
"requireBody": false
},
"project": {
"ticketPrefix": "PROJ"
}
}
}
Types that appear in CHANGELOG:
feat - New featurefix - Bug fixperf - Performance improvementrevert - Revert previous commitInternal types:
docs - Documentation onlystyle - Formatting, no code changerefactor - Code restructuring, no behavior changetest - Adding/updating testsbuild - Build system or dependenciesci - CI/CD configurationchore - Maintenance tasksFeature:
feat(agents): add codebase-pattern-finder agent
Implements new agent for finding similar code patterns across
the codebase with concrete examples and file references.
Refs: ENG-456
Fix:
fix(commands): handle missing PR template gracefully
Previously crashed when thoughts/shared/pr_description.md was
missing. Now provides clear error with setup instructions.
Refs: ENG-789
Documentation:
docs(scripts): add README for setup scripts
Documents all scripts in scripts/ directory with usage examples
and explains when to use each setup method.
Refs: ENG-012
Chore (no ticket):
chore(config): update conventional commit scopes
Adds new scopes for agents and commands directories.
Control Philips Hue lights and scenes via the OpenHue CLI.