Spec

Repo memory belongs to the repo.

Mainline stores engineering intent in Git refs and notes so the memory is portable, inspectable, local-first, and readable across agent vendors.

Actor logs

refs/heads/_mainline/actor/<id>

Each developer or agent writes an append-only event log. Only the actor writes to its own log.

Pin notes

refs/notes/mainline/intents

When code lands on main, notes link merged commits back to the intent that produced them.

Lifecycle

Drafting to durable memory

draftingsealed localproposedmergedreverted

Terminal states such as abandoned, superseded, and reverted remain valuable: they prevent future agents from reviving a path the team already rejected.

Semantic fingerprints

Seal time extracts files, subsystems, API changes, behavioral changes, and tags for low-latency overlap checks.

Phase checks

Phase 1 screens overlaps with weighted Jaccard similarity. Phase 2 lets an agent judge semantic conflicts when needed.

Hub

The human reading surface shows pending work, file constraints, decisions, risks, and coverage gaps.

Config

Repos configure main branch, actor-log prefix, skip patterns, sync freshness, check thresholds, and merge strategy.