OpenCode & Claude Code Agent Studio

Transforme o seu OpenCode e Claude Code em uma Software House Autônoma Completa.

O Problema que este Blueprint Resolve

Agentes de IA convencionais sofrem de três vícios graves:

1. Causam danos colaterais: Você pede para alterar um botão e eles refatoram 10 arquivos aleatórios.
2. Gambiarras invisíveis: Usam any, @ts-ignore e eslint-disable para mascarar erros de tipagem.
3. Falta de validação cega: O mesmo agente que escreve o código se auto-avalia, diz que está tudo bem e entrega tarefas quebradas.

A Solução (Suporte Duplo: OpenCode + Claude Code)

O Agent Studio utiliza o conceito de Árvore de Agentes (Agent Tree) para criar uma esteira hierárquica e sob demanda:

Você (Prompt simples, sem comandos especiais)
  │
  ▼
[ MANAGER ] (Diretor)
  │ Bloqueado de codar diretamente
  │ Classifica a intenção no planejamento (PLAN)
  │
  ├─▶ [ designer ]   ── Telas React, Tailwind, Framer Motion (Anthropic & Vercel Guidelines)
  ├─▶ [ architect ]  ── Backend, APIs REST, Banco, Bugs (Vercel Best Practices & RFC 7807)
  ├─▶ [ tester ]     ── Testes ponta a ponta reais com Playwright no navegador
  ├─▶ [ secops ]     ── Pentest ofensivo e varredura de OWASP Top 10
  ├─▶ [ documenter ] ── Diagramas SVG interativos e documentação técnica
  │
  ▼
[ REVIEWER ] (Auditor Cego / Quality Gate)
  │ Avaliação em 2 eixos (Padrões Martin Fowler x Especificação do Usuário)
  │ Veto Imediato: Se violar a Constituição Sênior -> FAIL
  │
  └─▶ Entrega ao Usuário SOMENTE com carimbo [ PASS ]

Como a Árvore Opera em Cada Plataforma

| Mecanismo | No OpenCode | No Claude Code | | :--- | :--- | :--- | | Motor da Árvore | Plugin @beremaran/opencode-agent-tree | Ferramenta nativa de subagentes Agent / Task | | Bloqueio do Manager | Físico (ferramentas edit e bash removidas do schema) | Governança estrita via diretiva CLAUDE.md | | Execução dos Especialistas | Subagentes dedicados (orchestratorDepth: 1) | Subagentes despachados em background | | Quality Gate | Resposta final bloqueada até PASS do Reviewer | Resposta final bloqueada até PASS do Reviewer |

A Equipe Especializada

| Agente | Função | Skills Oficiais Embutidas (Top Mundial) | | :--- | :--- | :--- | | Manager | Diretor / Orquestrador | grill-me (Matt Pocock #2 mundial) | | designer | UI/UX & Frontend | frontend-design (Anthropic #6), web-design-guidelines (Vercel #41), ui-ux-pro-max, impeccable | | architect | Backend & Fullstack | vercel-react-best-practices (Vercel #13), api-designer, fullstack-guardian, diagnosing-bugs (Matt Pocock) | | reviewer | Quality Gate Mandatório | code-review (Matt Pocock #63), gauntlet-loop | | tester | Testes E2E | e2e-tester, webapp-testing, playwright-e2e-init | | secops | Pentest & OWASP | security-pentest, codeprobe-security, owasp-top-10 | | documenter| Arquitetura & SVG | archify, docs, docx, pdf |

Constituição de Engenharia Sênior (5 Regras Invioláveis)

Nenhum código é aprovado pelo reviewer se violar estas diretrizes:

1. Escopo Fechado: Proibido tocar em arquivos fora da solicitação.
2. Zero Gambiarras: Proibido any, @ts-ignore e eslint-disable.
3. Código 100% Funcional: Zero stubs vazios ou comentários // TODO.
4. Zero Chaves Expostas: Credenciais sempre via .env.
5. Zero Poluição de Dependências: O agente trabalha com o que o projeto tem. Proibido npm install sem autorização explícita. Se o projeto não tem Jest/Vitest, a auditoria é feita via análise estática e tipagem estrita.

Instalação Rápida

# Para OpenCode
npx opencode-agent-studio@latest --opencode

# Para Claude Code
npx opencode-agent-studio@latest --claude

Configurando seu Modelo de IA (Para usuários OpenCode)

O instalador detecta automaticamente o modelo configurado no seu OpenCode (ex: openai/gpt-4o ou 9router/freecode) e o propaga para todos os subagentes. Caso precise alterar o modelo no futuro, basta mudá-lo na interface de Configurações (Settings) do OpenCode e rodar o comando npx de instalação novamente para sincronizar a equipe.

Como Usar

Basta abrir o seu OpenCode ou Claude Code e digitar qualquer necessidade de negócio em linguagem natural:

• "Crie uma tela de Login moderna com Tailwind e validação com Zod."
  -> O Manager aciona o designer e valida com o reviewer.
• "Crie o endpoint POST /api/tickets salvando no banco de dados."
  -> O Manager aciona o architect e valida com o reviewer.
• "Verifique se temos vulnerabilidades de injeção no endpoint de login."
  -> O Manager aciona o secops e valida com o reviewer.

Créditos e Agradecimentos

• Motor de Orquestração OpenCode: Desenvolvido graças ao plugin oficial @beremaran/opencode-agent-tree.
• Skills de Classe Mundial:
  • Matt Pocock (code-review, diagnosing-bugs, grill-me).
  • Anthropic (frontend-design).
  • Vercel (vercel-react-best-practices, web-design-guidelines).
  • pbakaus (impeccable).

Licença

Distribuído sob a licença MIT. Veja LICENSE para mais detalhes.