O que é armada?
O armada é uma ferramenta de linha de comando que transforma um repositório em uma equipe de oito agentes do opencode: um orquestrador, backend, frontend, QA, um revisor adversário, segurança, documentação e um arquiteto só de leitura. Você e o orquestrador escrevem um contrato em armada/REQUIREMENTS.md com fases e critérios de sucesso; depois que você o aprova, os agentes constroem, testam e revisam em ciclo e terminam abrindo um pull request em vez de fazer merge localmente.
Os limites de cada papel são definidos pelo sistema de permissões do opencode: o orquestrador não pode editar código-fonte, e os papéis de segurança, adversário e arquiteto só podem escrever os próprios arquivos de revisão. Cada etapa exige evidência, como uma execução de testes aprovada, uma captura de tela ou a citação de arquivo e linha, e o estado do ciclo é gravado em disco para que uma sessão encerrada à força seja retomada. Cada funcionalidade, chamada de voyage, roda na própria git worktree, então várias podem rodar em paralelo.
É escrito em JavaScript, precisa do Node.js 22 ou mais recente e de uma instalação autenticada do opencode, é distribuído no npm como @rafamacalaba/armada e tem licença MIT.
armada vale a pena?
A melhor decisão do armada é impor a separação entre quem faz e quem confere com as permissões do opencode, em vez de pedir com educação aos agentes. O orquestrador literalmente não pode editar código, e os revisores só podem escrever as próprias conclusões, então um construtor não consegue aprovar o próprio trabalho. É uma base mais sólida que a da maioria dos pacotes de prompts, que dependem de instruções que um agente pode ignorar.
As evidências a favor são escassas. O número principal do README é que a frota construiu o próprio sistema de estado de sessão do armada em cerca de 26 minutos por US$ 0,18, encontrando e corrigindo 3 falhas de teste no caminho. É uma única execução relatada pelo próprio autor. O projeto tem 105 estrelas, 12 forks e 2 issues abertas, e é difícil avaliar a adoção fora do autor.
Ele também está preso ao opencode. O scaffold escreve opencode.json e arquivos .opencode/agent, o pacote npm lista o opencode 1.18 ou mais recente como peer, e as voyages rodam em sessões do tmux. Quem usa Claude Code ou Codex não ganha nada com ele sem trocar de host. O comando armada models --discounts aponta o opencode para provedores mais baratos do OpenRouter, como a Novita, o que segundo o README pode economizar até 20 vezes em alguns modelos; provedores mais baratos também podem significar quantização e confiabilidade diferentes, algo que o README não discute.
A atividade diminuiu. O repositório foi criado em 1º de agosto de 2026, lançou a v1.2.9 em 10 de agosto e recebeu o último commit em 28 de agosto. Isso está bem dentro da nossa linha de 12 meses, mas uma pausa de dois meses em um projeto de três meses merece peso. O Pullboard cobre terreno parecido, com uma especificação, worktrees e um agente verificador, para qualquer host de agentes e com muito mais evidência publicada.
Onde ele se destaca
Um desenvolvedor freelancer que já trabalha no opencode
Entregar uma pequena funcionalidade aos agentes e receber de volta um pull request revisado
Rode armada init no repositório, descreva a funcionalidade ao orquestrador, aprove o contrato e espere o pull request com execuções de testes, capturas de tela e o registro de defeitos anexados. O custo de modelo depende dos provedores escolhidos; o exemplo do próprio autor custou US$ 0,18.
Uma startup de duas pessoas com orçamento apertado para modelos
Rodar várias funcionalidades em paralelo sem pagar preços de modelos de ponta
Inicie uma voyage por funcionalidade, cada uma na própria worktree, e direcione o opencode para provedores do OpenRouter com desconto com armada init --openrouter-provider. Confira a qualidade da saída em um provedor barato antes de depender dele.
Antes de decidir
- Configuração
- npm install -g @rafamacalaba/armada no Node.js 22 ou mais recente, com o opencode instalado e logado; armada doctor verifica o ambiente, e depois armada init prepara um repositório existente ou armada new começa um novo.
- Integrações
- Só opencode (dependência peer 1.18 ou mais recente), git worktrees, tmux para voyages em paralelo e roteamento de provedores do OpenRouter para escolher modelos; slash commands /voyage, /patrol, /fleet e /status dentro do opencode.
- Dados e privacidade
- Tudo roda localmente; contratos, estado, registros de defeitos, capturas de tela e evidências E2E são arquivos em armada/ no seu repositório. O código vai para o provedor de modelos que estiver configurado no opencode.
- Custo em escala
- Software gratuito; oito papéis por funcionalidade multiplicam as chamadas de modelo, então o custo acompanha o provedor e o número de rodadas de revisão. Não há números publicados além da única execução de US$ 0,18 do autor.
- Limites
- Um único mantenedor, sem commits desde 28 de agosto de 2026, só opencode e nenhum relato independente de uso em bases de código grandes.
O que é bom
- Limites de papel impostos por permissões do opencode, não por prompts
- Revisores adversário, de segurança e de QA separados dos construtores
- Evidência exigida em cada etapa; o estado sobrevive a uma sessão encerrada
- Funcionalidades em paralelo em worktrees separadas; termina em um pull request
- Uma única dependência de runtime além do opencode
O que não é
- Funciona só com o opencode
- 105 estrelas; os resultados são execuções do próprio autor
- Sem commits desde 28 de agosto de 2026
- O roteamento para provedores com desconto troca preço por qualidade desconhecida
Ideal para
Usuários do opencode que querem uma equipe de agentes pronta, com vários papéis e limites rígidos de permissão, e aceitam um projeto jovem com um único mantenedor.
Alternativas ao armada
armada: perguntas frequentes
- armada vale a pena?
- Uma equipe de agentes bem pensada para usuários do opencode, que impõe papéis por permissão e não por prompts educados, mas pequena, parada desde agosto e presa a um único host. Damos nota 3.2 de 5.
- Quanto custa armada?
- Gratuito sob a licença MIT; você paga pelos modelos que o opencode chama.
- Quais são as desvantagens de armada?
- Funciona só com o opencode; 105 estrelas; os resultados são execuções do próprio autor; sem commits desde 28 de agosto de 2026; o roteamento para provedores com desconto troca preço por qualidade desconhecida.
- Para quem armada é indicado?
- Usuários do opencode que querem uma equipe de agentes pronta, com vários papéis e limites rígidos de permissão, e aceitam um projeto jovem com um único mantenedor.
- Quanto custa armada para uma equipe ou em produção?
- Software gratuito; oito papéis por funcionalidade multiplicam as chamadas de modelo, então o custo acompanha o provedor e o número de rodadas de revisão. Não há números publicados além da única execução de US$ 0,18 do autor.
- armada é seguro para dados da empresa?
- Tudo roda localmente; contratos, estado, registros de defeitos, capturas de tela e evidências E2E são arquivos em armada/ no seu repositório. O código vai para o provedor de modelos que estiver configurado no opencode.
- Quais são as melhores alternativas ao armada?
- As alternativas mais próximas que analisamos são Pullboard, BMAD Method, Spec Kit e OpenCode.
Respostas verificadas em 5 de nov. de 2026.