# Design: GitHub-as-Single-Source-of-Truth Orchestration

**Date**: 2026-02-17
**Session**: 027
**Status**: APPROVED — Executing

## Problem

GitHub account was previously flagged, blocking all advanced features (Projects V2, branch protection, Copilot agent). Now unflagged and upgraded to Pro. Need to fully leverage GitHub as the single source of truth for project management, CI/CD, issue tracking, and deployment orchestration.

## Requirements

### Functional
- All project tracking in GitHub (issues, projects, milestones)
- Branch protection enforcing PR workflow and CI gates
- Enhanced CI/CD with full test coverage reporting
- Cloud-ready deployment (K8s manifests, portable VPS setup)
- Self-contained repo (deployable from scratch on any server)

### Non-Functional
- Zero legacy debt
- Open-source first (build vs buy)
- AI-first architecture
- Full session continuity (Claude + Cursor harmony)

## Workstreams

### 1. Deferred Item Resolution
Resolve all 6 blocked items now that GitHub is unflagged + Pro.

### 2. GitHub Issues Cleanup
Close ~20+ completed Phase 2 issues, deduplicate, add missing labels.

### 3. GitHub Projects V2 Board
Full project board with custom fields, multiple views, automation.

### 4. Branch Protection
Main branch ruleset: PR required, CI checks, no force push.

### 5. Enhanced CI/CD
Dependabot, auto-labeling, stale issue management.

### 6. Cloud-Readiness
K8s Helm chart skeleton, VPS bootstrap script.

### 7. Memory & Grounding Sync
Update all memory files, grounding, Cursor rules.

### 8. Core Tenets
Embed operating principles in CLAUDE.md, Cursor rules, memory.

## Implementation

Parallel agent teams executing all workstreams simultaneously.
