AIエージェントの設定は、思ったより早く散らばります。

AGENTS.md、CLAUDE.md、MCP設定、hooks、runtime config、ローカルの補助スクリプト。最初は手で直せますが、複数のエージェントと複数の実行環境をまたぐと、どれが正なのか分からなくなります。

なぜGit管理するのか

目的は、設定をきれいに保つことではありません。事故ったときに説明できる状態にすることです。

  • どの変更で挙動が変わったのかを履歴で追える
  • 生成物とSource of Truthを分離できる
  • secret実値を設定repoへ混ぜない運用を検査できる
  • rollbackや差分レビューを仕組みにできる

設定が暗黙知になると、AIエージェントは便利な補助輪から、挙動の読めない自動化に変わります。そこまで行くと、だいたい人間のほうが尻拭いをします。

agent-configの役割

agent-config は、エージェント設定の入口を source/ に寄せ、そこからClaude Code / Codex向けの生成物を作るためのrepoです。

source/
  policies/
  runtime/
  mcp/
  hooks/
  projects/

generated/
  claude/
  codex/
  projects/

人間は source/ を編集し、CIやローカル検証で生成物の整合性を確認します。

まず固定するもの

最初に固定するべきなのは、凝った自動化ではありません。

  1. どのファイルがSource of Truthか
  2. secret実値をどこに置かないか
  3. どの操作が外部writeか
  4. 生成物を直接編集しないルール
  5. 失敗時に戻せる単位

このあたりを曖昧にしたまま自動化すると、速くなるのは開発ではなく混乱です。

次にやること

このブログでは、agent-configの設計、Codex/Claude Codeの読み替え、MCP catalog、Obsidian共有メモリ、Blog Scout構想まで順に記録していきます。

公開する記事も、設定と同じくGitHubをSource of Truthにします。ブログ基盤まで同じ思想で作るのは少ししつこいですが、こういうしつこさだけが後で効きます。