Sua Pipeline de Agentes de IA Precisa de uma Superfície de Controle Humano — Aqui Está a Mais Simples

Como um quadro kanban suportado por markdown preenche a lacuna estranha entre orquestradores de agentes e os humanos que ainda precisam aprovar, revisar e decidir.

Resumo

• Agentes de IA já podem realizar trabalhos úteis de ponta a ponta. A parte complicada começa quando um humano precisa revisar, aprovar ou redirecionar esse trabalho.
• A maioria das equipes lida com esse momento com um patchwork de UIs de orquestração, mensagens no Slack, problemas no GitHub e decisões mal documentadas.
• kanban-lite oferece um padrão mais simples: mantenha o estado do fluxo de trabalho compartilhado em um quadro que tanto humanos quanto agentes possam usar — suportado por markdown simples em seu repositório.
• Não é um motor de fluxo de trabalho. É uma superfície de controle humano leve que você pode colocar em cima da pilha de agentes que você já possui.

A Parte dos Fluxos de Trabalho de Agentes que Ainda Parece Estranha

As equipes estão melhorando em fazer com que agentes de IA realizem trabalhos úteis.

Um agente pesquisa. Outro redige. Um terceiro avalia a saída e decide se deve tentar novamente, escalar ou seguir em frente. Se você está construindo com LangGraph, n8n, Temporal, Claude Code, Codex ou uma camada de orquestração desenvolvida internamente, essa parte está se tornando mais fácil rapidamente.

A parte estranha começa quando o trabalho precisa de uma pessoa.

Talvez o rascunho precise de revisão de designer. Talvez um PM precise aprovar o próximo passo. Talvez um responsável pela conformidade precise responder a uma lista de verificação antes que qualquer coisa possa ser enviada.

É aí que muitos fluxos de trabalho de agentes falham — não porque os agentes falham, mas porque o lado humano do fluxo de trabalho vive nos lugares errados.

A execução do agente está em uma UI. O pedido de aprovação chega no Slack. Comentários estão enterrados em e-mails. A decisão final é copiada em um ticket. Uma semana depois, ninguém consegue responder facilmente a três perguntas simples:

• O que já aconteceu?
• O que está aguardando um humano?
• Para onde o trabalho vai a seguir?

A maioria das ferramentas de orquestração é boa em rastrear o que as máquinas estão fazendo. Elas geralmente são muito piores em dar aos humanos um lugar compartilhado para revisar, decidir, comentar e devolver o trabalho.

Essa camada ausente é o que quero dizer com uma superfície de controle humano.

Por Que as Ferramentas Existentes Geralmente Não Funcionam

Você pode absolutamente forçar esse fluxo de trabalho nas ferramentas que já usa. Muitas equipes fazem isso.

Mas cada opção tem um trade-off óbvio uma vez que agentes e humanos começam a colaborar no mesmo fluxo.

UIs de Orquestrador

Ótimas para gráficos de execução, tentativas, rastros e estado interno da máquina.

Geralmente não são boas para revisores não técnicos que apenas querem dizer: aprove isso, devolva, pergunte ao jurídico ou deixe feedback ao lado do trabalho em si.

Slack e e-mail

Rápidos e familiares.

Também terríveis como estado de fluxo de trabalho durável. Uma decisão tomada em um chat é fácil de perder, difícil de auditar e irritante para os agentes trabalharem de forma confiável.

Problemas do GitHub ou Jira

Úteis para rastreamento de tarefas humanas, mas muitas vezes estranhos como a principal superfície de trabalho para transferências de agentes.

Sim, os agentes já podem se conectar ao GitHub e, às vezes, ao Jira. Mas isso não torna essas ferramentas o lugar ideal para manter o estado operacional ao vivo de um fluxo de trabalho com humano no loop (HITL). Elas adicionam atrito, separam o contexto do trabalho e empurram humanos e agentes para ferramentas que não foram projetadas para compartilhar a mesma superfície de forma limpa.

A alternativa interessante é mais simples:

E se o estado do fluxo de trabalho vivesse ao lado do próprio trabalho, em um formato que tanto humanos quanto agentes pudessem ler e atualizar diretamente?

O Que kanban-lite Realmente É

kanban-lite não é uma estrutura de agente, e essa é parte do apelo.

Não substitui LangGraph, CrewAI, n8n, Temporal ou qualquer coisa que execute seus agentes.

O que ele oferece é uma superfície de controle leve e compartilhada para os momentos em que os humanos precisam intervir.

Apesar do nome, não é apenas um quadro. É uma camada prática para:

• estado de tarefas
• aprovações
• comentários
• anexos
• logs
• formulários estruturados
• e ações humanas explícitas.

Por padrão, os cartões são armazenados como arquivos markdown com frontmatter YAML sob .kanban/boards/<boardId>/<status>/ em seu repositório.

Então, em vez de uma instância de fluxo de trabalho estar presa dentro de um backend oculto, ela se parece com isso:

---
id: blog-post-q3-launch-2026-03-26
status: review
priority: high
assignee: maya
dueDate: 2026-03-30
labels: ["marketing", "agent-generated"]
actions:
  retry-draft: "Tentar novamente com tom mais suave"
  approve-publish: "Aprovar & Publicar"
---
# Postagem do blog de lançamento do Q3

Rascunho inicial anexado. 
Precisa de revisão de tom humano antes da publicação.

Esse cartão está fazendo muito trabalho ao mesmo tempo:

• Os humanos podem lê-lo sem abrir um painel proprietário.
• Os agentes podem atualizá-lo sem raspar o estado da UI.
• Todo o histórico do fluxo de trabalho pode viver no Git.
• O mesmo objeto pode ser acessado através da UI da web, VS Code, CLI, REST API, SDK, ferramentas MCP ou n8n.

Essa é a ideia central: estado de fluxo de trabalho compartilhado, em um formato que é legível por humanos e acionável por máquinas ao mesmo tempo.

Um Exemplo Mais Realista do Que "Agente Chama Ferramenta"

Imagine uma pequena equipe de produto preparando um anúncio de lançamento.

Um desenvolvedor pede a um agente para redigir o post a partir de notas de produto, itens do changelog e contexto do cliente.

O agente produz um rascunho e cria um cartão em draft.

Então o fluxo de trabalho deixa de ser puramente técnico.

• O designer precisa revisar as capturas de tela.
• O PM precisa confirmar o posicionamento.
• O marketing quer um tom mais suave.
• O jurídico precisa de um aviso obrigatório.

É aqui que muitas equipes recorrem a quatro sistemas separados:

• o repositório para material fonte
• Slack para notificações
• um rastreador de problemas para aprovações
• e a UI de orquestração para "o que o agente fez".

Isso funciona, mas cria uma área de superfície desnecessária.

Com kanban-lite, o agente pode mover o cartão para design-review, anexar o rascunho, adicionar logs e expor uma ação clara a seguir. O designer pode comentar diretamente no cartão. O PM pode clicar em approve-publish. O jurídico pode preencher um formulário estruturado. O orquestrador pode retomar quando o sinal humano chegar.

Todos estão olhando para o mesmo objeto.

Essa é a diferença entre “humano-no-loop” (HITL) como uma palavra da moda e um fluxo de trabalho que as pessoas...