SQUADS

Perguntas frequentes

Perguntas comuns sobre squads.sh e o ecossistema Squad.

O que é um Squad?

Um Squad é um pacote autônomo de agentes IA, tarefas, workflows e arquivos de configuração projetados para trabalhar juntos em um domínio específico. Os Squads seguem um formato padronizado definido pelo framework Squad, tornando-os portáveis e reutilizáveis entre projetos.

Como instalar um squad?

Primeiro, instale o CLI globalmente. Depois, adicione um squad do marketplace ou de um repositório do GitHub. Consulte a Referência CLI para todas as opções disponíveis.

npm install -g squads
squads add user/squad-name

Como publicar meu squad?

Autentique-se com squads login, garanta que seu squad tenha um squad.yaml válido com name, version e description, depois execute squads publish no diretório do seu squad. Seu squad passará por uma auditoria de segurança automatizada.

squads login
squads publish

É gratuito?

Sim. squads.sh é gratuito tanto para instalar quanto para publicar squads. Buscar, navegar e baixar squads não tem custo. Publicadores podem opcionalmente configurar squads pagos pelo marketplace, mas a plataforma em si é gratuita. O CLI é open source.

Como funciona a gamificação?

  • ▸XP — Ganhe pontos de experiência por publicar squads, receber instalações, obter avaliações e contribuir atualizações.
  • ▸Níveis — Avance pelos níveis (Novato, Construtor, Arquiteto, Mestre) conforme acumula XP.
  • ▸Badges — Desbloqueie badges de conquista por marcos (Primeira publicação, 100 instalações, Mais bem avaliado, etc.).
  • ▸Rankings — Compita em classificações semanais e gerais visíveis nas páginas Em alta e Destaques.

Como são feitas as auditorias de segurança?

Cada squad publicado no marketplace passa por uma auditoria de segurança automatizada que verifica:

  • ▸Validade estrutural — formato de arquivo correto, campos obrigatórios, YAML/Markdown válido
  • ▸Integridade de referências cruzadas — todos os agentes referenciados em tarefas e workflows existem
  • ▸Padrões de injeção de prompt — detecção de instruções potencialmente maliciosas em definições de agentes
  • ▸Exposição de dados sensíveis — varredura de segredos hardcoded, chaves de API ou credenciais

Os resultados das auditorias são visíveis publicamente na página de Auditorias. Os squads são classificados como SAFE, WARNING ou CRITICAL.

Posso vender meus squads?

Sim! O marketplace suporta squads pagos com distribuição server-gated. Defina um preço ao publicar com squads publish --price 2990 (para $29.90). Você precisa conectar sua conta Stripe em Dashboard > Configurações primeiro. A receita é dividida 80% para você e 20% para a plataforma. Compradores adquirem no squads.sh e depois instalam via CLI. Squads gratuitos continuam sendo a opção padrão e são incentivados para o crescimento da comunidade.

O que é Squad e como se integra?

Synkra Squad é um framework para desenvolvimento orquestrado por IA. Quando você instala um squad com a flag --aiox, os agentes se tornam slash commands na sua IDE (ex: /SQUADS:ds:designer). Isso permite integração profunda onde você pode invocar agentes diretamente do Claude Code, Gemini CLI ou outras IDEs suportadas. Instale o Squad Core com npx aiox-core init para começar.

npx aios-core init

Como ativar squads na minha IDE?

Instale um squad com ativação Squad usando squads add meu-squad --aiox new (para um novo projeto) ou squads add meu-squad --aiox existing (para um projeto Squad existente).

squads add my-squad --aios new
squads add my-squad --aios existing

Após a ativação, os agentes são registrados como slash commands seguindo o padrão /SQUADS:prefixo:agent-id. O prefixo é definido no squad.yaml (campo slashPrefix). Sua IDE reconhece os novos comandos automaticamente.

IDEs suportadas: Claude Code (suporte completo), Gemini CLI (alta paridade), Codex CLI (parcial), Cursor (baseado em regras).

FAQ — SQUADS