Respostas
Onde a memória do time entra num ciclo de desenvolvimento com IA?
O ciclo com IA é bem descrito como uma sequência de artefatos: uma intenção escrita, um plano derivado dela, código produzido contra o plano e a revisão fechando o círculo. O que o ciclo descreve é como uma unidade de trabalho anda. O que ele não carrega é o que continua valendo ENTRE as unidades — qual regra está em vigor, quem decidiu, por que um caminho foi abandonado, e o que as pessoas que nunca abrem o repositório já resolveram. Essa camada é o que o Arroway guarda: curada por gente, ranqueada contra a tarefa, e entregue à IA com um recibo dizendo quanto coube.
O ciclo empurra o trabalho; ele não lembra por quê
Todo artefato do ciclo pertence a uma unidade de trabalho. A intenção descreve esta funcionalidade, o plano ordena esta mudança, a revisão julga este diff — e quando a unidade aterrissa, o raciocínio por trás dela aterrissa junto, correto, terminado e nunca mais consultado. A unidade seguinte começa do mesmo branco. Conhecimento vigente tem a forma oposta: não pertence a unidade nenhuma, sobrevive a todas, e é justamente o que a IA precisa ter ANTES de escrever a primeira linha.
Nomear uma fonte da verdade por artefato — inclusive os que não têm arquivo
A prática já pede que o time diga onde cada artefato mora, e é essa disciplina que torna o ciclo legível. Siga-a com honestidade e uma coluna volta vazia: decisão e norma não têm artefato. Nem a regra de preço, nem o que pode ser mandado para um cliente, nem o motivo de um fornecedor ter sido dispensado, nem a convenção que o time combinou numa reunião. O Arroway é a resposta dessa linha — o repositório guarda o código, e o Arroway guarda o que o time decidiu.
Metade de quem decide nunca abre um repositório
O ciclo é escrito para quem commita, e as decisões que governam esse trabalho muitas vezes não são tomadas por essas pessoas. Amarrar o conhecimento a uma base de código faz com que a regra definida por alguém de vendas, suporte ou financeiro ou seja copiada à mão num arquivo por alguém de tecnologia, ou nunca chegue a IA nenhuma. O Arroway recorta por projeto, e não por repositório: a decisão escrita por quem nunca tocou em git chega na leitura de quem toca.
Como isso aparece na prática
Um time adota o ciclo e ele funciona: intenções escritas, planos derivados, revisões apertadas. Seis semanas depois, uma IA propõe um caminho que o time abandonou no primeiro mês — com bom raciocínio, porque nada que ela consegue ler diz que aquele caminho foi tentado e rejeitado. A rejeição foi real e foi bastante discutida; ela só não tinha artefato, então nunca esteve diante do modelo. O ciclo foi seguido corretamente e ainda assim produziu a mesma resposta errada duas vezes.
Perguntas que as pessoas fazem sobre isso
- Isto substitui os arquivos de intenção e de plano?
- Não. Esses artefatos descrevem uma unidade de trabalho e estão certos onde estão. O Arroway guarda a camada debaixo deles — o que vigora atravessando as unidades — e os dois se encontram no instante em que a intenção é escrita: uma intenção redigida contra as decisões vigentes do time é um documento diferente de uma redigida contra a página em branco.
- Por que não guardar as decisões no repositório também, ao lado dos artefatos?
- Alguns times fazem isso, e funciona até acontecerem duas coisas. Uma decisão é revertida e a linha antiga continua se lendo como atual, porque arquivo comum não tem como dizer que foi substituído. E alguém de fora do repositório toma a decisão, e aí o conhecimento ou é copiado à mão ou nunca chega. O Arroway carrega uma condição de morte explícita, uma cadeia que aponta da memória substituída para o que a substituiu, e um recorte que não é a base de código.
- Em que momento do ciclo a IA recebe isso?
- No começo do trabalho, pelo conector, antes de planejar qualquer coisa. A leitura é ranqueada contra a tarefa que a IA declara e volta dizendo o orçamento que usou e o que não coube, então "a IA conhece as regras do time" vira algo que se confere em vez de se supor. O que a IA aprender pelo caminho ela propõe de volta, e uma pessoa sanciona na revisão — só o que um humano sancionou governa a leitura seguinte.
Onde isto se confere
A documentação do produto neste site (Como funciona, Instalação) e a spec sancionada no repositório. A descrição do ciclo com IA se refere à prática publicada de nomear um artefato e sua fonte da verdade por etapa; esta página não afirma nada sobre o comportamento de nenhuma ferramenta específica, e nada sobre a memória nativa de nenhum produto de IA.
https://www.arroway.app/pt-BR/answers/team-memory-in-the-ai-native-sdlc