davila7__claude-code-templates/dashboard/public/component-content/commands/orchestration/commit.json

{"content": "# Orchestration Commit Command\n\nCreate git commits aligned with task completion, maintaining clean version control synchronized with task progress.\n\n## Usage\n\n```\n/orchestration/commit [TASK-ID] [options]\n```\n\n## Description\n\nAutomatically creates well-structured commits when tasks move to QA or completion, using task metadata to generate meaningful commit messages following Conventional Commits specification.\n\n## Basic Commands\n\n### Commit Current Task\n```\n/orchestration/commit\n```\nCommits changes for the task currently in progress.\n\n### Commit Specific Task\n```\n/orchestration/commit TASK-003\n```\nCommits changes related to a specific task.\n\n### Batch Commit\n```\n/orchestration/commit --batch\n```\nGroups related completed tasks into logical commits.\n\n## Commit Message Generation\n\n### Automatic Format\nBased on task type and content:\n```\nfeat(auth): implement JWT token validation\n\n- Add token verification middleware\n- Implement refresh token logic\n- Add expiration handling\n\nTask: TASK-003\nStatus: todos -> in_progress -> qa\nTime: 4.5 hours\n```\n\n### Type Mapping\n```\nTask Type     -> Commit Type\n━━━━━━━━━━━━━━━━━━━━━━━━━━━\nfeature       -> feat:\nbugfix        -> fix:\nrefactor      -> refactor:\ntest          -> test:\ndocs          -> docs:\nperformance   -> perf:\nsecurity      -> fix:        (with security note)\n```\n\n## Workflow Integration\n\n### Auto-commit on Status Change\n```\n/orchestration/move TASK-003 qa --auto-commit\n```\nAutomatically commits when moving to QA status.\n\n### Pre-commit Validation\n```\n/orchestration/commit --validate\n```\nChecks:\n- All tests pass\n- No linting errors\n- Task requirements met\n- Files match task scope\n\n## Options\n\n### Custom Message\n```\n/orchestration/commit TASK-003 --message \"Custom commit message\"\n```\nOverride automatic message generation.\n\n### Scope Detection\n```\n/orchestration/commit --detect-scope\n```\nAutomatically detects scope from changed files:\n- `auth` for auth-related files\n- `api` for API changes\n- `ui` for frontend changes\n\n### Breaking Changes\n```\n/orchestration/commit --breaking\n```\nAdds breaking change indicator:\n```\nfeat(api)!: restructure authentication endpoints\n\nBREAKING CHANGE: Auth endpoints moved from /auth to /api/v2/auth\n```\n\n## Batch Operations\n\n### Commit by Feature\n```\n/orchestration/commit --feature authentication\n```\nGroups all completed auth tasks into one commit.\n\n### Commit by Status\n```\n/orchestration/commit --status qa\n```\nCommits all tasks currently in QA.\n\n### Smart Grouping\n```\n/orchestration/commit --smart-group\n```\nIntelligently groups related tasks:\n```\nFeature Group: Authentication (3 tasks)\n- TASK-001: Database schema\n- TASK-003: JWT implementation  \n- TASK-005: Login endpoint\n\nSuggested commit: feat(auth): implement complete authentication system\n```\n\n## Worktree Support\n\n### Worktree-Aware Commits\n```\n/orchestration/commit --worktree\n```\nDetects current worktree and commits only relevant tasks.\n\n### Cross-Worktree Status\n```\n/orchestration/commit --all-worktrees\n```\nShows commit status across all worktrees:\n```\nWorktree Status:\n- feature/auth: 2 tasks ready to commit\n- feature/payments: 1 task ready to commit\n- feature/ui: No uncommitted changes\n```\n\n## Validation Features\n\n### Pre-commit Checks\n```\n## Pre-commit Validation\n✓ All tests passing\n✓ No linting errors\n✓ Task requirements met\n✗ Uncommitted files outside task scope: src/unrelated.js\n\nProceed with commit? [y/n]\n```\n\n### Task Alignment\n```\n## Task Alignment Check\nChanged files:\n- src/auth/jwt.ts ✓ (matches TASK-003)\n- src/auth/validate.ts ✓ (matches TASK-003)\n- src/payments/stripe.ts ✗ (not in TASK-003 scope)\n\nWarning: Changes outside task scope detected\n```\n\n## Integration Features\n\n### Link to Task\n```\n/orchestration/commit --link-task\n```\nAdds task URL/reference to commit:\n```\nfeat(auth): implement JWT validation\n\nTask: TASK-003\nLink: http://orchestration/03_15_2024/auth_system/tasks/TASK-003\n```\n\n### Update Status Tracker\n```\n/orchestration/commit --update-tracker\n```\nUpdates TASK-STATUS-TRACKER.yaml with commit info:\n```yaml\ngit_tracking:\n  TASK-003:\n    commits: [\"abc123def\"]\n    commit_message: \"feat(auth): implement JWT validation\"\n    committed_at: \"2024-03-15T14:30:00Z\"\n```\n\n## Examples\n\n### Example 1: Simple Task Commit\n```\n/orchestration/commit TASK-003\n\nGenerated commit:\nfeat(auth): implement JWT token validation\n\n- Add verification middleware\n- Handle token expiration\n- Implement refresh logic\n\nTask: TASK-003 (4.5 hours)\n```\n\n### Example 2: Batch Feature Commit\n```\n/orchestration/commit --feature authentication --batch\n\nGrouping 3 related tasks:\nfeat(auth): complete authentication system implementation\n\n- Set up database schema (TASK-001)\n- Implement JWT validation (TASK-003)\n- Create login endpoints (TASK-005)\n\nTasks: TASK-001, TASK-003, TASK-005 (12 hours total)\n```\n\n### Example 3: Fix with Test\n```\n/orchestration/commit TASK-007\n\nGenerated commit:\nfix(auth): resolve token expiration race condition\n\n- Fix async validation timing issue\n- Add comprehensive test coverage\n- Prevent edge case in refresh flow\n\nFixes: #123\nTask: TASK-007 (2 hours)\n```\n\n## Commit Templates\n\n### Feature Template\n```\nfeat(<scope>): <task-title>\n\n- <implementation-detail-1>\n- <implementation-detail-2>\n- <implementation-detail-3>\n\nTask: <task-id> (<duration>)\nStatus: <status-transition>\n```\n\n### Fix Template\n```\nfix(<scope>): <issue-description>\n\n- <root-cause>\n- <solution>\n- <test-coverage>\n\nFixes: #<issue-number>\nTask: <task-id>\n```\n\n## Best Practices\n\n1. **Commit at Natural Breakpoints**: When moving tasks to QA\n2. **Keep Commits Atomic**: One logical change per commit\n3. **Use Batch Wisely**: Only group truly related tasks\n4. **Validate First**: Always run validation before committing\n5. **Update Status**: Ensure task status is current\n\n## Configuration\n\n### Auto-commit Rules\nSet in orchestration config:\n```yaml\nauto_commit:\n  on_qa: true\n  on_complete: false\n  require_tests: true\n  require_validation: true\n```\n\n## Notes\n\n- Integrates with task-commit-manager agent for complex scenarios\n- Respects .gitignore and excluded files\n- Supports conventional commits specification\n- Maintains traceable history between tasks and commits"}