Agentes¶
O Aegis Spec coordena um time de especialistas. Cada agente faz uma coisa só e faz bem. Nenhum deles tenta fazer tudo.
O orquestrador central (o próprio Aegis Spec) coordena quem entra quando, em que ordem e em que ritmo. Mas você também pode acionar qualquer agente diretamente quando precisar.
Agentes obrigatórios¶
Esses fazem parte do pipeline principal. O orquestrador os executa na sequência certa.
| Agente | Fase | Analogia | Função |
|---|---|---|---|
| Aegis Spec | Orquestração | O regente de orquestra | Coordena todos os agentes, salva checkpoints e guia o usuário |
| Scout | Reconhecimento | O corretor de imóveis | Mapeia a superfície: pastas, linguagens, frameworks, dependências, entry points |
| Archaeologist | Escavação | O escavador | Análise profunda módulo a módulo: algoritmos, fluxos, estruturas de dados |
| Detective | Interpretação | Sherlock Holmes | Extrai regras de negócio implícitas, ADRs, máquinas de estado, permissões |
| Architect | Interpretação | O cartógrafo | Sintetiza tudo em diagramas C4, ERD e mapa de integrações |
| Writer | Geração | O tabelião | Gera specs SDD, OpenAPI e user stories com rastreabilidade de código |
Agentes opcionais¶
Instalados por padrão, mas podem ser acionados de forma independente em qualquer momento.
| Agente | Analogia | Quando usar |
|---|---|---|
| Reviewer | O revisor de specs | Após o Writer: revisa criticamente as specs e valida lacunas |
| Visor | O ilustrador forense | Quando tiver screenshots do sistema disponíveis |
| Data Master | O geólogo | Quando houver DDL, migrations ou modelos ORM para analisar |
| Design System | O estilista | Quando houver arquivos CSS, temas ou screenshots de interface |
| Keeper | O tabelião ao lado | Após cada mudança de código — mantém specs sincronizadas com o código |
Tradutores (adaptadores de entrada)¶
Use quando o "código" legado não for código-fonte, e sim um artefato estruturado como um workflow visual. Geram uma spec SDD e preparam o estado para o pipeline principal continuar.
| Agente | Analogia | Quando usar |
|---|---|---|
| N8N Translator | O tradutor juramentado | Quando tiver um workflow N8N exportado em JSON e quiser documentá-lo como spec ou portar para Python |