🍪

みんなCLAUDE.mdとかフォルダの数だけコピペしてるの?

に公開

もしPCが眼の前にあるときに、ふと作りたいものが頭に思い浮かんだら、GitHubのrepositoryをgit cloneして30秒後にはコードを書き始められる世の中です。どんなフレームワークを使おうとかどんな言語を使おうとか、Reactをnpm installしただけなのに意味不明な数のライブラリがnode_modules以下にインストールされて恐怖を感じるな…などと悩むことはもうほとんどありません。そんな悩みはもはや些末なことで、あなたはただClaude CodeにでもCodexにでも作りたいイメージを情熱を持って伝えるだけで、アイデアを即形にできます。

…いや、よく考えたらそんなにうまい話ではありませんでした。
AIはちゃんと人類にも悩みの種は残しています。新しくプロジェクトを作ったあとに悩む問題、AIにコードを書かせるために必須の設定ファイルのAGENTS.md(CLAUDE.md)や.agentsディレクトリ(.claude)をどこから持ってくるのか、毎回ゼロから作り始めるのかどうか、というファイル管理の悩みを。

皆さん、これらのファイルの管理をどうやっているのでしょう?(単に自分がこのあたりの事情に疎いだけかもしれませんが)

エージェントコーディングを続けていくと、AIに常に意識してほしい言語固有のアーキテクチャのベストプラクティス、逆に避けてほしいアンチパターン、テスト時のレビュー項目などがどんどん顕在化していきます。それらはSKILLなどの形で蓄積され、プロジェクトをスムーズに進める上で欠かせない貴重なナレッジとなっていきます。そしてそれは再利用できるし、作って終わりではなくその後もどんどん成長させていきたいリソースでもあります。
AGENTS.mdや.agents以下に蓄積したファイルは別のプロジェクトでも使えるようにしたい、そして他のプロジェクトで得た新たな知見を反映してどんどん育てていきたい、そのために一元管理できるようにしたい、という思いが芽生えるのは自然なことでしょう。

そのために自分は次のようなツールを作って運用しています。

https://github.com/tacogips/ign

これは基本的にはcookie cutterのようなテンプレート作成ツールです。
機能として、

  • GitHubから直接checkoutできる。
  • 変数を指定できる(project descriptionやディレクトリ、ファイル名など)
  • template側が更新されたらそれを取り込める。(初回に入力した変数を保持しているので変数の再入力が不要)

テンプレートの例はこちらです
https://github.com/tacogips/ign-template

下記のようにignでテンプレートをcheckoutし、必要な変数を入力すると、bunで動くプロジェクトの雛形(AGENTS.md、CLAUDE.md、.agents、.claudeおよびソースコードのディレクトリ)が作成されます。

mkdir new_proj
cd new_proj

ign checkout https://github.com/tacogips/ign-template/bun-ts-v1

(CLAUDE.md、.claudeはそれぞれAGENTS.md、.agentsディレクトリへのシンボリックリンクになっています)

goで何か作りたい場合はこちら

ign checkout https://github.com/tacogips/ign-template/go-v1

これらを使って雛形を作ったプロジェクトで、新たにSKILLやサブコマンドなど汎用的に使えるものが追加されたとします。それをtemplate側にも取り込めます。
上の例では https://github.com/tacogips/ign-template/
のテンプレートを更新して、task template-update-allを実行します。この更新でテンプレートのハッシュ値が変わり、テンプレートを使っている側でテンプレートに変更があったことが検知できます。

テンプレートの変更を取り込みたいときは、テンプレートを使用しているプロジェクト(直下に.ign/があるディレクトリ)で

ign update

を実行することでGitHubのテンプレートから更新を取り込めます。

自分はこれを使って、ign-template側でAI用のプロンプトを一元管理・保守し、その更新を複数のプロジェクトに伝播できるようになっています。

皆さんはこれらのファイルをどうやって管理していますか?オススメのやり方があればぜひ教えてください。

Discussion