Sobre o Atta
O Atta é o conjunto de agentes, skills e regras com que trabalho no Claude Code. Começou como uma framework de código aberto e ganhou uma camada minha que mantém vários projetos alinhados, guarda o que cada um aprendeu e revê cada alteração antes de ser integrada.
atta-devFramework de código aberto
- base, alargada: Base partilhada
Base partilhadaSkills, agentes base, deteção da stack, modelos
- semear e atualizar (atta-sync): Projeto
ProjetoUm de vários, com a sua cópia de trabalho
- promover uma melhoria: Base partilhada
- tem: Agentes base
- gera a partir da stack: Especialistas
- cada PR e integração: atta-critic
- hooks de sessão: Publicador em cada computador
Agentes baseResponsável de projeto, arquiteto, revisor de código, bibliotecário
- usam: Skills
- ler primeiro, registar lições: Wiki do projeto
EspecialistasChefes de equipa e especialistas gerados para a stack do projeto
- usam: Skills
SkillsGrill, review, verify, ship, council, wiki, sync
- passam um trabalho a: Outro modelo
Outro modeloSegunda opinião, lugar no conselho
Wiki do projeto
- promover uma lição comum: Wiki partilhada
Wiki partilhadaLições comuns aos projetos, uma página por projeto
- lida no separador da wiki: Sala de controlo Atta Star
atta-criticRevisor novo, porta na abertura e integração do PR
- aprovação abre a porta: Pull request no GitHub
Pull request no GitHub
- tarefas sincronizadas nos dois sentidos: Sala de controlo Atta Star
Publicador em cada computadorAs transcrições ficam no computador
- retrato: cartões, páginas da wiki, tempo de trabalho: Sala de controlo Atta Star
Sala de controlo Atta StarProjetos, tarefas, wikis, folha de horas
De onde vem
A framework é o atta-dev, publicado no npm e no GitHub com a licença MIT, sob o nome Codelaude. Escrevi a maior parte, com mais um contribuidor. A ideia é que os agentes orientem, revejam e verifiquem o trabalho, em vez de escreverem código sem lhes ser pedido. O resto desta página, da base partilhada ao crítico, ao Atta Star e à folha de horas, construí-o por cima dela para os meus próprios projetos, em 2026.
Uma base, uma cópia em cada projeto
Há um Atta de referência numa pasta partilhada, e cada projeto guarda uma cópia de trabalho junto ao seu código. Um projeto pode ficar para trás em relação à base, mas nunca se separa dela. Um script de sincronização mostra o que mudou, traz a base para o projeto ou promove para a base uma melhoria feita num projeto, para que todos a recebam. Uma verificação no início de cada sessão fica em silêncio quando o projeto está em dia. Montei isto depois de descobrir três projetos que diziam todos estar na versão 3.0.0 e não coincidiam entre si.
Agentes e skills
Cada projeto recebe quatro agentes base: um responsável de projeto que encaminha o trabalho, um arquiteto, um revisor de código e um bibliotecário que guarda regras e conhecimento. Na primeira utilização, o Atta lê a stack do projeto e gera especialistas para ela, como Vue, Fastify ou PostgreSQL. Cerca de 37 skills partilhadas cobrem o resto: pôr um plano à prova antes do código, rever, provar uma alteração de interface num navegador real, entregar um pull request e pedir uma segunda opinião a outro modelo.
O que guarda
Cada projeto tem uma wiki: porque é que algo está feito de certa maneira, o que se tentou e se deixou cair, a causa de fundo de um erro. Uma lição que vale para vários projetos vai para uma wiki partilhada. As sessões leem a wiki antes de procurarem no código, por isso cada uma começa onde a anterior parou.
O crítico
Uma vez, testes a verde e a revisão feita pela própria sessão deixaram passar 17 defeitos reais. Desde então, cada pull request passa pelo atta-critic: um processo novo do Claude, sem memória e sem saber quem escreveu o código. Recolhe a alteração por si próprio e trata a descrição do PR como afirmações a verificar. Um hook recusa abrir ou integrar um pull request enquanto uma revisão desse commit exato não tiver passado. As alterações que tocam em dinheiro ou dados têm dois críticos, e alguns caminhos, como a publicação e o início de sessão, só eu posso integrar.
O Atta Star e a folha de horas
O Atta Star é a sala de controlo: cartões de projeto, uma fila de tarefas de todos os projetos, as wikis e a folha de horas, atrás de um início de sessão único. As horas saem das transcrições das sessões do Claude Code, com regras fixas: uma pausa de mais de uma hora é um intervalo, uma despedida fecha o dia e os minutos nunca são arredondados. As transcrições ficam no computador.
Proteções
Antes de cada commit corre uma verificação de segredos, sem ligação à internet, com regras extra para NIF e IBAN portugueses. Os dados de teste são inventados, e um pedido para outro modelo é verificado, à procura de endereços e números de conta, antes de ser enviado.