Cluedoc: コードベースの理解を助けるドキュメント作成エージェントスキル

コーディングエージェントが次々と吐き出すコードに、うんざりしていませんか？ そのせいで、自分のソフトウェアを理解することを諦めてしまいましたか？

エージェントがコードを書くなら、理解することが最も重要な仕事になります。自分では1行も直接タイプしておらず、コードベースは絶えず変わり続ける中で、システムが実際に何をしているのか、次の修正が安全なのかを、どうやって把握すればよいのでしょうか？ エージェントが代わりに作業してくれるとしても、エージェントを正しい方向へ導くには、自分たちが作っているシステムについて最低限の理解が必要です。

そこで Cluedoc を作りました。Cluedoc は、コーディングエージェントに人が読みやすいドキュメントを書かせるための Agent Skill です。Cluedoc のドキュメントは、読まれるために作られています。技術的な詳細を除き、より高いレベルの概念に集中します。

Cluedoc はシステムを機能（feature）のツリーとして捉え、機能ごとに1つのドキュメント（paper）を書きます。ドキュメントはコードベース内に純粋な Markdown として存在し、作業ループの中で常に最新の状態に保たれます。サーバーも不要で、データベースも不要です。

リンク先のランディングページ自体が、Cluedoc について書かれた Cluedoc ドキュメントです。Flask、Cobra、Commander について生成したサンプルドキュメントもあるので、ぜひ見てみてください。