RationaleDocumentaciónEl ciclo proponer → revisar → aprobar

Documentación

El ciclo proponer → revisar → aprobar

Un lifecycle completo de cambios con autoridad humana explícita e incertidumbre honesta.

1. Localizar

Usa Codebase Memory para encontrar el símbolo, sus callers y archivos relevantes cuando esté instalado. Trátalo como cobertura estructural, no como una decisión.

2. Preparar

Llama a prepare_change(target, intent) antes de cambiar código no trivial. Lee restricciones, evidencia, autoridad, linkage, cobertura del proveedor y conflictos con la intent. Un Record gobernante obliga al agente a declarar si el cambio se alinea o contradice la decisión; Rationale no finge que una heurística local sea prueba semántica.

3. Cambiar y finalizar

Haz el cambio mínimo consistente con el contexto. Si el código parece extraño, llama a explain_target antes de simplificarlo. Después llama a finalize_change; captura archivos committed, staged, unstaged y untracked sin tratar el árbol sucio como “no ocurrió nada”.

4. Revisar

Ejecuta:

rationale review

Inspecciona statement, evidencia, bindings, estado provisional y efecto. Una propuesta puede aprobarse, corregirse, rechazarse o saltarse. Las afirmaciones críticas requieren confirmar la palabra indicada.

5. Aprobar y compartir

La aprobación mueve el Record al área canónica records/ con un evento humano. Commitea .rationale/ con el código para que la siguiente sesión vea la misma decisión. Nunca describas una propuesta como un Record aprobado.