Primary owner + branch contributor model

Two-Machine Claude Code Architecture

One private GitHub repo is the shared brain. Text flows through git. The multi-terabyte media library never touches git.

GitHub Private Brain Repo Single source of truth for the text brain main branch · protected · PR-only PRIMARY MACHINE The owner of main Read + write credential Reviews and merges pull requests Only machine that lands changes on main Runs Claude Code locally SECONDARY MACHINE The contributor Repo-scoped credential Pulls the latest brain Works on branches, opens PRs Never writes to main directly Cloud Object Storage Several terabytes of video and working files Never enters git The repo stores pointers and manifests, not media push branch merge PR to main push branch, open PR pull (read updates) Media synced or mounted directly, outside git
Git path (text brain)Notes, context, CLAUDE.md, skills, hooks. Small, versioned, conflict-friendly. This is what both machines share.
Primary roleHolds write access, reviews and merges every pull request, is the only machine that changes main.
Secondary rolePulls the brain, does work on feature branches, opens pull requests for the primary to approve.
Asset path (media)Terabytes of video live in cloud storage. Synced or mounted per machine. Git only holds pointers.
The one rule that makes this work

The text brain flows through git and stays identical on both machines. The media library never touches git. Keep those two lanes separate and the whole system stays fast, cheap, and recoverable.