Kubernetes에서 Claude 코드를 위한 워크플로우 엔진으로 Markdown 파일 사용하기

한 개발자가 Claude Code가 Kubernetes 내에서 실행하는 일반 영어 마크다운 파일을 사용하여 독특한 워크플로우 엔진을 구현했습니다. Dagster, Prefect, Argo 같은 전통적인 파이프라인 정의 도구 대신, 간단한 지시사항을 담은 SKILL.md라는 마크다운 파일을 사용합니다.

작동 방식

이 시스템은 Claude Code를 Kubernetes CronJob으로 실행합니다. 워크플로우 로직은 "Reddit을 스캔한 후 분류하고, PR을 생성하라"와 같은 일반 영어로 작성된 마크다운 파일에 정의됩니다. 이 접근 방식은 개발자의 상사와 같은 비기술직 팀원이 직접 파이프라인 로직을 작성할 수 있게 합니다.

Claude Code는 이러한 마크다운 지시사항을 따르며, 아티팩트를 디스크에 기록하여 워크플로우 단계를 조정합니다. 개발자는 이 시스템을 한 달 이상 운영하면서 예상보다 나은 안정성을 보고했지만, 디버깅 경험이 어렵고 일관된 동작을 보장하지는 않는다고 언급했습니다.

실용적 고려사항

개발자는 이 접근 방식이 단순성과 신뢰성 사이의 균형이 허용되는 낮은 위험도의 파이프라인에 가장 적합하다고 제안합니다. 그들은 이 일반 언어 지시 방법이 더 어려운 작업에도 효과가 있을지, 아니면 단지 그들의 사용 사례가 중요하지 않기 때문에 성공하는 것인지 의문을 제기합니다.

실용적인 구현 참고 자료로, 포크 가능한 예제가 포함된 전체 튜토리얼이 everyrow.io/blog/claude-code-workflow-engine에서 제공되며, 이 접근 방식에 관심 있는 다른 사람들을 위해 실용적인 구현 참고 자료를 제공합니다.