Modo de Fluxo Dinâmico
Use esta habilidade quando um agente de codificação pode gerar ou adaptar um harness local de tarefa em vez de apenas seguir um fluxo de comando estático. O objetivo é transformar o modo de fluxo dinâmico em um sistema disciplinado: harnesses temporários para trabalho único, extração de habilidades compartilhadas para trabalho repetido e pontos de verificação observáveis no painel de controle para equipes.
Quando Ativar
- O usuário menciona fluxos de trabalho dinâmicos, harnesses personalizados, harness-por-tarefa, fluxos de trabalho adaptativos ou modo de fluxo dinâmico do Claude Code.
- Uma tarefa precisa de um loop personalizado, avaliador, rastreador, gerador de fixtures, observador ou painel local.
- Vários agentes precisam do mesmo processo repetível, mas o processo ainda não foi capturado como uma habilidade compartilhada.
- Um fluxo de trabalho precisa de artefatos de handoff duráveis, evidências de avaliação ou aprovação do operador antes do merge.
Contrato Central
O modo de fluxo dinâmico deve produzir um harness local de tarefa apenas quando o harness for mais barato e seguro do que conduzir manualmente os mesmos passos. O harness deve ter:
- Objetivo: o resultado que ele possui e o resultado que ele explicitamente não possui.
- Entradas: arquivos, URLs, prompts, fontes de dados, política de credenciais e restrições fornecidas pelo usuário.
- Saídas: commits, relatórios, capturas de tela, arquivos de status ou instantâneos do painel de controle.
- Avaliação: pelo menos uma verificação de aprovação/reprovação vinculada à tarefa, não apenas "funcionou".
- Handoff: um artefato curto que informa ao próximo operador o que aconteceu, o que está bloqueado e como retomar.
Árvore de Decisão de Harness Dinâmico
- Tarefa única: mantenha inline. Não invente um harness.
- Tarefa repetida com entradas variáveis: crie um harness local de tarefa e mantenha-o sob uma área de trabalho temporária ou local ao projeto.
- Tarefa repetida entre colegas ou repositórios: extraia o padrão em uma habilidade compartilhada.
- Tarefa com estado externo, fila ou aprovações: adicione visibilidade no painel de controle antes de adicionar mais automação.
- Tarefa com risco de segurança: adicione um portão de avaliação e um portão de aprovação humana antes da execução autônoma.
Modelo de Harness Local de Tarefa
Use esta estrutura antes de escrever código:
# Harness de Fluxo de Trabalho Dinâmico
Objetivo:
- Entregar:
- Não entregar:
Entradas:
- Repositório ou workspace:
- Sistemas externos:
- Política de credenciais:
Loop:
1. Descobrir estado atual.
2. Gerar ou atualizar o menor artefato útil.
3. Executar verificações de avaliação.
4. Registrar status e handoff.
5. Parar em portão falho, propriedade incerta ou ação externa insegura.
Avaliação:
- Comando:
- Sinal de aprovação esperado:
- Proprietário da falha:
Handoff:
- Status:
- Evidência:
- Próxima ação:
Extração de Habilidade Compartilhada
Promova um harness local de tarefa para uma habilidade compartilhada somente quando pelo menos duas destas forem verdadeiras:
- O mesmo fluxo de trabalho aparece em várias sessões, repositórios, equipes ou lançamentos.
- O fluxo de trabalho precisa de sequenciamento específico de linguagem, ferramenta ou segurança.
- Falhas se repetem porque operadores pulam um portão ou perdem contexto.
- O fluxo de trabalho tem um contrato estável de entrada/saída.
- O fluxo de trabalho se beneficia de um painel de controle, quadro de status ou handoff de equipe.
Ao extrair, escreva primeiro a habilidade em skills/<nome>/SKILL.md. Adicione shims de comando apenas se uma superfície de entrada por barra legacy ainda for necessária.
Pontos de Verificação do Painel de Controle
O modo de fluxo dinâmico se torna utilizável por equipe quando expõe estado. Registre estes pontos de verificação sempre que a tarefa abranger mais de uma sessão:
- Plano: objetivo, proprietário, critérios de aceitação e sistemas externos arriscados.
- Fila: itens de trabalho, função do agente atribuída, branch/worktree e arestas de dependência.
- Execução: harness ativo, etapa atual do loop, resultado de avaliação recente e sinal de token/custo, se disponível.
- Portão: resultados de teste, capturas de tela do navegador, revisão de segurança e prontidão para merge.
- Handoff: o que está feito, o que falhou, o que precisa de uma decisão humana.
Se o repositório tiver o estado ECC2 ativado, prefira adicionar ou ler pontos de verificação através do painel de controle ECC ou scripts baseados em armazenamento de estado em vez de espalhar notas não rastreadas.
Portões de Avaliação
Cada harness dinâmico precisa de uma avaliação específica da tarefa. Escolha o portão confiável mais barato:
| Tipo de Trabalho | Portão de Avaliação |
|---|---|
| Funcionalidade de código | Teste focado, lint, cobertura e um caminho de integração |
| Interface/painel de controle | Smoke do navegador com captura de tela e verificações de overflow/erro |
| Fluxo de trabalho do agente | Transcrição de fixture ou item de trabalho semeado com roteamento esperado |
| Pesquisa/conteúdo | Briefing neutro de fonte, lista de verificação de reivindicações e esboço pronto para publicação |
| Integração | Comando dry-run, validação de configuração e verificação de ausência de segredos |
Não afirme que um fluxo de trabalho dinâmico é reutilizável até que a avaliação possa ser executada novamente por outro colega.
Anti-Padrões
- Gerar scripts que escondem a lógica de decisão real do operador.
- Tratar o modo de fluxo dinâmico como permissão para pular testes.
- Criar documentos únicos quando uma habilidade compartilhada ou artefato de status é o produto real.
- Executar vários agentes sem propriedade, portão de merge ou política de conflito.
- Deixar dados brutos de pesquisa privada vazarem em documentos públicos.
Padrão de Saída
Finalize com:
- O caminho do harness ou habilidade.
- Os comandos e resultados de avaliação.
- O caminho do painel de controle ou artefato de handoff.
- O próximo candidato a extração reutilizável.