背景
リポジトリごとに置いているCLAUDE.mdは、Claude Codeへの指示書だ。ログの書き方や文体のルールもここに書いてある。
OrcaでClaudeとCodexを並べて使うようになって、困ったことが出た。CodexはCLAUDE.mdを読まない。Codexが読むのはAGENTS.mdで、これはCursorやCopilotなど他のツールでも共通の規格になりつつある。
どちらを本体にするか
案は2つ。AGENTS.mdをほぼ空にして「CLAUDE.mdを見ろ」と書くか、AGENTS.mdを本体にするか。
前者は不採用にした。Codexには他のファイルを取り込む機能がなく、「見ろ」と書いてもファイルを開く行動に頼ることになる。毎回ツールを呼ぶし、読まない可能性もある。
後者を採用した。Claude CodeのCLAUDE.mdには@ファイル名で別ファイルを取り込む機能がある。つまりCLAUDE.mdは@AGENTS.mdの1行で済む。Next.jsやExpoの生成ツールが作ったリポジトリは、気づけば最初からこの形だった。
AGENTS.mdの方が抽象度が高いので本体にする、という自分の感覚にも合っていた。
置き方
リポジトリの中にはシンボリックリンクを置かない。クローン先やWindowsで壊れるからで、中は実ファイルにする。リポジトリの外のドットファイルは、環境設定のリポジトリから張るシンボリックリンクでよい。
Codexはリポジトリの外のAGENTS.mdを読まないので、全リポジトリ共通のルールは~/.codex/AGENTS.mdにリンクを張って読ませる。Gemini CLIも同じ要領でGEMINI.mdを用意した。
27のリポジトリをまとめて直し、同じ日にGitHubまで反映した。
おまけ:/log-endがminiで効かなかった件
同じ頃、セッションの終了処理をするコマンド/log-endがMac miniで使えないことに気づいた。原因はOrcaではなく、コマンドの定義ファイルがMacBookのフォルダ直下にあって、gitの外だったこと。機材を増やした瞬間に、git外の設定ファイルは抜け落ちる。
これも環境設定のリポジトリに収めて、両方の機械からシンボリックリンクで参照する形にした。
感想
log-endがmac miniで使えないとは。どれをリポジトリにして、どれをローカル・リモートにするかも整理しないとだな。
Orcaでの作業がだいぶ整ってきた。リポジトリ周りもきれいになった。