Guia de Envio

Como publicar squads no marketplace pela interface web.

Duas Formas de Enviar

Você pode enviar squads ao marketplace usando uma URL de repositório GitHub ou fazendo upload de um arquivo ZIP diretamente.

Método	Ideal para	Formato do slug
URL do GitHub	Repos públicos, atualizações fáceis via re-envio	owner/repo/squad-name
Upload ZIP	Squads privados, sem repositório GitHub necessário	username/uploads/squad-name

Enviar via URL do GitHub

1Faça login no squads.sh com sua conta GitHub.
2Vá para Dashboard > Submeter.
3Selecione "URL do GitHub" e insira seu repositório no formato owner/repo.
4Clique em "Validar". O sistema buscará seu squad e executará a validação.
5Revise o relatório de validação. Corrija erros se o status for CRITICAL.
6Opcionalmente defina um preço (alterne Grátis/Pago, insira valor em USD).
7Clique em "Submeter ao Marketplace" para publicar.

Enviar via Upload ZIP

1Faça login no squads.sh com sua conta GitHub.
2Vá para Dashboard > Submeter e selecione "Upload .zip".
3Arraste e solte seu arquivo ZIP ou clique para procurar. Máx 50MB, deve conter squad.yaml.
4Clique em "Validar" para executar a validação no squad enviado.
5Revise o relatório, defina o preço se desejar e clique em "Submeter ao Marketplace".

Definindo um Preço

Squads são gratuitos por padrão. Para vender seu squad, alterne para "Pago" após a validação e insira um preço em USD ($0.99 – $999.99). Você deve conectar sua conta Stripe em Dashboard > Configurações antes de vender squads pagos. Você também pode alterar o preço depois na página Meus Squads.

Entendendo o Relatório de Validação

Após a validação, você verá um relatório detalhado com uma pontuação de 0 a 100 e um badge de status:

SAFEPontuação >= 80, sem erros — Pronto para publicar.

WARNINGPossui alertas mas sem erros bloqueantes — Pode ser publicado, mas considere corrigir os alertas.

CRITICALPossui erros ou pontuação baixa — Corrija os erros antes de submeter. O botão de envio fica desabilitado.

O relatório mostra 6 categorias expansíveis (Manifesto, Estrutura, Agentes, Tarefas, Workflows, Referências Cruzadas) com problemas individuais que você pode inspecionar.

Após o Envio

▸Seu squad passa por uma auditoria de segurança automática. Os resultados ficam visíveis na página de Auditorias.
▸Você ganha 50 XP por publicar um novo squad.
▸Para atualizar um squad publicado, envie a mesma URL do GitHub ou faça upload de um novo ZIP. O listing existente será atualizado.
▸Você pode alterar o preço a qualquer momento em Dashboard > Meus Squads.

CLI vs Web

Ambos os métodos publicam no mesmo marketplace. Escolha baseado no seu fluxo de trabalho:

▸Web — Ideal para feedback visual de validação, publicadores de primeira vez e envios pontuais.
▸CLI (squads publish) — Ideal para automação, pipelines CI/CD e publicação frequente. Suporta flags --dry-run e --strict.

Veja a Referência CLI para o comando publish. CLI Reference