knowledge-genome-orchestrator/templates/readme-master.md

{{MASTER_REPO}}

Master (umbrella) repository for the Knowledge Genome network.

Field	Value
Owner	{{FORGEJO_USER}}
Remote	{{FORGEJO_URL}}/{{FORGEJO_USER}}/{{MASTER_REPO}}
Scaffolded	{{DATE}}

What this repo is

This repository does not hold knowledge itself. It is the orchestrator: each genome is a Git submodule, plus core-karpathy as a read-only reference pattern. Cross-genome coordination rules live in AGENTS.md.

{{MASTER_REPO}}/
├── core-karpathy/   ← reference pattern — read-only, never modify
├── genome-*/        ← one submodule per genome (own AGENTS.md, own git-crypt)
└── AGENTS.md        ← cross-genome coordinator (boundaries only)

Working with submodules

# Clone with all genomes
git clone --recurse-submodules {{FORGEJO_URL}}/{{FORGEJO_USER}}/{{MASTER_REPO}}.git

# Pull the latest pointers for every genome
git submodule update --remote --merge

# Operate inside a single genome (one genome at a time — see AGENTS.md)
cd genome-<name>

Rules of the road

• Operate within one genome at a time; no commits spanning multiple genomes.
• core-karpathy is read-only.
• Never commit to main in a genome — PRs only, no self-merge.
• Private data (**/private/**) is git-crypt encrypted and never leaves the local network.

Genome-level operations are governed by each genome's own AGENTS.md. This README and the master AGENTS.md govern boundaries only.