davila7--claude-code-templates
wehub-resource-sync
1 行
6.5 KiB
JSON
1 行
6.5 KiB
JSON
{"content": "# Orchestration Sync Command\n\nSynchronize task status with git commits, ensuring consistency between version control and task tracking.\n\n## Usage\n\n```\n/orchestration/sync [options]\n```\n\n## Description\n\nAnalyzes git history and task status to identify discrepancies, automatically updating task tracking based on commit evidence and maintaining bidirectional consistency.\n\n## Basic Commands\n\n### Full Sync\n```\n/orchestration/sync\n```\nPerforms complete synchronization between git and task status.\n\n### Check Sync Status\n```\n/orchestration/sync --check\n```\nReports inconsistencies without making changes.\n\n### Sync Specific Orchestration\n```\n/orchestration/sync --date 03_15_2024 --project auth_system\n```\n\n## Sync Operations\n\n### Git → Task Status\nUpdates task status based on commit messages:\n```\nFound commits:\n- feat(auth): implement JWT validation (TASK-003) ✓\n Status: in_progress → qa (based on commit)\n \n- test(auth): add JWT validation tests (TASK-003) ✓\n Status: qa → completed (tests indicate completion)\n \n- fix(auth): resolve token expiration (TASK-007) ✓\n Status: todos → in_progress (work started)\n```\n\n### Task Status → Git\nIdentifies tasks marked complete without commits:\n```\nStatus Discrepancies:\n- TASK-005: Marked 'completed' but no commits found\n- TASK-008: In 'qa' but no implementation commits\n- TASK-010: Multiple commits but still in 'todos'\n```\n\n## Detection Patterns\n\n### Commit Pattern Matching\n```\nPatterns detected:\n- \"feat(auth): implement\" → Implementation complete\n- \"test(auth): add\" → Testing phase\n- \"fix(auth): resolve\" → Bug fix complete\n- \"docs(auth): update\" → Documentation done\n- \"refactor(auth):\" → Code improvement\n```\n\n### Task Reference Extraction\n```\nScanning commits for task references:\n- Explicit: \"Task: TASK-003\" ✓\n- In body: \"Implements TASK-003\" ✓\n- Branch name: \"feature/TASK-003-jwt\" ✓\n- PR title: \"TASK-003: JWT implementation\" ✓\n```\n\n## Sync Rules\n\n### Automatic Status Updates\n```yaml\nsync_rules:\n commit_patterns:\n - pattern: \"feat.*TASK-(\\d+)\"\n action: \"move to qa if in_progress\"\n - pattern: \"test.*TASK-(\\d+).*pass\"\n action: \"move to completed if in qa\"\n - pattern: \"fix.*TASK-(\\d+)\"\n action: \"move to qa if in_progress\"\n - pattern: \"WIP.*TASK-(\\d+)\"\n action: \"keep in in_progress\"\n```\n\n### Conflict Resolution\n```\nConflict detected for TASK-003:\n- Git evidence: 3 commits, tests passing\n- Task status: in_progress\n- Recommended: Move to completed\n\nResolution options:\n[1] Trust git (move to completed)\n[2] Trust tracker (keep in_progress)\n[3] Manual review\n[4] Skip\n```\n\n## Analysis Reports\n\n### Sync Summary\n```\nSynchronization Report\n======================\n\nAnalyzed: 45 commits across 3 branches\nTasks referenced: 12\nStatus updates needed: 4\n\nUpdates to apply:\n- TASK-003: in_progress → completed (3 commits)\n- TASK-007: todos → in_progress (1 commit)\n- TASK-009: qa → completed (tests added)\n- TASK-011: on_hold → in_progress (blocker resolved)\n\nWarnings:\n- TASK-005: Completed without commits\n- TASK-013: Commits without task reference\n```\n\n### Detailed Analysis\n```\nTask: TASK-003 - JWT Implementation\nCurrent Status: in_progress\nGit Evidence:\n - feat(auth): implement JWT validation (2 days ago)\n - test(auth): add validation tests (1 day ago)\n - fix(auth): handle edge cases (1 day ago)\n \nRecommendation: Move to completed\nConfidence: High (95%)\n```\n\n## Options\n\n### Dry Run\n```\n/orchestration/sync --dry-run\n```\nShows what would change without applying updates.\n\n### Force Sync\n```\n/orchestration/sync --force\n```\nApplies all recommendations without prompting.\n\n### Time Range\n```\n/orchestration/sync --since \"1 week ago\"\n```\nOnly analyzes recent commits.\n\n### Branch Specific\n```\n/orchestration/sync --branch feature/auth\n```\nSyncs only tasks related to specific branch.\n\n## Integration Features\n\n### Update Tracking Files\n```\n/orchestration/sync --update-trackers\n```\nUpdates TASK-STATUS-TRACKER.yaml with:\n```yaml\ngit_tracking:\n TASK-003:\n status_from_git: completed\n confidence: 0.95\n evidence:\n - commit: abc123\n message: \"feat(auth): implement JWT\"\n date: \"2024-03-13\"\n - commit: def456\n message: \"test(auth): add tests\"\n date: \"2024-03-14\"\n```\n\n### Generate Commit Report\n```\n/orchestration/sync --commit-report\n```\nCreates report of all task-related commits.\n\n### Fix Orphaned Commits\n```\n/orchestration/sync --link-orphans\n```\nAssociates commits without task references.\n\n## Sync Strategies\n\n### Conservative\n```\n/orchestration/sync --conservative\n```\nOnly updates with high confidence matches.\n\n### Aggressive\n```\n/orchestration/sync --aggressive\n```\nUpdates based on any evidence.\n\n### Interactive\n```\n/orchestration/sync --interactive\n```\nPrompts for each potential update.\n\n## Examples\n\n### Example 1: Daily Sync\n```\n/orchestration/sync --since yesterday\n\nQuick sync results:\n- 5 commits analyzed\n- 2 tasks updated\n- All changes applied successfully\n```\n\n### Example 2: Branch Merge Sync\n```\n/orchestration/sync --after-merge feature/auth\n\nPost-merge sync:\n- 15 commits from feature/auth\n- 5 tasks moved to completed\n- 2 tasks have test failures (kept in qa)\n```\n\n### Example 3: Audit Mode\n```\n/orchestration/sync --audit --report\n\nAudit Report:\n- Tasks with commits: 85%\n- Commits with task refs: 92%\n- Average commits per task: 2.3\n- Orphaned commits: 3\n```\n\n## Webhook Integration\n\n### Auto-sync on Push\n```yaml\ngit_hooks:\n post-commit: /orchestration/sync --last-commit\n post-merge: /orchestration/sync --branch HEAD\n```\n\n## Best Practices\n\n1. **Regular Syncs**: Run daily or after major commits\n2. **Review Before Force**: Check dry-run output first\n3. **Maintain References**: Include task IDs in commits\n4. **Handle Conflicts**: Don't ignore sync warnings\n5. **Document Decisions**: Note why status differs from git\n\n## Configuration\n\n### Sync Preferences\n```yaml\nsync_config:\n auto_sync: true\n confidence_threshold: 0.8\n require_tests: true\n trust_git_over_tracker: true\n patterns:\n - implementation: \"feat|feature\"\n - testing: \"test|spec\"\n - completion: \"done|complete|finish\"\n```\n\n## Notes\n\n- Requires git access to all relevant branches\n- Preserves manual status overrides with flags\n- Supports custom commit message patterns\n- Integrates with CI/CD for automated syncing"} |