Usar Archivos Markdown como Motor de Flujo de Trabajo para Claude Code en Kubernetes

Un desarrollador ha implementado un motor de flujo de trabajo poco convencional utilizando archivos markdown en inglés simple que Claude Code ejecuta dentro de Kubernetes. En lugar de herramientas tradicionales de definición de pipelines como Dagster, Prefect o Argo, utilizan archivos markdown llamados SKILL.md que contienen instrucciones simples.

Cómo funciona

El sistema ejecuta Claude Code como un CronJob de Kubernetes. La lógica del flujo de trabajo se define en archivos markdown escritos en inglés simple, con instrucciones como "escanea Reddit, luego clasifica, luego crea un PR". Este enfoque permite que miembros del equipo no técnicos, como el jefe del desarrollador, escriban lógica de pipeline directamente.

Claude Code sigue estas instrucciones markdown y coordina los pasos del flujo de trabajo escribiendo artefactos en disco. El desarrollador informa que ha estado ejecutando este sistema durante más de un mes con mejor estabilidad de la esperada, aunque señala que la experiencia de depuración es complicada y no hay garantía de un comportamiento consistente.

Consideraciones prácticas

El desarrollador sugiere que este enfoque funciona mejor para pipelines de bajo riesgo donde el equilibrio entre simplicidad y confiabilidad es aceptable. Se pregunta si este método de instrucción en lenguaje simple funcionaría para tareas más difíciles o si solo tiene éxito porque su caso de uso no es crítico.

Un tutorial completo con un ejemplo bifurcable está disponible en everyrow.io/blog/claude-code-workflow-engine, proporcionando una referencia de implementación práctica para otros interesados en este enfoque.