🔨 Mao na Massa

Lista de tudo que precisa estar instalado antes de comecar: terminal, Node.js, Git.

Sem ambiente correto, nada funciona — evite perder tempo com erros basicos.

Terminal (bash/zsh), Node.js, Git, editor de codigo

Instalar o OpenCode no seu sistema e verificar que funciona.

OpenCode e a base onde o swarm vai rodar.

opencode --version, opencode.ai

Usar /connect dentro do OpenCode para autenticar Claude, OpenAI, Gemini.

Sem provedores conectados, os agentes nao tem modelos para usar.

/connect, /models, API keys, provedores gratuitos

Executar opencode models para ver todos os modelos acessiveis.

Voce precisa saber os nomes exatos para configurar cada agente.

anthropic/claude-opus-4-6, openai/gpt-5.3-codex, opencode/big-pickle

Instalar o runtime Bun — obrigatorio para o oh-my-openagent.

O OMO nao funciona sem Bun — e o erro mais comum de quem comeca.

curl -fsSL https://bun.sh/install | bash, bun --version

Checklist de verificacao — todos os pre-requisitos confirmados.

Seguir em frente sem o ambiente pronto gera frustracoes desnecessarias.

OpenCode instalado, provedor conectado, Bun instalado, pasta criada

Global ativa em todos os projetos; por projeto ativa so naquela pasta.

Escolher errado pode atrapalhar outros projetos ou limitar o uso.

Global (uso pessoal diario), Por Projeto (demos, aulas)

Verificar quais provedores voce tem (Claude, OpenAI, Gemini, Copilot, so gratuitos).

O comando de instalacao muda conforme seus provedores.

Claude + Gemini (mais comum), so Claude, Claude + OpenAI, so gratuitos

Rodar o comando bunx correto para seu caso.

E a unica etapa de instalacao — um comando faz tudo.

bunx oh-my-opencode install, --claude, --gemini, --openai, --copilot

Confirmar que o plugin foi registrado no opencode.json.

Se nao verificar agora, voce descobre o problema no pior momento.

cat ~/.config/opencode/opencode.json, array de plugins

Ao abrir OpenCode, os modos Build/Plan desaparecem e surgem Sisyphus, Hephaestus, Prometheus.

Confirmacao visual de que o swarm esta ativo.

cd seu-projeto && opencode, agentes visiveis na interface

Os 5 erros mais comuns na instalacao e como resolver cada um.

Nao ficar travado por erros simples.

bunx not found, plugin nao aparece, modelos com prefixo errado, Sisyphus generico, agentes nao paralelos

Agentes criticos precisam de modelos potentes; agentes de suporte podem usar gratuitos.

Otimizar custo sem sacrificar qualidade — a diferenca pode ser 10x no preco.

Sisyphus → claude-opus-4-6, Hephaestus → gpt-5.3-codex, Oracle → big-pickle

Criar .opencode/oh-my-opencode.jsonc na raiz do projeto.

E onde voce define qual modelo cada agente usa.

mkdir -p .opencode, JSONC (JSON com comentarios)

Escrever o JSON com o mapeamento agente → modelo.

Hands-on — voce faz agora.

sisyphus, hephaestus, prometheus, oracle, librarian, explore

Se acabar creditos de um provedor, basta editar o arquivo e continuar.

Na aula real, os creditos de Claude acabaram e trocamos para GPT sem perder o progresso.

Hot-swap, sem reiniciar, fallback de provider

Configuracao otimizada usando apenas modelos gratuitos do OpenCode.

Nem todos tem assinaturas pagas — funciona tambem.

opencode/big-pickle para todos, qualidade menor mas funcional

Abrir OpenCode e confirmar que cada agente mostra o modelo correto.

Validar antes de comecar a executar.

Verificar na interface, testar um comando simples

Comecar com algo pequeno — uma pagina HTML basica, um componente, um script.

Primeira execucao deve ser simples para entender o fluxo sem complexidade.

No chat do OpenCode (Sisyphus), escrever o que quer em portugues claro.

E o modo mais direto — sem comandos especiais.

Ver como o orquestrador decide qual agente usar e delega a tarefa.

Entender o fluxo de roteamento e delegacao.

Clicar nos indicadores de subagentes para ver o que cada um esta fazendo.

Transparencia — voce ve exatamente quem faz o que.

Abrir os arquivos gerados e testar no navegador.

Validar que o swarm entregou o esperado.

Reflexao: Sisyphus recebeu → categorizou → delegou → agente executou → resultado.

Consolidar o modelo mental antes de execucoes mais complexas.

Prometheus extrai requisitos completos ANTES de uma linha de codigo.

"A entrevista previa faz toda a diferenca na qualidade do resultado."

Pressionar Tab no OpenCode para mudar de Sisyphus para Prometheus.

Prometheus so e ativado quando voce muda para ele manualmente.

Escrever o objetivo geral e pedir que Prometheus entreviste antes de comecar.

O prompt inicial define a qualidade de toda a entrevista.

Prometheus pergunta sobre idioma, secoes, tom de voz, stack, conteudo.

Cada resposta refina o plano — quanto mais contexto, melhor o resultado.

Prometheus mostra resumo de tudo que coletou e pede confirmacao.

Ultima chance de corrigir antes da execucao.

Digitar /start-work para que Sisyphus assuma e execute o plano.

E o momento em que o swarm comeca a trabalhar de verdade.

Ideal quando voce ja sabe exatamente o que quer e prioriza velocidade.

Escrever ultrawork ou ulw no chat do Sisyphus.

Dar toda a informacao de uma vez — quanto mais detalhado, melhor.

Multiplos agentes trabalhando simultaneamente em zonas seguras.

"Voce liga e vai tomar um cafe" — o sistema se autocorrige e chega ao final sozinho.

Verificar a pagina gerada, testar no navegador, confirmar zero erros.

Modo que nao para ate o resultado ficar perfeito — autocorrecao em loop.

Gera AGENTS.md em cada pasta para otimizar contexto dos agentes.

Revisa mudancas do ultimo commit antes de fazer merge.

Fornecer imagem/mockup e o agente visual converte em codigo.

Se creditos acabarem, editar o jsonc e continuar sem perder progresso.

Acompanhar quanto cada agente esta consumindo para otimizar.

O aluno escolhe um tema real (empresa, portfolio, projeto pessoal) e constroi com swarm.

Tab → Prometheus → descrever projeto → responder perguntas → confirmar.

O swarm executa em paralelo — waves de implementacao, revisao e teste automaticos.

Revisar resultado, pedir ajustes pontuais, usar /review para validacao final.

Checklist completo de qualidade antes de considerar o projeto pronto.

Reflexao: voce deu um prompt, respondeu perguntas, tomou um cafe e tem um projeto completo.