davila7--claude-code-templates/cli-tool/components/commands/orchestration/commit.md

Orchestration Commit Command

Create git commits aligned with task completion, maintaining clean version control synchronized with task progress.

Usage

/orchestration/commit [TASK-ID] [options]

Description

Automatically creates well-structured commits when tasks move to QA or completion, using task metadata to generate meaningful commit messages following Conventional Commits specification.

Basic Commands

Commit Current Task

/orchestration/commit

Commits changes for the task currently in progress.

Commit Specific Task

/orchestration/commit TASK-003

Commits changes related to a specific task.

Batch Commit

/orchestration/commit --batch

Groups related completed tasks into logical commits.

Commit Message Generation

Automatic Format

Based on task type and content:

feat(auth): implement JWT token validation

- Add token verification middleware
- Implement refresh token logic
- Add expiration handling

Task: TASK-003
Status: todos -> in_progress -> qa
Time: 4.5 hours

Type Mapping

Task Type     -> Commit Type
━━━━━━━━━━━━━━━━━━━━━━━━━━━
feature       -> feat:
bugfix        -> fix:
refactor      -> refactor:
test          -> test:
docs          -> docs:
performance   -> perf:
security      -> fix:        (with security note)

Workflow Integration

Auto-commit on Status Change

/orchestration/move TASK-003 qa --auto-commit

Automatically commits when moving to QA status.

Pre-commit Validation

/orchestration/commit --validate

Checks:

• All tests pass
• No linting errors
• Task requirements met
• Files match task scope

Options

Custom Message

/orchestration/commit TASK-003 --message "Custom commit message"

Override automatic message generation.

Scope Detection

/orchestration/commit --detect-scope

Automatically detects scope from changed files:

• auth for auth-related files
• api for API changes
• ui for frontend changes

Breaking Changes

/orchestration/commit --breaking

Adds breaking change indicator:

feat(api)!: restructure authentication endpoints

BREAKING CHANGE: Auth endpoints moved from /auth to /api/v2/auth

Batch Operations

Commit by Feature

/orchestration/commit --feature authentication

Groups all completed auth tasks into one commit.

Commit by Status

/orchestration/commit --status qa

Commits all tasks currently in QA.

Smart Grouping

/orchestration/commit --smart-group

Intelligently groups related tasks:

Feature Group: Authentication (3 tasks)
- TASK-001: Database schema
- TASK-003: JWT implementation  
- TASK-005: Login endpoint

Suggested commit: feat(auth): implement complete authentication system

Worktree Support

Worktree-Aware Commits

/orchestration/commit --worktree

Detects current worktree and commits only relevant tasks.

Cross-Worktree Status

/orchestration/commit --all-worktrees

Shows commit status across all worktrees:

Worktree Status:
- feature/auth: 2 tasks ready to commit
- feature/payments: 1 task ready to commit
- feature/ui: No uncommitted changes

Validation Features

Pre-commit Checks

## Pre-commit Validation
✓ All tests passing
✓ No linting errors
✓ Task requirements met
✗ Uncommitted files outside task scope: src/unrelated.js

Proceed with commit? [y/n]

Task Alignment

## Task Alignment Check
Changed files:
- src/auth/jwt.ts ✓ (matches TASK-003)
- src/auth/validate.ts ✓ (matches TASK-003)
- src/payments/stripe.ts ✗ (not in TASK-003 scope)

Warning: Changes outside task scope detected

Integration Features

Link to Task

/orchestration/commit --link-task

Adds task URL/reference to commit:

feat(auth): implement JWT validation

Task: TASK-003
Link: http://orchestration/03_15_2024/auth_system/tasks/TASK-003

Update Status Tracker

/orchestration/commit --update-tracker

Updates TASK-STATUS-TRACKER.yaml with commit info:

git_tracking:
  TASK-003:
    commits: ["abc123def"]
    commit_message: "feat(auth): implement JWT validation"
    committed_at: "2024-03-15T14:30:00Z"

Examples

Example 1: Simple Task Commit

/orchestration/commit TASK-003

Generated commit:
feat(auth): implement JWT token validation

- Add verification middleware
- Handle token expiration
- Implement refresh logic

Task: TASK-003 (4.5 hours)

Example 2: Batch Feature Commit

/orchestration/commit --feature authentication --batch

Grouping 3 related tasks:
feat(auth): complete authentication system implementation

- Set up database schema (TASK-001)
- Implement JWT validation (TASK-003)
- Create login endpoints (TASK-005)

Tasks: TASK-001, TASK-003, TASK-005 (12 hours total)

Example 3: Fix with Test

/orchestration/commit TASK-007

Generated commit:
fix(auth): resolve token expiration race condition

- Fix async validation timing issue
- Add comprehensive test coverage
- Prevent edge case in refresh flow

Fixes: #123
Task: TASK-007 (2 hours)

Commit Templates

Feature Template

feat(<scope>): <task-title>

- <implementation-detail-1>
- <implementation-detail-2>
- <implementation-detail-3>

Task: <task-id> (<duration>)
Status: <status-transition>

Fix Template

fix(<scope>): <issue-description>

- <root-cause>
- <solution>
- <test-coverage>

Fixes: #<issue-number>
Task: <task-id>

Best Practices

1. Commit at Natural Breakpoints: When moving tasks to QA
2. Keep Commits Atomic: One logical change per commit
3. Use Batch Wisely: Only group truly related tasks
4. Validate First: Always run validation before committing
5. Update Status: Ensure task status is current

Configuration

Auto-commit Rules

Set in orchestration config:

auto_commit:
  on_qa: true
  on_complete: false
  require_tests: true
  require_validation: true

Notes

• Integrates with task-commit-manager agent for complex scenarios
• Respects .gitignore and excluded files
• Supports conventional commits specification
• Maintains traceable history between tasks and commits