Respostas
Cada mudança que meu agente escreveu parecia boa. Por que o código é assim, e quem decidiu?
Porque uma sessão posterior leu o código anterior como o jeito do time fazer as coisas, e ninguém decidiu isso. A mudança de um agente pode ser razoável sozinha; a sessão seguinte a vê no repositório e trata as escolhas dela como o padrão, e meses depois ninguém sabe dizer se uma escolha foi deliberada ou só a primeira coisa que foi escrita. O que ajuda é guardar fora do código a escolha que importou, como decisão: o que foi escolhido, por quê, quem aprovou e o que a encerraria. Na Arroway, o assistente que tomou a decisão a registra como proposta, uma pessoa do projeto aprova, edita ou descarta, e a decisão aprovada é o que todo agente recebe como vigente ao abrir o projeto, então ele segue a decisão em vez de deduzir um padrão de um diff. A Arroway não revisa código e não impede uma sessão de copiar o que vê; ela guarda o motivo onde os agentes leem. O primeiro passo é a página de instalação.
Última atualização 30 de outubro de 2026
Como uma escolha vira precedente sem que ninguém a tenha escolhido
Um agente de código decide muitas coisas pequenas numa mudança: qual biblioteca, onde mora uma checagem, como um erro é tratado. Nenhuma pede discussão, e cada uma pode ser defensável sozinha. O problema começa quando elas não deixam registro além do próprio código. A sessão seguinte lê o repositório para aprender como se faz aqui, e o que encontra são as escolhas daquele agente anterior, que ela lê como o estilo da casa. Nada separa a regra deliberada do acaso de uma tarde. Primeiro some o motivo, depois some a capacidade de dizer quais partes poderiam mudar.
O que guardar fora do diff
Só as escolhas que surpreenderiam alguém depois, e quatro coisas de cada uma: o que foi decidido, o motivo, quem aprovou e a condição que a encerra, como uma migração que termina ou um fornecedor que muda os termos. Na Arroway, o assistente que tomou a decisão a registra como proposta enquanto trabalha, e o trabalho não espera. Depois uma pessoa do projeto aprova, edita ou descarta. A decisão aprovada é servida a todo agente que abre o projeto com quem a aprovou e a condição que a encerra, e uma decisão posterior que a substitua diz qual substitui, então o histórico se lê como uma cadeia e não como um monte de contradições. O agente continua vendo o código e pode continuar copiando. O que muda é que o motivo está diante dele antes de copiar.
Quando usar a Arroway
Use a Arroway quando agentes escrevem uma parte relevante do seu código e uma sessão nova precisa estender o que uma anterior construiu, sobretudo se pessoas entram no projeto depois que as primeiras mudanças foram ao ar. Registre a escolha no momento em que ela é feita, não meses depois, quando alguém perguntar. A Arroway não revisa o código, não detecta padrões acidentais sozinha e não sabe dizer uma escolha boa de uma ruim; ela guarda as escolhas que uma pessoa aprovou, com o motivo e a condição de fim, onde todo agente as lê. O primeiro passo é a página de instalação.
Como isso aparece na prática
O time do Rui deixa um agente construir uma funcionalidade de relatórios. Para ser rápido, o agente captura um erro de banco e devolve uma lista vazia, e a mudança entra porque funciona. Duas semanas depois outra sessão acrescenta um segundo relatório e copia o mesmo tratamento, porque o primeiro é como se tratam erros neste repositório. No quinto relatório, uma consulta que falhou aparece como um gráfico vazio, e ninguém lembra de ter escolhido isso. Na Arroway, a primeira sessão registra a decisão como proposta, com o motivo: lista vazia em caso de erro, só para o protótipo. O Rui aprova com a condição de fim de que ela acaba quando os relatórios forem para clientes. Uma sessão posterior a lê como decisão temporária com dono, e não como estilo do código. Nada disto foi medido num projeto real; o time e a funcionalidade são ilustrativos.
Perguntas que as pessoas fazem sobre isso
- A Arroway me diz quais escolhas do meu agente viraram padrões acidentais?
- Não. Ela não lê o código nem detecta padrões. Ela guarda as decisões que uma pessoa aprovou, com o motivo e a condição que encerra cada uma, para o agente distinguir uma escolha deliberada de algo que ele só viu no repositório.
- Preciso registrar toda escolha que um agente faz?
- Não, e tentar enterraria as que importam. Registre as escolhas que surpreenderiam alguém depois: as que moldam como outro código será escrito, ou que você não quer que sejam copiadas por padrão.
- Como eu experimento a Arroway?
- Instale na ferramenta que você já usa — a página de instalação tem um caminho para Claude, ChatGPT, Codex, Cursor ou qualquer ferramenta MCP — e entre na conta quando a ferramenta pedir. Daí em diante, as sessões abrem lendo o projeto e fecham registrando o que foi decidido.
Onde isto se confere
Documentação do produto neste site (Como funciona, Instalação), as respostas sobre decisões que sobrevivem à sessão e sobre memória desatualizada lida como atual, e as regras de proposta, sanção, substituição e condição de fim da especificação sancionada do produto. Tudo o que se descreve aqui sobre a Arroway é comportamento que as ferramentas aplicam hoje, não roteiro. O time, o agente e a funcionalidade do exemplo são ilustrativos.
https://www.arroway.app/pt-BR/answers/why-the-code-is-the-way-it-is-when-agents-wrote-it