AgenticWorkflow: Habilidade Universal & Cadeia de Ferramentas de Agentes
Um framework de célula-tronco pluripotente e mecanismo de execução multi-agentes que transforma tarefas complexas em fluxos de trabalho autônomos, determinísticos e autoverificáveis.
Invariante de Execução
$$\text{Intenção} \xrightarrow{\text{Pesquisa}} \text{Plano (SOT state.yaml)} \xrightarrow{\text{Implementação}} \text{Portões de Qualidade 4 Camadas} \xrightarrow{\text{Delta pACS}} \text{Entregável Verificado}$$
⚡ Roteador de Modo Dinâmico
Detecta o modo desejado a partir do contexto ou de sinalizadores explícitos:
| Modo | Frases de Gatilho | Fluxo de Execução Principal |
|---|---|---|
| 1. DESIGN | "criar workflow", "novo pipeline", "workflow.md" | Geração de blueprint de 3 estágios: Pesquisa → Planejamento → Implementação |
| 2. EXECUTE | "executar workflow", "executar pipeline", "iniciar etapa" | Driver de máquina de estado SOT com geração de entregável passo a passo |
| 3. AUTOPILOT | "piloto automático", "totalmente automatizado", "sem intervenção" | Aprova automaticamente pontos de verificação (humano) com registros de decisão; impõe ganchos de segurança |
| 4. ULW | "ulw", "ultrawork", "rigor máximo" | 3 Intensificadores: Persistência de Sísifo, Decomposição Obrigatória, Escalação de Retentativa |
| 5. VERIFY | "verificar etapa", "portões de qualidade", "executar pacs" | L0 Anti-Pulo → L1 Verificação → L1.5 pACS → L2 Revisão Adversarial |
| 6. OPTIMIZE | "otimizar workflow", "reduzir tempo de ciclo", "simplificar" | Análise de gargalos Lean, pontuação de automação, compressão de tempo de ciclo |
3 Critérios Absolutos (Cânon Constitucional)
Todo workflow, ferramenta e subagente criado ou governado por esta habilidade herda estritamente os 3 Critérios Absolutos:
- Critério Absoluto 1: Qualidade do Entregável Final
Velocidade, custo de tokens, carga de trabalho e limites de comprimento são completamente ignorados. O único critério para cada decisão é a qualidade do entregável final.
- Critério Absoluto 2: SOT de Arquivo Único + Memória Hierárquica
Todo o estado compartilhado é concentrado em um único arquivo (
state.yaml). A permissão de escrita SOT pertence exclusivamente ao Orquestrador / Líder da Equipe. Agentes paralelos nunca modificam arquivos compartilhados simultaneamente. - Critério Absoluto 3: Protocolo de Mudança de Código (CCP)
Antes de escrever, modificar, adicionar ou excluir código, realize internamente: Etapa 1 (Entender Intenção) → Etapa 2 (Análise de Efeito Cascata) → Etapa 3 (Plano de Alteração). Governado por Pontos de Âncora de Codificação (CAP-1~4).
Pilha de Garantia de Qualidade de 4 Camadas
flowchart TD
StepStart["Execução da Etapa"] --> L0["L0: Guarda Física Anti-Pulo (Arquivo existe & >= 100 bytes)"]
L0 -->|APROVADO| L1["L1: Portão de Verificação (100% de alcance do objetivo funcional)"]
L0 -->|FALHA| Diag["Diagnóstico Abdutivo"]
L1 -->|APROVADO| L15["L1.5: Autoavaliação pACS (Pontuação F/C/L pré-morte)"]
L1 -->|FALHA| Diag
L15 -->|VERMELHO: <50| Diag
L15 -->|VERDE / AMARELO| L2["L2: Revisão Adversarial (@revisor + @verificador-de-fatos)"]
L2 -->|APROVADO| SOT["Avançar SOT (etapa_atual + 1)"]
L2 -->|FALHA| Diag
Diag --> Retry["Repetir com Hipótese Alternativa (Máx. 3)"]
- L0 Guarda Anti-Pulo: Verifica deterministicamente se o entregável existe no disco e não está vazio (
TAMANHO_SAÍDA_MIN >= 100 bytes). - L1 Portão de Verificação: Verificação semântica se todos os critérios de aceitação foram 100% alcançados.
- L1.5 pACS (Pontuação de Confiança Preditiva do Agente): Avaliação pré-morte em Fidelidade, Completude e Lógica. $pACS = \min(F, C, L)$.
VERDE (>= 70): Avanço automático.AMARELO (50 - 69): Sinalizar dimensão fraca no Registro de Decisão e prosseguir.VERMELHO (< 50): Parar e acionar retrabalho.
- L2 Revisão Adversarial: Avaliação independente Gerador-Crítico por
@revisore@verificador-de-fatos.
Motor de Otimização de Workflow (Lean & Automação)
Ao analisar ou otimizar fluxos de trabalho:
- Gravidade do Gargalo: Pontuar gargalos de 1 a 5.
- Potencial de Automação: Quantificar tarefas manuais para delegação a agentes.
- Redução de Erros: Implementar portões de qualidade nas causas raiz antes da propagação de falhas.
- Redução do Tempo de Ciclo: Visar >= 40% de redução do tempo de ciclo enquanto aumenta a qualidade do entregável.
Motor Autônomo Auto-Abastecido & Disjuntor
O sistema opera como um motor autônomo de ponta a ponta com gerenciamento de energia integrado:
- Auto-Abastecimento & Loop de Energia: Monitoramento dinâmico de tokens e espaço de contexto com compactação automática de estado RLM e pontos de verificação de reabastecimento antes do esgotamento do contexto.
- Disjuntor Fable: Transições de estado
FECHADO→ABERTO→MEIO_ABERTO. Interrompe automaticamente a especulação excessiva quando a sequência de falhas consecutivas $\ge 2$, isola as causas raiz via Diagnóstico Abdutivo (diagnose_context.py) e executa recuperação estruturada. - Guarda de Código Limpo: Guarda AST automática que verifica os 24 imperativos de Código Limpo (funções pequenas, nomes que revelam intenção, máximo de 4 parâmetros, nenhuma exceção engolida, nenhum mock de sucesso falso).
- Avaliação de Engenharia de IA: Teste integrado de impacto díspar quarto-quinto ($\ge 0.80$), monitoramento de desvio de distribuição PSI e sanitização adversarial de injeção de prompt.
Integração CLI & Cadeia de Ferramentas
# Iniciar workflow autônomo de ponta a ponta com auto-abastecimento e gerenciamento de energia
agentic-workflow autopilot --title "Pipeline de Produção" --goal "Entrega Autônoma"
# Executar auditoria do Guarda de Código Limpo (SOLID, 24 Imperativos, modos de falha de IA)
agentic-workflow guard [diretório]
# Executar portões de avaliação de justiça, desvio e injeção de prompt do Engenheiro de IA
agentic-workflow eval
# Consultar logs de rastreamento observável multi-agentes e abrangências
agentic-workflow traces
# Inicializar infraestrutura, diretórios de tempo de execução SOT e verificações de saúde
agentic-workflow init
# Validar esquema do workflow, integridade SOT e logs pACS
agentic-workflow validate
# Verificar painel de workflow ativo e métricas de observabilidade
agentic-workflow status
# Executar suíte de testes automatizados completa (segurança, guard, MAS, avaliador)
agentic-workflow test
Mapa de Referência
- Arquitetura e DNA:
soul.md,AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md - Manual do Usuário:
AGENTICWORKFLOW-USER-MANUAL.md - Diretriz Comum:
AGENTS.md,CLAUDE.md,GEMINI.md - Protocolos:
docs/protocols/(execução-autopiloto, portões-qualidade, modo-ulw, protocolo-mudança-código, detalhe-preservação-contexto) - Subagentes:
.claude/agents/(revisor, verificador-de-fatos, tradutor) - Scripts:
.claude/hooks/scripts/(context_guard, validate_pacs, validate_review, etc.)