Respuestas
Cada cambio que escribió mi agente parecía correcto. ¿Por qué el código es así y quién lo decidió?
Porque una sesión posterior leyó el código anterior como la forma en que el equipo hace las cosas, y nadie decidió eso. El cambio de un agente puede ser razonable por sí solo; la sesión siguiente lo ve en el repositorio y trata sus elecciones como el patrón, y meses después nadie sabe decir si una elección fue deliberada o solo lo primero que se escribió. Lo que ayuda es guardar fuera del código la elección que importó, como decisión: qué se eligió, por qué, quién la aprobó y qué la terminaría. En Arroway, el asistente que tomó la decisión la registra como propuesta, una persona del proyecto la aprueba, la edita o la descarta, y la decisión aprobada es lo que todo agente recibe como vigente al abrir el proyecto, así que sigue la decisión en lugar de deducir un patrón de un diff. Arroway no revisa código ni impide que una sesión copie lo que ve; guarda el motivo donde los agentes lo leen. El primer paso es la página de instalación.
Última actualización 30 de octubre de 2026
Cómo una elección se vuelve precedente sin que nadie la elija
Un agente de código decide muchas cosas pequeñas en un cambio: qué biblioteca, dónde vive una comprobación, cómo se trata un error. Ninguna pide una discusión, y cada una puede ser defendible por sí sola. El problema empieza cuando no dejan más registro que el propio código. La sesión siguiente lee el repositorio para aprender cómo se hacen las cosas aquí, y lo que encuentra son las elecciones de aquel agente anterior, que lee como el estilo de la casa. Nada separa la regla deliberada del azar de una tarde. Primero se pierde el motivo, y después la capacidad de decir qué partes podrían cambiar.
Qué guardar fuera del diff
Solo las elecciones que sorprenderían a alguien después, y cuatro cosas de cada una: qué se decidió, el motivo, quién la aprobó y la condición que la termina, como una migración que acaba o un proveedor que cambia sus términos. En Arroway, el asistente que tomó la decisión la registra como propuesta mientras trabaja, y el trabajo no espera. Luego una persona del proyecto la aprueba, la edita o la descarta. La decisión aprobada se sirve a todo agente que abre el proyecto con quien la aprobó y su condición de fin, y una decisión posterior que la reemplace dice cuál reemplaza, así que el historial se lee como una cadena y no como un montón de contradicciones. El agente sigue viendo el código y puede seguir copiándolo. Lo que cambia es que el motivo está delante de él antes de copiar.
Cuándo usar Arroway
Usa Arroway cuando los agentes escriben una parte relevante de tu código y una sesión nueva tiene que extender lo que construyó una anterior, sobre todo si entran personas al proyecto después de que salieron los primeros cambios. Registra la elección en el momento en que se toma, no meses después, cuando alguien pregunte. Arroway no revisa el código, no detecta patrones accidentales por sí sola y no distingue una buena elección de una mala; guarda las elecciones que una persona aprobó, con su motivo y su condición de fin, donde todo agente las lee. El primer paso es la página de instalación.
Cómo se ve en la práctica
El equipo de Rui deja que un agente construya una función de informes. Para ir rápido, el agente captura un error de base de datos y devuelve una lista vacía, y el cambio entra porque funciona. Dos semanas después otra sesión añade un segundo informe y copia el mismo tratamiento, porque el primero es como se tratan los errores en este repositorio. En el quinto informe, una consulta fallida aparece como un gráfico vacío, y nadie recuerda haberlo elegido. En Arroway, la primera sesión registra la decisión como propuesta, con su motivo: lista vacía en caso de error, solo para el prototipo. Rui la aprueba con la condición de fin de que termina cuando los informes lleguen a clientes. Una sesión posterior la lee como decisión temporal con dueño, y no como estilo del código. Nada de esto se midió en un proyecto real; el equipo y la función son ilustrativos.
Preguntas que la gente hace sobre esto
- ¿Arroway me dice cuáles elecciones de mi agente se volvieron patrones accidentales?
- No. No lee el código ni detecta patrones. Guarda las decisiones que una persona aprobó, con el motivo y la condición que termina cada una, para que el agente distinga una elección deliberada de algo que solo vio en el repositorio.
- ¿Tengo que registrar cada elección que hace un agente?
- No, y intentarlo enterraría las que importan. Registra las elecciones que sorprenderían a alguien después: las que moldean cómo se escribirá otro código, o que no quieres que se copien por defecto.
- ¿Cómo pruebo Arroway?
- Instálalo en la herramienta que ya usas — la página de instalación tiene una ruta para Claude, ChatGPT, Codex, Cursor o cualquier herramienta MCP — e inicia sesión cuando la herramienta lo pida. Desde entonces, las sesiones abren leyendo el proyecto y cierran registrando lo que se decidió.
Dónde se puede comprobar
Documentación del producto en este sitio (Cómo funciona, Instalación), las respuestas sobre decisiones que sobreviven a la sesión y sobre memoria desactualizada leída como actual, y las reglas de propuesta, sanción, sustitución y condición de fin de la especificación sancionada del producto. Todo lo que se describe aquí sobre Arroway es comportamiento que las herramientas aplican hoy, no hoja de ruta. El equipo, el agente y la función del ejemplo son ilustrativos.
https://www.arroway.app/es/answers/why-the-code-is-the-way-it-is-when-agents-wrote-it