commit · qdhenry — Claude Code command: what it does, how to install
Generates task-aligned Conventional Commits, tracks status transitions, and validates changed files against task scopes.
no license ★ 1,357 updated 2026-03-01
.claude/commands/commit.mdWhat commit does
This command links your Git commit history directly to project orchestration tasks. When finishing work or moving tasks to QA, it reads task metadata to format commit messages under the Conventional Commits specification, converting task types into prefixes like feat, fix, or perf.
It handles multiple workflows through flags like --batch and --smart-group, grouping related tasks into a single atomic commit. The tool also inspects Git worktrees and checks changed files against task boundaries. Running with --validate halts execution whenever tests fail or out-of-scope files are detected.
Commit hashes and timestamps write back into TASK-STATUS-TRACKER.yaml, which means project orchestration files must be in place for full synchronization.
What it helps with
- Generate Conventional Commits directly from task metadata
- Group related completed tasks into atomic batch commits
- Verify test passes and scope boundaries before creating a commit
- Update TASK-STATUS-TRACKER.yaml with generated commit hashes
Example prompts for the agent
- /orchestration/commit TASK-003
- /orchestration/commit --feature authentication --batch
- /orchestration/commit --validate
How to install commit
Manually: put the files in place
.claude/commands/commit.mdCall it with /commit. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/commit.mdCall it with /prompts:commit. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/commit.prompt.mdManually: put the files in place
.gemini/commands/commit.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about commit
How do I install commit in Claude Code?
Place the command file at .claude/commands/commit.md in your project root.
What does the commit command do?
It creates structured Git commits linked to task identifiers and tracks task history in the project tracker file.
Can commit verify tests before creating a commit?
Running /orchestration/commit --validate runs tests and verifies that changed files match the task scope.
Similar slash commands
All slash commands for Git and GitHub →commit by other authors comes first.