prepare_change
Restricciones, riesgos, evidencia y autoridad antes del cambio.
LISTOContexto de decisiones para agentes / local-first
Deja de repetirle tus reglas de negocio a la IA.
Rationale guarda las decisiones detrás de tu código para que una conversación nueva las recupere antes de cambiar algo importante.
Git + Codebase Memory · Sin cuenta · Aprobación humana
Cambio activo / demostración sintéticarevisión 2f6d1e4
Cambiar
El agente modifica el código con el porqué visible.
OBSERVADOfinalize_change
Se capturan hechos observados. Aquí no se aprueba ninguna decisión.
ESPERAAprobación humana
Una persona aprueba, corrige, disputa, revoca o supersede.
HUMANOEl packet viaja con el cambio. La frontera de aprobación permanece visible.
El modo de fallo
Explicaste la regla. El siguiente chat nunca la escuchó.
“No envíes mientras la carga siga ejecutándose.”
Funciona en la conversación del lunes. Tres días después, un agente nuevo solo ve el código, quita la valla y llama a la modificación una mejora.
Rationale mantiene la regla junto al código que gobierna.
Tres sistemas / una frontera más clara
La estructura dice dónde. Git dice qué. Rationale protege por qué.
Instala primero Codebase Memory para cobertura estructural. Rationale es opcional, local y honesto cuando el proveedor no está disponible.
01 / GIT
Git
¿Qué cambió, cuándo y en qué revisión?
02 / STRUCTURE
Codebase Memory ↗
¿Dónde está y cómo se conecta?
03 / CAUSAL
Rationale
¿Por qué existe, qué debe sobrevivir y quién lo aprobó?
El rail de despacho
El agente recibe contexto antes de ponerse creativo.
Localiza con Codebase Memory, prepara con Rationale, haz el cambio, captura lo ocurrido y deja la aprobación en manos de una persona.
01
Preparar
Capturar el porqué antes de mover código.
02
Cambiar
Hacer el cambio con las restricciones a la vista.
03
Finalizar
Agrupar el diff y los hechos observados.
04
Revisar
Confirmar la decisión con autoridad explícita.
$ rationale prepare src/retry/policy.ts → packet ready
El artefacto
Haz imposible perder el contexto.
Un packet compacto le da al agente la decisión, los trade-offs y la evidencia antes de que intente simplificar algo.
.rationale/subjects/retry-policy.yaml
Backoff exponencial para reintentos salientes
- why_it_matters
- Reduce fallas en cascada ante errores transitorios del upstream.
- decision
- Usar backoff exponencial con jitter. Límite de 30s, 5 intentos.
- trade-offs
- Mayor latencia de cola vs. mejor tasa de éxito y estabilidad.
- authority
- platform / human review
- evidence
- ADR-042 · incident-2024-04-11
observed · bound to src/retry/policy.ts · reviewed 2024-05-17
src/retry/policy.ts
+48 / −17
El cambio se puede leer junto a la razón por la que existe.
42export function retry(request) {
43- return send(request, RETRY_DELAY_MS)
43+ return sendWithBackoff(request, jitter)
44+ // see: .rationale/records/retry-policy.yaml
+ export const MAX_ATTEMPTS = 5
+ export const BASE_DELAY_MS = 250
− export const RETRY_DELAY_MS = 500
Dónde el contexto se paga solo
Cuatro momentos normales. Una cosa menos que explicar.
01 / ONBOARDING
Abrir una conversación nueva con el agente
Las reglas que tu equipo ya decidió sobreviven al chat que abriste hoy.
02 / REFACTOR
Refactorizar sin quitar la valla
Una rama extraña recibe explicación antes de convertirse en una regresión.
03 / REVIEW
Revisar el cambio con su porqué adjunto
Ves la restricción, evidencia, autoridad y revisión sin reconstruir la historia de memoria.
04 / TEAM
Mantener las reglas de negocio con el código
La razón queda versionada, revisable y disponible aunque la persona que la explicó cambie de equipo.
Inicio rápido / por agente
Elige tu agente y empieza con una acción concreta.
Claude Code recibe comandos instalados por Rationale. En Codex, pide la misma intención por escrito: las herramientas MCP hacen el trabajo y la aprobación sigue siendo humana.
Ver agentes y MCP en los docs →Claude Code
Slash commands instalados
/rationale-preflight <target> <intent>/rationale-explain <target>/rationale-capture [statement]/rationale-health/rationale-protocol/rationale-review`/rationale-review` es intencionalmente humano: el agente no puede autoaprobar.
Codex
Pídelo por escrito
“Prepara este cambio con Rationale para `<target>` con intención `<intent>`.”
“Explícame `<target>` antes de modificarlo.”
“Captura y finaliza este cambio con Rationale.”
“Comprueba la salud de Rationale.”
No se anuncian slash commands ficticios: Codex recibe instrucciones en `AGENTS.md` y llama las herramientas MCP disponibles.
Documentación / empieza por el trabajo
Todo lo necesario para verificar el claim.
Usa la landing para orientarte; usa los docs del repositorio para inspeccionar el comportamiento, los límites y la evidencia reales.
Empezar Quickstart de cinco minutos Instala, inicializa un proyecto, revisa health y ejecuta el primer preflight.01EntenderArquitectura factual Mira los módulos reales y el flujo prepare → capture → review.02OperarAgentes y MCP Conecta las herramientas sin entregar la aprobación al protocolo.03VerificarEvidencia de dogfood y piloto Lee la evidencia con su cobertura, gates e incertidumbre adjuntas.04
La confianza es comportamiento del producto
Local por defecto. Explícito sobre la incertidumbre.
CANON / LOCAL
Lo que permanece local
El canon `.rationale/` se versiona con el proyecto. Los logs permanecen locales. SQLite/FTS derivado se puede reconstruir y nunca es la única copia.
BOUNDARY / HUMAN
Lo que permanece humano
MCP puede preparar y capturar. No puede aprobar, revocar, superseder ni cambiar autoridad. Esas acciones requieren `rationale review`.
Verdad de release
Útil ahora, honesto sobre lo que sigue abierto.
beta pública / latest
Rationale está en beta pública. El núcleo y el ciclo completo de captura/revisión son funcionales; la cobertura de plataformas, los gates del piloto y la revisión humana siguen visibles.
✓ Release pública actual: latest
! Abierto: matriz de plataformas, cobertura del proveedor y gates del piloto.
Instalar / luego inicializar
Protege el porqué antes del próximo cambio.
El instalador coloca el binario localmente. `rationale init` crea el canon del proyecto y detecta la configuración del agente.
Compañero / cobertura estructural
Instala Codebase Memory primero.
Codebase Memory mapea dónde está el código y cómo se conecta; Rationale conserva el porqué. El flujo completo usa ambos. Rationale puede funcionar solo con cobertura degradada.
macOS + Linux
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash01 / Instalar Rationale · macOS + Linux
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Ragosorio/Rationale/releases/latest/download/rationale-installer.sh | shDespués, dentro del repositorio:
rationale initComprueba la salud del proyecto:
rationale health04 / Reinicia el agente. En Claude Code ejecuta `/rationale-health`; en Codex pide «Comprueba la salud de Rationale».