Documentación

multivac (alias de la CLI mvac) es una herramienta de desarrollo guiado por el brain: un único repo brain — afirmaciones (claims), ley y ritual — desde el cual se desarrolla todo un ecosistema de repos de código. Entras al brain, y el cambio fluye hacia los repos que la funcionalidad toque. El núcleo es determinista: sin clave de API, sin red, sin llamadas a un modelo en la ruta de verificación.

La herramienta no es un generador de documentación. Si desarrollas desde el brain, un brain que miente no produce documentación fea: produce código con total seguridad equivocado en N repos. La verificación es la condición previa; el producto es el cambio.

Los cuatro trabajos

1. Cambiar — el cambio del ecosistema, planificado y ejecutado desde el brain. El verbo al que sirven los otros tres.
2. Verificar — las afirmaciones del brain contrastadas con el código, de forma determinista.
3. Proyectar — una puerta canónica (AGENTS.md), proyectada al formato de cada harness.
4. Distribuir — cómo el brain llega a los repos consumidores, con pin, y con la desactualización visible en lugar de silenciosa.

Tres secciones y el changelog

Por dónde empezar

• ¿Eres nuevo aquí? Filosofía — el problema que esto existe para resolver, en una página.
• ¿Quieres verlo funcionando? Instalación, luego Primeros pasos.
• ¿Buscas un flag o una clave? Comandos y Configuración.
• ¿Conectas un agente? Integraciones de agentes y Hooks.

Conceptos está escrito en orden de dependencia:

1. Filosofía — por qué una paráfrasis envejece en silencio y una cita no; quién propone, quién promulga.
2. Desarrollo guiado por el brain — la práctica: el repo brain, sus tres capas y cómo se aplica el cumplimiento.
3. Afirmaciones y anclas — la unidad de verdad y la gramática que la verifica.
4. El cambio — el ciclo de vida del cambio entre repos.
5. Invariantes — cómo la ley nace, se enmienda y se retira.
6. Distribución — montajes, pins, puertas y skills.
7. Adopción — el arco desde init hasta el estado estable, qué fase aporta qué, y cómo cambia el camino según la forma en que te encuentres.
8. Composición — por qué se construye sobre las herramientas guiadas por especificaciones en lugar de competir con ellas, y por qué multivac no guarda un grafo de código.