AgentShekel/agentic-workflow

O que agentic-workflow faz?

Framework multiagente para Claude Code: aceitação consciente de níveis (P/M/G), divisão aceitador/otimizador, revisão adversária isolada em sistema de arquivos, segunda opinião entre famílias via Codex MCP, evolução de habilidades estilo SkillOpt, observabilidade com ledger de eventos, humano como juiz supremo

Visão Geral

Este framework orquestra múltiplos agentes para realizar tarefas de desenvolvimento de software com um alto nível de segurança e qualidade. Ele é projetado para ser executado dentro do Claude Code e utiliza um fluxo de trabalho baseado em aceitação por níveis, otimização iterativa e revisão adversarial.

Níveis de Aceitação (S/M/L)

Todas as tarefas são classificadas em três níveis de complexidade:

• P (Pequeno): Correções rápidas, pequenas alterações. Aceito com pouca ou nenhuma revisão.
• M (Médio): Novas funcionalidades ou alterações moderadas. Requer revisão e otimização.
• G (Grande): Mudanças arquiteturais significativas. Requer análise aprofundada, otimização e revisão adversarial.

Componentes Principais

1. Aceitador: Analisa a tarefa e decide se ela é válida e segura para prosseguir. Aplica verificações de segurança e qualidade.
2. Otimizador: Modifica e refina a solução proposta, melhorando eficiência, legibilidade e aderência às melhores práticas.
3. Revisor Adversário: Opera em um diretório workbench isolado, testando a solução contra falhas, vulnerabilidades e objeções.
4. Segunda Opinião (Codex MCP): Para tarefas Grandes ou quando há conflitos, consulta o modelo Codex (via MCP) para uma solução alternativa ou parecer.
5. Registro de Eventos: Todas as ações dos agentes são registradas em um ledger, permitindo rastreamento completo e auditoria.
6. Juiz Humano: Um desenvolvedor humano revisa e aprova decisões finais, especialmente quando o fluxo automático não chega a um consenso.

Como Usar

1. Certifique-se de que o Claude Code está configurado.
2. Clone este repositório dentro do seu projeto ou instale como uma skill.
3. Defina um arquivo de configuração (ex: .agentic-workflow.yml) com suas preferências de nível e agentes.
4. Inicie uma tarefa usando o comando:

   claude-code --skill AgentShekel/agentic-workflow
   

5. Siga as instruções interativas para classificar a tarefa (P, M ou G).

Estrutura de Arquivos Recomendada

project/
├── .agentic-workflow.yml
├── .workbench/          # Diretório isolado para revisão adversária
├── src/
├── tests/
└── README.md

Configuração

Exemplo de .agentic-workflow.yml:

# Níveis de aceitação personalizados
levels:
  small:
    max_lines: 10
    skip_optimizer: true
  medium:
    max_lines: 100
  large:
    min_lines: 101
    require_adversary: true
    require_codex: true

# Agentes
agents:
  acceptor: Claude-Code-3.5
  optimizer: Claude-Code-Opus
  adversary: Claude-Code-Haiku

# Ledger
ledger:
  enabled: true
  path: ./ledger.jsonl

Notas Importantes

• O revisor adversário opera em um diretório isolado (workbench) para evitar modificar o código real sem aprovação.
• O juiz humano é o último recurso; tente automatizar o máximo possível.
• A segunda opinião via Codex MCP requer configuração adicional do MCP (Model Context Protocol).

Links

• Repositório no GitHub
• Documentação do Claude Code

# Comandos úteis
agentic-workflow --help

Licença

MIT