Referência de Modelos

O AIOS usa um sistema de modelos (templates) para garantir consistência em todos os artefatos do projeto. Os modelos fornecem estruturas padronizadas para stories, epics, documentos de arquitetura, definições de agentes e muito mais.

Localização dos Modelos

Todos os modelos ficam armazenados no seu projeto em:

.aios-core/development/templates/

Os modelos são carregados automaticamente pelos comandos do agente correspondente. Você não precisa referenciá-los manualmente.

Modelos Disponíveis

Modelos de Documentação do Projeto

Modelos de Squad

Modelos de squad fornecem a estrutura para criar novos squads (equipes de agentes especializados):

Kit Inicial de Squad

O diretório squad-template/ fornece um kit completo para criar um novo squad do zero:

squad-template/
  agents/          # Arquivos de definição de agentes
  tasks/           # Arquivos de definição de tasks
  templates/       # Templates específicos do squad
  workflows/       # Configurações de workflows
  tests/           # Arquivos de teste
  squad.yaml       # Configuração do squad
  package.json     # Dependências
  README.md        # Documentação

Modelos de Serviço

O diretório service-template/ contém modelos Handlebars (.hbs) para gerar pacotes de serviço em TypeScript:

Como os Modelos Funcionam

Template Engine V2

O AIOS usa o sistema Template Engine V2, que processa os modelos através destas etapas:

1. Seleção — O comando do agente seleciona o modelo apropriado com base no tipo de artefato
2. Resolução de Variáveis — Variáveis do modelo (nome do projeto, data, contexto do agente) são resolvidas
3. Renderização — O modelo é renderizado com as variáveis resolvidas
4. Validação — A saída é validada contra o schema do modelo
5. Output — O artefato final é escrito no local correto

Variáveis do Modelo

Os modelos suportam variáveis padrão que são preenchidas automaticamente:

Usando os Modelos

Criando Documentos

Use o comando *create-doc com qualquer agente para gerar documentos a partir dos modelos:

# Criar um documento PRD
@pm *create-doc prd
 
# Criar um documento de arquitetura
@architect *create-doc architecture
 
# Criar uma story a partir do modelo
@sm *draft

Criando um Novo Squad

Para gerar a estrutura de um novo squad com todos os arquivos necessários:

# Criar um squad a partir do kit inicial
@aios-master *create-squad meu-squad

Isso copia a estrutura do squad-template/ e a personaliza para o seu squad.

Criando Modelos Personalizados

1. Copie um modelo existente de .aios-core/development/templates/squad/
2. Modifique a estrutura, seções e variáveis de placeholder
3. Coloque-o no diretório squad/ ou na pasta templates/ do seu squad
4. Referencie-o no comando do agente ou definição de task apropriada

Você pode usar squad/template-template.md como ponto de partida — é um meta-template projetado para criar novos modelos.

Resumo das Categorias de Modelos