KubernetesにおけるClaudeコードのワークフローエンジンとしてMarkdownファイルを使用する

ある開発者が、Claude CodeがKubernetes内で実行するプレーンな英語のマークダウンファイルを使用して、型破りなワークフローエンジンを実装しました。Dagster、Prefect、Argoのような従来のパイプライン定義ツールの代わりに、シンプルな指示を含むSKILL.mdという名前のマークダウンファイルを使用しています。

仕組み

このシステムは、Claude CodeをKubernetes CronJobとして実行します。ワークフローのロジックは、「Redditをスキャンし、分類し、PRを作成する」といったプレーンな英語で書かれたマークダウンファイルで定義されます。このアプローチにより、開発者の上司のような非技術系のチームメンバーも、直接パイプラインロジックを記述できます。

Claude Codeはこれらのマークダウン指示に従い、アーティファクトをディスクに書き込むことでワークフローステップを調整します。開発者は、このシステムを1か月以上稼働させており、予想以上に安定していると報告していますが、デバッグ体験は粗く、一貫した動作が保証されない点も指摘しています。

実用的な考慮事項

開発者は、このアプローチが、シンプルさと信頼性のトレードオフが許容される低リスクのパイプラインに最適であると示唆しています。このプレーンな言語指示の方法が、より困難なタスクでも機能するのか、それとも彼らのユースケースが非クリティカルであるから成功しているだけなのか、疑問を投げかけています。

実装例を含む完全なチュートリアルは、everyrow.io/blog/claude-code-workflow-engineで公開されており、このアプローチに関心のある他の人々のための実用的な参考資料を提供しています。