S

Squad AI

Guia Completo

← Catalogo de Agentes

Guia Completo do Squad AI

O Squad AI e uma plataforma de agentes especializados que trabalham juntos para criar, alterar e manter projetos, sites, automacoes e outros agentes. Tudo acontece pelo Discord usando comandos simples. Este guia cobre todos os fluxos — criacao e alteracao.

Como o Sistema Funciona

Qualquer pedido segue o mesmo ciclo: voce descreve, o sistema planeja, voce aprova, agentes executam.

1Voce descreve o que quer no Discord
2ClaudIA analisa e classifica o pedido
3Promptheus gera um plano de execucao
4Voce aprova (ou corrige) o plano
5Agentes especializados executam cada etapa
6Resultado entregue com link e arquivos
ⓘ

O sistema detecta automaticamente o tipo de pedido (projeto, agente, automacao, edicao) pelas palavras-chave do seu texto. Nao precisa selecionar menus.

Comandos Disponiveis

/build

Comando principal. Cria projetos, sites, automacoes, agentes — ou altera agentes existentes. Aceita texto livre.

/build [prompt]

Atalho: ja envia a descricao direto. Ex: /build criar um site de pizza

/start [projeto]

Cria um canal dedicado para um projeto. Opcional: ja define o nome.

/agents

Lista todos os agentes e mostra se estao ativos ou offline.

/status

Visao geral do sistema: servicos, fila de tarefas, saude.

/pipeline-status [id]

Mostra o status detalhado de uma pipeline em execucao.

/cancel [id]

Cancela uma pipeline em execucao.

/analytics

Resumo de metricas: agentes, pipelines, qualidade.

Criar um Projeto / Site

🏗️

Via Briefing (texto livre)

  1. 1Va a um canal de projeto no Discord (ou crie com /start)
  2. 2Use /build (sem prompt) para entrar em modo briefing
  3. 3Descreva o projeto em texto livre. Pode enviar varias mensagens.
  4. 4Quando terminar, escreva pronto
  5. 5O sistema gera um plano com os agentes e etapas
  6. 6Escreva Aprovar ou Aprovar nome-do-projeto para iniciar
  7. 7Se quiser ajustes: Corrigir: [seus ajustes]
✓

Pipeline executa: StackOracle (stack) → Oscar (arquitetura) → ArchValidator (revisao) → DocBrown (docs) → DocsCurator (curadoria) → DBernardo (banco) → coderSon (codigo) → Kia (review) → Claudio (deploy) → PostDeployValidator (smoke tests). Resultado em https://nome.shinp.ai

⚡

Via Prompt Direto

  1. 1Use /build criar um site de portfolio moderno com dark mode
  2. 2O plano e gerado direto sem briefing interativo
  3. 3Aprove ou corrija
✓

Mesmo pipeline, mas mais rapido para pedidos simples.

Exemplos de Prompts para Projetos

›criar um site de landing page para uma barbearia com agendamento online
›fazer uma API REST de gerenciamento de tarefas com autenticacao JWT
›criar um dashboard de metricas que puxa dados de uma planilha Google
›montar um blog com Next.js, Tailwind e MDX

Alterar um Projeto / Site

✏️

