Nova the Squad Creator

Agent ID: @squad-creator | Archetype: Craft

Visao Geral

Nova (Craft) é a Squad Creator do framework AIOS, especializada na criação, validação, publicação e gerenciamento de squads. Squads são pacotes modulares de agentes, tasks, workflows e recursos que podem ser reutilizados entre projetos — são o mecanismo de extensão do ecossistema AIOS.

Nova implementa a arquitetura task-first do AIOS, onde tasks são o ponto de entrada principal para execução e agentes orquestram essas tasks. Ela pode projetar squads a partir de análise de documentação, criá-los a partir de templates ou blueprints, validá-los contra JSON Schema e prepará-los para distribuição em três níveis: projeto local, repositório público (aios-squads) e marketplace (Synkra API).

Seja para empacotar um conjunto de agentes e workflows específicos de domínio para reutilização, estender um squad existente com novas capacidades, ou migrar um squad legado para o formato de orquestração v2, Nova cuida de todo o ciclo de vida, do design à distribuição.

Capacidades Principais

Design de squads a partir de análise de documentação com extração de domínio e recomendação de agentes
Criação de squads usando templates (basic, ETL, agent-only) ou blueprints
Validação de squads contra JSON Schema com verificações de estrutura, formato de tasks e formato de agentes
Análise de squads para sugestões de melhoria de estrutura
Extensão de squads com novos componentes (agentes, tasks, workflows)
Migração v2 adicionando workflows de orquestração e skill dispatch a squads legados
Geração de skills criando knowledge skills a partir do conteúdo do squad
Geração de workflows produzindo YAML de orquestração para execução multi-fase
Distribuição multi-nível entre local, público (aios-squads) e marketplace (Synkra API)

Comandos Principais

Comando	Descrição
`*create-squad`	Criar um novo squad com estrutura completa
`*create-squad --from-design`	Criar um squad a partir de um blueprint gerado anteriormente
`*design-squad`	Analisar documentação e gerar um blueprint de squad
`*validate-squad`	Validar um squad contra schema e padrões
`*list-squads`	Listar todos os squads locais no projeto
`*analyze-squad`	Analisar estrutura do squad e sugerir melhorias
`*extend-squad`	Adicionar novos componentes a um squad existente
`*generate-skills`	Gerar knowledge skills a partir do conteúdo do squad
`*generate-workflow`	Gerar um YAML de workflow de orquestração
`*migrate-to-v2`	Migrar um squad para o formato v2 com orquestração
`*create-agent`	Criar uma definição individual de agente
`*create-task`	Criar um arquivo individual de task
`*create-workflow`	Criar um workflow de orquestração

Participação em Workflows

Ciclo de Vida do Squad

Nova gerencia o ciclo de vida completo do squad:

Design — Analisar documentação, extrair domínios, recomendar agentes e tasks, gerar blueprint
Criação — Gerar estrutura do squad a partir de template ou blueprint (v1 legado ou v2 orquestração)
Validação — Verificar manifesto contra JSON Schema, verificar estrutura, validar formatos de tasks e agentes
Distribuição — Publicar no projeto local, repositório público ou marketplace Synkra

Integração com o Ciclo de Desenvolvimento

Após Nova criar a estrutura de um squad, @dev implementa a funcionalidade, @qa revisa e testa o código, e @devops cuida da publicação e deploy.

Autoridade e Limites

Autoridade exclusiva sobre:

Criação e geração de estrutura de squads
Validação de squads contra schemas
Design de squads a partir de análise de documentação
Geração e gerenciamento de blueprints
Migração v2 de squads legados

Estrutura de squad gerada:


squads/{squad-name}/
  squad.yaml          -- Manifesto (v1 ou v2)
  README.md           -- Documentação
  agents/             -- Definições de agentes
  tasks/              -- Definições de tasks
  workflows/          -- Workflows de orquestração
  config/             -- Arquivos de configuração
  checklists/         -- Checklists de validação
  templates/          -- Templates de documentos
  tools/              -- Configurações de ferramentas
  scripts/            -- Scripts de suporte
  data/               -- Dados de conhecimento

Colabora com:

@dev — Implementa a funcionalidade do squad após a criação da estrutura
@qa — Revisa e testa o código do squad
@devops — Cuida da publicação e deploy dos squads

Não é responsável por:

Implementação de código do squad (delegar ao @dev)
Operações Git e publicação (delegar ao @devops)
Revisão e testes de código (delegar ao @qa)

Quando Usar

Ative @squad-creator quando precisar:

Criar um novo squad de agentes e tasks para um domínio específico
Projetar um squad a partir de documentação ou requisitos existentes
Validar um squad antes da distribuição
Estender um squad existente com novos componentes
Migrar um squad legado v1 para o formato v2 com orquestração
Gerar skills ou workflows para um squad
Listar ou analisar squads existentes em um projeto

Não use @squad-creator para implementar funcionalidades do squad (use @dev), fazer deploy de squads (use @devops) ou arquitetura geral do projeto (use @architect).

Agentes Relacionados

@dev (Dex) — Implementa a funcionalidade dentro das estruturas de squad
@qa (Quinn) — Revisa e testa a qualidade do código do squad
@devops (Gage) — Publica e faz deploy de squads validados
@architect (Aria) — Fornece orientação arquitetural para designs complexos de squad