AI を使った開発#

relayer は、AI エージェントや LLM と一緒に開発することを前提に、規約をコードと一緒に配ります。relayer init（CLI コマンド）が生成するファイル群は polidog/relayer に同梱され、フレームワークと co-versionされるため陳腐化しません。すべて skip-if-exists で、利用者が自分で置いたファイルを上書きしません。

RELAYER.md（唯一の正）#

RELAYER.md は、エージェント／LLM 向けの簡潔で権威ある実装規約です。ファイル規約、route.php / middleware.php / Island の契約、最小主義、そして「やらないこと」の一覧を 1 ファイルにまとめています。人間も読めますが、第一の読者は AI です。手で書いた散発的な指示ではなく、フレームワークと同梱・co-version されるため、relayer を上げれば規約も自動で最新になります。

AGENTS.md / CLAUDE.md（自動で読まれるポインタ）#

AGENTS.md と CLAUDE.md は、それぞれエージェントツールと Claude Code が自動で読むファイル名です。中身は 2 行だけで、RELAYER.md を指すだけ。実体を二重管理せず、どのツールから入っても同じ唯一の正（RELAYER.md）にたどり着かせるための薄いポインタです。これらも skip-if-exists なので、利用者自身の AGENTS.md / CLAUDE.md がある場合はそれを尊重します。

.claude/（Claude Code 向けツール）#

.claude/ 配下には Claude Code 用のツールが 2 つ生成されます。

パス	種別	役割
`.claude/skills/relayer-routing/SKILL.md`	skill	トリガー時にルーティング / `Response` / CSRF 契約を与える
`.claude/agents/relayer-reviewer.md`	subagent	変更を `RELAYER.md` に照らしてレビューする

どちらも RELAYER.md を唯一の正とし、同じ理由で co-version・ skip-if-exists です。relayer-routing skill はルーティングや Response 周りの作業時に契約を差し込み、 relayer-reviewer subagent は書いたコードが規約から外れていないかを RELAYER.md 基準で点検します。

使い方#

composer require polidog/relayer 後に relayer init を実行する

と、上記がすべて生成されます（既存ファイルは触りません）。

Claude Code やエージェントツールはリポジトリ直下の AGENTS.md /

CLAUDE.md を自動で読み、RELAYER.md の規約に従って実装します。

relayer を上げたら relayer upgrade（CLI コマンド）で

新しい構造バージョンで追加された規約ファイルも前進させます（skip-if-exists なので編集済みは保持）。

変更後は relayer-reviewer で RELAYER.md 準拠をレビューします。

規約を 1 ファイルに集約し、フレームワークと co-version することで、「AI 向けの指示が古い／プロジェクトごとにバラバラ」という典型的な劣化を避けられます。プロファイラ（プロファイラ）と組み合わせると、AI が生成したコードの挙動を実測しながら進められます。