Spec

La memoria del repo pertenece al repo.

Mainline guarda engineering intent en refs y notes de Git para que la memoria sea portable, inspecciónable, local-first y legible entre proveedores de agentes.

Actor logs

refs/heads/_mainline/actor/<id>

Cada developer o agente escribe un event log append-only. Solo el actor escribe en su propio log.

Pin notes

refs/notes/mainline/intents

Cuando el código llega a main, las notes enlazan commits merged con el intent que los produjo.

Lifecycle

De drafting a memoria duradera

draftingsealed localproposedmergedreverted

Estados terminales como abandoned, superseded y reverted siguen siendo valiosos: evitan que futuros agentes revivan caminos ya rechazados.

Semantic fingerprints

Al sellar, Mainline extrae files, subsystems, API changes, behavioral changes y tags para checks de solapamiento de baja latencia.

Phase checks

Phase 1 detecta solapamientos con weighted Jaccard. Phase 2 deja que un agente juzgue conflictos semánticos cuando hace falta.

Hub

La superficie humana muestra pending work, restricciones por archivo, decisiones, riesgos y coverage gaps.

Config

Los repos configuran main branch, actor-log prefix, skip patterns, sync freshness, check thresholds y merge strategy.