Visão Geral de Squads

./squads/my-squad/
├── squad.yaml              # Manifesto (obrigatório)
├── README.md               # Documentação
├── LICENSE                 # Arquivo de licença
├── config/
│   ├── coding-standards.md # Regras de estilo de código
│   ├── tech-stack.md       # Tecnologias utilizadas
│   └── source-tree.md      # Estrutura de diretórios
├── agents/
│   └── my-agent.md         # Definições de agentes
├── tasks/
│   └── my-task.md          # Definições de tasks (task-first!)
├── workflows/
│   └── my-workflow.yaml    # Workflows multi-etapa
├── checklists/
│   └── review-checklist.md # Checklists de validação
├── templates/
│   └── report-template.md  # Templates de documentos
├── tools/
│   └── custom-tool.js      # Integrações de ferramentas customizadas
├── scripts/
│   └── setup.js            # Scripts utilitários
└── data/
    └── reference-data.json # Arquivos de dados estáticos

# Campos obrigatórios
name: my-squad # kebab-case, identificador único
version: 1.0.0 # Versionamento semântico
description: O que este squad faz
 
# Metadados
author: Seu Nome <email@exemplo.com>
license: MIT
slashPrefix: my # Prefixo de comando para IDE
 
# Compatibilidade AIOS
aios:
  minVersion: '2.1.0'
  type: squad
 
# Declaração de componentes
components:
  agents:
    - my-agent.md
  tasks:
    - my-task.md
  workflows: []
  checklists: []
  templates: []
  tools: []
  scripts: []
 
# Herança de configuração
config:
  extends: extend # extend | override | none
  coding-standards: config/coding-standards.md
  tech-stack: config/tech-stack.md
  source-tree: config/source-tree.md
 
# Dependências
dependencies:
  node: [] # pacotes npm
  python: [] # pacotes pip
  squads: [] # Outros squads
 
# Tags de descoberta
tags:
  - domain-specific
  - automation

# Ativar o agente criador de squad
@squad-creator
 
# Opção 1: Design guiado (recomendado)
*design-squad --docs ./docs/prd/my-project.md
 
# Opção 2: Criação direta
*create-squad my-squad
 
# Opção 3: A partir de template
*create-squad my-squad --template etl

┌─────────────────────────────────────────────────────────────┐
│                    DISTRIBUIÇÃO DE SQUADS                     │
├─────────────────────────────────────────────────────────────┤
│  Nível 1: LOCAL        --> ./squads/           (Privado)     │
│  Nível 2: AIOS-SQUADS  --> github.com/SynkraAI (Público)     │
│  Nível 3: SYNKRA API   --> api.synkra.dev      (Marketplace) │
└─────────────────────────────────────────────────────────────┘

# Listar squads disponíveis
aios squads list
 
# Baixar do repositório oficial
*download-squad etl-squad
 
# Baixar versão específica
*download-squad etl-squad@2.0.0
 
# Listar squads locais
*list-squads

Requisição do Usuário --> Task --> Execução do Agente --> Saída
                           │
                      Workflow (se multi-etapa)

# Validar estrutura do squad
*validate-squad my-squad
 
# Modo estrito (para CI/CD)
*validate-squad my-squad --strict

dependencies:
  squads:
    - etl-squad@^2.0.0

aios:
  minVersion: '2.1.0'