Usando Arquivos Markdown como Motor de Fluxo de Trabalho para Claude Code no Kubernetes

Um desenvolvedor implementou um mecanismo de fluxo de trabalho não convencional usando arquivos markdown em inglês simples que o Claude Code executa dentro do Kubernetes. Em vez de ferramentas tradicionais de definição de pipeline como Dagster, Prefect ou Argo, eles usam arquivos markdown chamados SKILL.md que contêm instruções simples.

Como Funciona

O sistema executa o Claude Code como um Kubernetes CronJob. A lógica do fluxo de trabalho é definida em arquivos markdown escritos em inglês simples, com instruções como "escaneie o Reddit, depois classifique, depois crie um PR". Essa abordagem permite que membros não técnicos da equipe, como o chefe do desenvolvedor, escrevam a lógica do pipeline diretamente.

O Claude Code segue essas instruções em markdown e coordena as etapas do fluxo de trabalho gravando artefatos no disco. O desenvolvedor relata que esse sistema está em execução há mais de um mês com melhor estabilidade do que o esperado, embora observe que a experiência de depuração é difícil e não há garantia de comportamento consistente.

Considerações Práticas

O desenvolvedor sugere que essa abordagem funciona melhor para pipelines de baixo risco, onde a troca entre simplicidade e confiabilidade é aceitável. Eles questionam se esse método de instrução em linguagem simples funcionaria para tarefas mais difíceis ou se só tem sucesso porque seu caso de uso não é crítico.

Um tutorial completo com um exemplo que pode ser copiado está disponível em everyrow.io/blog/claude-code-workflow-engine, fornecendo uma referência de implementação prática para outros interessados nessa abordagem.