github-sync

1# GitHub Sync
2 
3Bidirectional synchronization of epics and tasks with GitHub issues, labels, and relationships.
4 
5## Agent
6Project Tracker - `project-tracker`
7 
8## Workflow
91. Create epic issue with `epic` and `ccpm` labels
102. Create task issues linked to epic with stream-type labels
113. Add acceptance criteria as checkboxes in issue body
124. Set issue relationships (parent/child)
135. Sync progress updates as issue comments
146. Close issues when tasks complete
157. Maintain bidirectional sync state
16 
17## Inputs
18- `githubRepo` - GitHub repository (owner/repo)
19- `featureName` - Feature identifier
20- `epic` - Epic document
21- `tasks` - Task list from decomposition
22 
23## Outputs
24- Epic issue number
25- Task issue numbers with ID mapping
26- Labels applied
27- Sync status report
28 
29## Issue States
30`open` -> `in-progress` -> `blocked` -> `review` -> `closed`
31 
32## Process Files
33- `ccpm-orchestrator.js` - Phase 4 of full lifecycle
34- `ccpm-parallel-execution.js` - Progress sync during execution
35- `ccpm-tracking.js` - Tracking data sync