📈 Skill Spec

Trading Agents

Spec genérica para skills ou frameworks que coordenam múltiplos agentes de trading, análise e execução.

Spec GenéricaMulti-agenteTradingOrquestração

1. Objetivo da Skill

Descrever o contrato de uma capability que distribui pesquisa, análise, validação de risco e execução entre agentes ou módulos especializados de trading.

2. Contrato de Entrada e Saída

Entradas

universo de mercado ou ativos
regras de risco, capital e permissões
fontes de dados e ferramentas de execução
políticas de orquestração entre agentes

Saídas

planos de ação, análises e sinais
decisões aprovadas ou rejeitadas por risco
logs da coordenação entre agentes
opcionalmente ordens ou simulações

3. Fluxo Canônico

Orquestração: Receber objetivo de trading e dividir o trabalho entre papéis especializados.
Análise: Coletar dados, gerar cenários e validar hipóteses por agente ou módulo.
Risco: Aplicar regras de sizing, limites e aprovação antes de qualquer ação executável.
Execução opcional: Se permitido, enviar ordens ou simulações para o destino configurado.
Auditoria: Registrar decisões, justificativas e artefatos produzidos no processo.

4. Pontos de Adaptação

a arquitetura pode ser planejada ou operacional, com agentes reais ou módulos lógicos
execução pode ser real, paper trading ou desativada
papéis podem variar entre research, trader, risk e execution
o framework pode rodar em LangGraph, OpenClaw puro ou outra orquestração

5. Regras Permanentes

nunca pular a camada de risco antes da execução
separar análise de autorização de ordem
explicitar quando algo é referência arquitetural e não fluxo ativo
manter trilha de auditoria das decisões

6. Relação com Workflow

O workflow interno atual documenta uma arquitetura planejada de referência. A Skill Spec generaliza essa capability para qualquer implementação multi-agente de trading.

Leitura correta
Skill Spec = portável, genérica, instalável
Workflow = específico, operacional, real