Sync

Commands orchestration 178

Install Command

npx claude-code-templates@latest --command orchestration/sync

View on GitHub

Content

Orchestration Sync Command

Synchronize task status with git commits, ensuring consistency between version control and task tracking.

Usage

/orchestration/sync [options]

Description

Analyzes git history and task status to identify discrepancies, automatically updating task tracking based on commit evidence and maintaining bidirectional consistency.

Basic Commands

Full Sync

/orchestration/sync

Performs complete synchronization between git and task status.

Check Sync Status

/orchestration/sync --check

Reports inconsistencies without making changes.

Sync Specific Orchestration

/orchestration/sync --date 03_15_2024 --project auth_system

Sync Operations

Git → Task Status

Updates task status based on commit messages:

Found commits:
- feat(auth): implement JWT validation (TASK-003) ✓
  Status: in_progress → qa (based on commit)
  
- test(auth): add JWT validation tests (TASK-003) ✓
  Status: qa → completed (tests indicate completion)
  
- fix(auth): resolve token expiration (TASK-007) ✓
  Status: todos → in_progress (work started)

Task Status → Git

Identifies tasks marked complete without commits:

Status Discrepancies:
- TASK-005: Marked 'completed' but no commits found
- TASK-008: In 'qa' but no implementation commits
- TASK-010: Multiple commits but still in 'todos'

Detection Patterns

Commit Pattern Matching

Patterns detected:
- "feat(auth): implement" → Implementation complete
- "test(auth): add" → Testing phase
- "fix(auth): resolve" → Bug fix complete
- "docs(auth): update" → Documentation done
- "refactor(auth):" → Code improvement

Task Reference Extraction

Scanning commits for task references:
- Explicit: "Task: TASK-003" ✓
- In body: "Implements TASK-003" ✓
- Branch name: "feature/TASK-003-jwt" ✓
- PR title: "TASK-003: JWT implementation" ✓

Sync Rules

Automatic Status Updates

yaml

sync_rules:
  commit_patterns:
    - pattern: "feat.*TASK-(\d+)"
      action: "move to qa if in_progress"
    - pattern: "test.*TASK-(\d+).*pass"
      action: "move to completed if in qa"
    - pattern: "fix.*TASK-(\d+)"
      action: "move to qa if in_progress"
    - pattern: "WIP.*TASK-(\d+)"
      action: "keep in in_progress"

Conflict Resolution

Conflict detected for TASK-003:
- Git evidence: 3 commits, tests passing
- Task status: in_progress
- Recommended: Move to completed

Resolution options:
[1] Trust git (move to completed)
[2] Trust tracker (keep in_progress)
[3] Manual review
[4] Skip

Analysis Reports

Sync Summary

Synchronization Report
======================

Analyzed: 45 commits across 3 branches
Tasks referenced: 12
Status updates needed: 4

Updates to apply:
- TASK-003: in_progress → completed (3 commits)
- TASK-007: todos → in_progress (1 commit)
- TASK-009: qa → completed (tests added)
- TASK-011: on_hold → in_progress (blocker resolved)

Warnings:
- TASK-005: Completed without commits
- TASK-013: Commits without task reference

Detailed Analysis

Task: TASK-003 - JWT Implementation
Current Status: in_progress
Git Evidence:
  - feat(auth): implement JWT validation (2 days ago)
  - test(auth): add validation tests (1 day ago)
  - fix(auth): handle edge cases (1 day ago)
  
Recommendation: Move to completed
Confidence: High (95%)

Options

Dry Run

/orchestration/sync --dry-run

Shows what would change without applying updates.

Force Sync

/orchestration/sync --force

Applies all recommendations without prompting.

Time Range

/orchestration/sync --since "1 week ago"

Only analyzes recent commits.

Branch Specific

/orchestration/sync --branch feature/auth

Syncs only tasks related to specific branch.

Integration Features

Update Tracking Files

/orchestration/sync --update-trackers

Updates TASK-STATUS-TRACKER.yaml with:

yaml

git_tracking:
  TASK-003:
    status_from_git: completed
    confidence: 0.95
    evidence:
      - commit: abc123
        message: "feat(auth): implement JWT"
        date: "2024-03-13"
      - commit: def456
        message: "test(auth): add tests"
        date: "2024-03-14"

Generate Commit Report

/orchestration/sync --commit-report

Creates report of all task-related commits.

Fix Orphaned Commits

/orchestration/sync --link-orphans

Associates commits without task references.

Sync Strategies

Conservative

/orchestration/sync --conservative

Only updates with high confidence matches.

Aggressive

/orchestration/sync --aggressive

Updates based on any evidence.

Interactive

/orchestration/sync --interactive

Prompts for each potential update.

Examples

Example 1: Daily Sync

/orchestration/sync --since yesterday

Quick sync results:
- 5 commits analyzed
- 2 tasks updated
- All changes applied successfully

Example 2: Branch Merge Sync

/orchestration/sync --after-merge feature/auth

Post-merge sync:
- 15 commits from feature/auth
- 5 tasks moved to completed
- 2 tasks have test failures (kept in qa)

Example 3: Audit Mode

/orchestration/sync --audit --report

Audit Report:
- Tasks with commits: 85%
- Commits with task refs: 92%
- Average commits per task: 2.3
- Orphaned commits: 3

Webhook Integration

Auto-sync on Push

yaml

git_hooks:
  post-commit: /orchestration/sync --last-commit
  post-merge: /orchestration/sync --branch HEAD

Best Practices

Regular Syncs: Run daily or after major commits
Review Before Force: Check dry-run output first
Maintain References: Include task IDs in commits
Handle Conflicts: Don't ignore sync warnings
Document Decisions: Note why status differs from git

Configuration

Sync Preferences

yaml

sync_config:
  auto_sync: true
  confidence_threshold: 0.8
  require_tests: true
  trust_git_over_tracker: true
  patterns:
    - implementation: "feat|feature"
    - testing: "test|spec"
    - completion: "done|complete|finish"

Notes

Requires git access to all relevant branches
Preserves manual status overrides with flags
Supports custom commit message patterns
Integrates with CI/CD for automated syncing

Sync

Content

Orchestration Sync Command

Usage

Description

Basic Commands

Full Sync

Check Sync Status

Sync Specific Orchestration

Sync Operations

Git → Task Status

Task Status → Git

Detection Patterns

Commit Pattern Matching

Task Reference Extraction

Sync Rules

Automatic Status Updates

Conflict Resolution

Analysis Reports

Sync Summary

Detailed Analysis

Options

Dry Run

Force Sync

Time Range

Branch Specific

Integration Features

Update Tracking Files

Generate Commit Report

Fix Orphaned Commits

Sync Strategies

Conservative

Aggressive

Interactive

Examples

Example 1: Daily Sync

Example 2: Branch Merge Sync

Example 3: Audit Mode

Webhook Integration

Auto-sync on Push

Best Practices

Configuration

Sync Preferences

Notes

Stack Builder