Memoria antes de editar
Los agentes leen decisiones, riesgos, restricciones y anti-patterns antes de cambios no triviales.
Memoria de intención nativa en Git
Evita que los coding agents repitan errores de ingeniería.
Mainline da a los agentes de código el porqué histórico antes de editar lo que existe hoy: enfoques abandonados, decisiones superadas, restricciones de review, riesgos e intenciones en curso.
Instalar
curl -fsSL https://raw.githubusercontent.com/mainline-org/mainline/main/install.sh | bash $ mainline context --current --json
{
"anti_patterns": [
{
"what": "no eliminar legacy /oauth",
"why": "los callbacks OAuth aún requieren session state",
"severity": "high"
}
],
"risks": ["la migración de billing aún puede duplicar eventos"]
}Intent sealed
Reemplazar auth de sesión con JWT
- Decisión
- JWT sin estado para mobile
- Rechazado
- Eliminar middleware OAuth
- Pin
- refs/notes/mainline/intents
0
violaciones de forbidden-list en ejecuciones intent-first
9
violaciones de agentes code-first en los mismos escenarios
Git
guarda memoria del repo en refs y notes, no en el workspace de un proveedor
El fallo
Código razonable. Razón histórica equivocada.
Un agente puede buscar en el repo, ver un TODO y terminar una cola Redis a medio hacer. Pero si el equipo ya abandonó Redis por eventos duplicados de billing, esa es la acción equivocada.
La búsqueda de código dice qué existe ahora. Mainline registra la memoria de decisiones que explica que no debe repetirse.
Intent para review
Reviewers comparan la implementación contra el porqué declarado, no contra una intención inferida desde el diff.
Governance de intent
Los equipos ven coverage gaps, intents de baja calidad, cambios riesgosos y trabajo en curso que se solapa.
Memoria a largo plazo
Futuros maintainers saben que se intentó, que se abandonó, que se sustituyó y que commits lo implementaron.
Loop del agente
Leer intent previo. Hacer el cambio. Registrar nuevo intent.
mainline context --current --jsonRecupera memoria del repo antes de editar.mainline start "Add JWT auth"Declara una unidad real de trabajo.mainline append "Implemented middleware"Registra decisiones, pivots y riesgos.mainline sealPreserva el registro duradero de decisión.
Para solo builders
Conserva continuidad entre agentes, ramas y futuras sesiones. Tu siguiente agente debe saber por qué el anterior abandonó un enfoque.
Para equipos
Comparte la verdad del repo antes del review: proposed work, restricciones por archivo, open risks e intent coverage.
Public alpha
Los coding agents deben heredar memoria de ingeniería.
Mainline ya es usable por equipos tempranos que quieren memoria del repo, nativa en Git, antes de que cambios generados por agentes lleguen a review.