Alterando Projetos Existentes

  1. 1Va ao canal do projeto (ex: #project-meu-site)
  2. 2Use /build e descreva a alteracao desejada
  3. 3Ex: adicionar pagina de contato ao site existente
  4. 4O sistema vai considerar o contexto do canal como projeto existente
  5. 5Aprove o plano e aguarde a execucao
✓

O pipeline roda novamente, mas agora com contexto do projeto existente e foco na alteracao solicitada.

⚠

Para alteracoes em projetos existentes, sempre use o mesmo canal onde o projeto foi criado. O sistema usa o canal para manter o contexto.

Criar um Agente

Agentes sao membros do squad com personalidade, funcao e conhecimento proprios. Existem duas formas de criar:

🤖

Via Guided Intake (passo a passo)

  1. 1Use /build sem prompt
  2. 2Escolha Agente → Criar novo agente
  3. 3Preencha: nome, funcao, stack, tools, categoria, keywords...
  4. 4(Opcional) defina times, temperatura, modelo, permissoes
  5. 5(Opcional) envie links de documentacao como referencia
  6. 6Confirme o resumo final
✓

Agente criado com: persona, system_prompt.md, knowledge.md, config.yaml, tools.json, examples.md. Registrado automaticamente.

📝

Via Briefing (texto livre)

  1. 1Use /build criar agente especialista em FastAPI
  2. 2Descreva a funcao, personalidade e conhecimento do agente
  3. 3O sistema detecta automaticamente que e criacao de agente
  4. 4Aprove o plano
✓

Pipeline agent_creation: compilador gera spec → coderSon implementa → Kia valida → commit e registro.

Exemplos de Criacao de Agente

›criar agente especialista em seguranca de APIs, expert em OWASP
›novo agente focado em performance e otimizacao de queries SQL
›criar agente DevOps para gerenciar pipelines CI/CD com GitHub Actions

Alterar um Agente

Voce pode editar qualquer agente existente — prompt, knowledge, docs, config, times, catalogo. Ha duas formas:

✏️

Via Briefing (texto livre) — Recomendado

Novo
  1. 1Use /build e descreva a alteracao em texto livre
  2. 2O sistema detecta keywords como alterar, editar, atualizar, modificar
  3. 3Inclua o nome do agente e o que deseja mudar
  4. 4(Opcional) inclua URLs de documentacao — serao processadas automaticamente
  5. 5(Opcional) envie um arquivo .txt com o nome do agente (ex: oscar_niemeyer.txt) contendo instrucoes e URLs de referencia
  6. 6Aprove o plano mostrado
  7. 7O editor aplica as mudancas, faz bump de versao e deploy
✓

Agente editado: patches aplicados, versao incrementada, registry atualizado, deploy automatico. Sem precisar de guided intake.

Exemplos de Edicao de Agente por Briefing

›alterar o oscar_niemeyer, atualizar o system_prompt pra focar mais em arquitetura escalavel e adicionar essas docs https://docs.fastapi.tiangolo.com/ https://docs.python.org/3/
›editar o coderson para nunca usar css inline e usar essas refs https://nextjs.org/docs
›atualizar agente kia para ser mais rigorosa na validacao de acessibilidade
›modificar o dbernardo, adicionar conhecimento sobre TimescaleDB
›mudar agente googleberto pra incluir busca em papers academicos
📋

Via Guided Intake (passo a passo)

  1. 1Use /build sem prompt
  2. 2Escolha Agente → Alterar agente existente
  3. 3Informe qual agente quer alterar
  4. 4Selecione o que mudar: system_prompt, knowledge, docs_url, tools, config, teams, catalog_metadata
  5. 5Descreva as mudancas
  6. 6(Se docs_url) informe a nova URL de documentacao
  7. 7Confirme
✓

Editor aplica patches, bump version, atualiza registry, deploy. Ideal para mudancas especificas e controladas.

O que pode ser alterado em um agente

system_prompt

Comportamento, personalidade e instrucoes do agente

knowledge

Base de conhecimento manual (texto direto)

docs_url

URL de documentacao — regenera knowledge via DocsIngestor

reference_urls

Multiplas URLs — classifica, expande depth-2, gera knowledge

tools

Ferramentas disponiveis para o agente

config

Configuracoes: temperatura, modelo, backend, timeout

teams

Times do agente (adicionar, remover ou substituir)

catalog_metadata

display_name, short_description, long_description, tags

Como funciona a resolucao do agente

O sistema tenta resolver o nome do agente em 4 passos:

  1. 1.ID exato — oscar_niemeyer
  2. 2.Nome — Oscar Niemeyer (normalizado para slug)
  3. 3.Match parcial — coderson resolve para coderson
  4. 4.Ambiguidade — se oscar bater em 2+ agentes, mostra opcoes

Se nenhum match, o sistema retorna erro com a lista de agentes disponiveis.

Criar uma Automacao

⚡

Automacao com n8n

  1. 1Use /build e descreva o workflow desejado
  2. 2O sistema detecta keywords de automacao: workflow, webhook, n8n, integrar, sincronizar, etc.
  3. 3Classifica como automacao pura (so n8n) ou hibrida (n8n + codigo)
  4. 4Aprove o plano gerado
  5. 5Otto Mation lidera a execucao do workflow
✓

Workflow criado e ativado no n8n com link direto. Se hibrido, codigo auxiliar tambem e gerado e deployado.

Exemplos de Automacoes

›quando uma nova linha for adicionada na planilha do Google, enviar email de notificacao
›webhook que recebe dados de pagamento e salva no banco + notifica no Slack
›monitorar um site a cada 5 minutos e disparar alerta se estiver fora
›sincronizar contatos do HubSpot com uma planilha do Google Sheets
›criar workflow n8n que pega tweets com hashtag X e salva num Airtable

Deteccao automatica de tipo

PURA

Keywords de ferramentas (n8n, webhook, Google Sheets, Slack, cron...) sem sinais de codigo customizado. Otto Mation N8N Specialist lidera.

HIBRIDA

Automacao + sinais de backend (API propria, banco, frontend, deploy). Otto lidera workflow, coderSon implementa codigo auxiliar.

Alterar uma Automacao

🔧

Modificando Workflows Existentes

  1. 1Va ao canal onde a automacao foi criada
  2. 2Use /build e descreva a alteracao
  3. 3Ex: adicionar um node de filtro antes do envio de email no workflow
  4. 4O sistema gera novo plano focado na alteracao
  5. 5Aprove e aguarde
✓

Pipeline atualiza o workflow existente ou cria versao nova conforme o escopo da mudanca.

⚠

Para alteracoes em automacoes, descreva com clareza qual workflow e o que mudar. Se possivel, inclua o nome ou ID do workflow existente.

Documentacao e Referencias

Ao criar ou alterar agentes, voce pode incluir URLs de documentacao. O sistema processa essas URLs automaticamente para enriquecer o knowledge do agente.

Como funciona o processamento de URLs

  1. 1.Extracao — URLs detectadas no texto (bare ou entre < >)
  2. 2.Normalizacao — remove fragmentos, tracking params, duplicatas
  3. 3.Classificacao — heuristicas determinam se e documentacao ou nao (domain, path, plataforma)
  4. 4.Expansao depth-2 — URLs de docs sao expandidas: pagina base → links internos → links de links (max 20 paginas/URL, 100 total)
  5. 5.Knowledge.md — conteudo organizado por dominio com frontmatter e manifest de rastreabilidade
  6. 6.Persistencia — knowledge.md e knowledge_sources.json salvos no repositorio do agente, commitados e pushados automaticamente

Diferenca entre Guided Intake e Briefing Mode

Guided Intake (passo a passo)

  • • URLs nao-documentacao pedem confirmacao por botao (manter / trocar / remover)
  • • Fluxo interativo com perguntas no Discord
  • • Ideal para criacao detalhada de agentes

Briefing Mode (texto livre)

  • • URLs nao-documentacao sao aceitas automaticamente (tagueadas como user_supplied_non_doc_reference)
  • • Sem interrupcao interativa — fluxo continuo
  • • Ideal para edicoes rapidas e alteracoes com contexto

Fluxo de Aprovacao

Todo pedido via /build gera um plano que precisa ser aprovado antes da execucao.

✅

Aprovar

Escreva Aprovar para executar com nome automatico, ou Aprovar meu-projeto para definir o subdominio (ex: meu-projeto.shinp.ai).

📝

Corrigir

Escreva Corrigir: [seus ajustes] para regenerar o plano com suas correcoes. Ex: Corrigir: usar PostgreSQL em vez de MongoDB

❌

Cancelar

Escreva cancelar durante o briefing para desistir. Planos pendentes expiram automaticamente apos 1 hora.

Pipeline de Execucao

Apos a aprovacao, o sistema monta uma pipeline com agentes especializados. A composicao varia conforme o tipo de pedido.

Pipeline: Projeto / Site / Sistema (full_build)

🔍
Googleberto(opcional)— Pesquisa complementar (se necessario)
🧭
StackOracle— Decide stack tecnica: frontend, backend, DB, auth, ORM, deploy
📐
Oscar Niemeyer— Arquitetura: blueprint, estrutura, convencoes, CSS strategy
🔬
ArchitectureValidator— Revisa blueprint: omissoes, conflitos, riscos
📚
DocBrown— Analisa docs de APIs/SDKs, gera api_map + integration_notes
📋
DocsCurator— Curadoria: deduplica, classifica relevancia, consolida padroes
🗄️
DBernardo— Banco de dados: decide se precisa, gera schema/migrations/seeds
🔨
coderSon— Implementacao seguindo blueprint + schema + knowledge
🛡️
Kia— Review e QA (loop ate 3 iteracoes, detecta STACK_DRIFT)
🚀
Claudio Computing— Deploy + release_notes + rollback_plan
✅
PostDeployValidator— Smoke tests, health checks, go/no-go

Pipeline: Clone de Site (site_clone)

🔎
Albiere— Inspecao profunda do site: design tokens, componentes, layout, interacoes
🔨
coderSon— Gera HTML + CSS + JS seguindo fielmente os design tokens do Albiere
🛡️
Kia— Valida fidelidade: COLOR_DRIFT, STRUCTURE_DRIFT, COMPONENT_MISSING (loop ate 2x)
🚀
Claudio Computing— Deploy com health check obrigatorio

Pipeline: Agente (agent_creation)

🧠
Agent Compiler— Gera especificacao assistiva
🔨
Adao (coderSon)— Implementa arquivos do agente
🛡️
Eva (Kia)— Valida aderencia ao protocolo
📦
Registry— Commit, registro, refresh

Pipeline: Edicao de Agente (agent_edit)

🔍
Parser— Extrai agente, instrucoes e URLs do briefing
🔗
Reference Links(opcional)— Classifica, expande e gera knowledge (se houver URLs)
✏️
Agent Editor— Aplica patches, bump version, registry, deploy

Pipeline: Automacao (automation)

🤖
Otto Mation— Cria e configura workflow no n8n
🛡️
Kia— Valida o workflow
🚀
Claudio Computing— Ativa e deploya

Problemas Comuns

O sistema nao detecta que quero editar um agente

Use keywords como alterar agente, editar agente, atualizar agente, modificar agente, mudar agente seguido do nome. O nome pode estar entre aspas: editar o agente "Meu Bot". Tambem funciona direto pelo nome: alterar o oscar_niemeyer para... (sem precisar da palavra 'agente'). Voce tambem pode enviar um .txt com o nome do agente como filename.

Agente nao encontrado na edicao

O nome aceita variantes: oscar_niemeyer, Oscar Niemeyer, oscar-niemeyer — hifens e underscores sao equivalentes. Se houver ambiguidade, o sistema mostra as opcoes. Veja os agentes disponiveis no Catalogo.

Pipeline travada ou sem resposta

Use /pipeline-status [id] para ver o estado. Se necessario, /cancel [id] para cancelar. Pipelines tem timeout de inatividade de 10 minutos e timeout absoluto de 60 minutos. Steps longos emitem heartbeat automatico para evitar falsos timeouts.

Ja tem um briefing em andamento

Escreva cancelar no canal para encerrar o briefing atual, depois tente novamente com /build.

URLs de referencia nao foram processadas

Certifique-se de que as URLs estao com http:// ou https://. URLs sem protocolo nao sao detectadas. Formatos aceitos: URL direta ou entre < >.

Links expandidos nao aparecem no knowledge do agente

Certifique-se de incluir as URLs no briefing ou no arquivo .txt. Os links sao expandidos em profundidade 2, gerando knowledge.md e knowledge_sources.json no repositorio do agente. Verifique em agents_repo/{slug}/knowledge.md — o campo mode deve ser reference_links.

Resultado sem arquivos ou projeto

Isso pode indicar output truncado. Tente novamente com uma descricao mais simples e objetiva. Projetos muito complexos podem ultrapassar o limite de tokens.

Links Uteis

Catalogo de Agentes

Todos os agentes e times

Discord&nearr;

Onde tudo acontece