GitHub Integration - Bi-directional Sync & GitHub App

[nathanclevenger]

Build GitHub App for automatic bi-directional sync between ROADMAP.md files and GitHub Issues/Projects.

Part of: ROADMAP.md Package v1.0 (#46)

Due Date: 2025-10-24

Tasks

• Design GitHub App architecture
• Implement webhook handlers (push, issues, PR)
• Create bi-directional sync (ROADMAP ↔ Issues)
• Add project board integration
• Implement label management
• Create GitHub Action workflow
• Test with real repositories

Architecture

GitHub App Components

• Cloudflare Worker for webhook handling
• KV storage for sync state
• Octokit for GitHub API
• JWT authentication

Webhook Handlers

• Push events: Sync ROADMAP.md changes → create/update issues
• Issue events: Sync issue state → update ROADMAP.md
• PR events: Validate ROADMAP.md, preview changes

Sync Features

• Create epic issues for campaigns
• Create sub-issues for workstreams
• Update task completion status
• Sync labels (priority, status)
• Link issues bidirectionally

Resources

• 📄 Design Doc: `ai/packages/roadmap.md/GITHUB_APP.md`
• 🔧 GitHub API: https://docs.github.com/en/rest
• ⚙️ Workers: https://workers.cloudflare.com

---

Generated from ROADMAP.md

[linear]

PLAT-7