一つのファイルから生成しても、指示のズレは止まらないThe author built a tool to generate all AI agent instruction files from a…
匿名の公開いいねです。記事の保存・お気に入りではなく、Featured、Top 3、重要度、掲載順位には影響しません。仕組みとプライバシーAnonymous public likes are reactions, not saved articles or bookmarks. They do not affect Featured, Top 3, importance, or listing order.How it works and privacy
AGENTS.md を単一ソースとして各AIエージェントの指示ファイルを自動生成するツールを作成したが、生成だけでは解決できない「ズレ」が実運用で残ることを筆者が検証・報告している。
The author built a tool to generate all AI agent instruction files from a single AGENTS.md source, but found through real-world testing that generation alone cannot eliminate instruction drift between agents.
本ページの本文と要約は AI による自動生成です。日本語版と英語版は言語ごとに独立して生成されるため、表現や詳しさが異なる場合があります。正確性は元記事 (zenn.dev) をご確認ください。The body and summaries are AI-generated independently for each language, so wording and detail may differ. Verify accuracy at the original source (zenn.dev).
要約と収集メタデータに基づく AI 解説。元記事全文の転載・翻訳ではありません。AI explainer based on the summaries and collected metadata, not a copy or translation of the full source article.
指示ファイル
AIエージェント向けの指示ファイルを一つの元データから生成しても、指示のズレは止まらなかったという検証報告だ。生成の仕組みが動作することと、実運用上の問題が解消されることは別だという点が本題になっている。
単一ソース
対策は、指示の写しを個別に持つのをやめ、AGENTS.mdを単一ソースにするものだ。そこからCLAUDE.md、.cursor/rules/*.mdc、.github/copilot-instructions.mdを生成するツール「agent-fanout」が作成され、実際に動作すると説明されている。
実運用のズレ
一方、筆者は実機で動かすまで、生成だけでは問題が解けないことに気づかなかったとしている。単一ファイルから各指示ファイルを作る範囲はカバーできても、エージェント間の指示のズレを完全にはなくせず、実運用では課題が残ったという内容だ。
A Single AGENTS.md Source
The author built a tool that generates multiple AI agent instruction files from one AGENTS.md file. The approach matters because it directly targets instruction drift by removing the need to maintain separate copies manually.
Generate All Instruction Files
Under this setup, AGENTS.md acts as the single source for generating CLAUDE.md, .cursor/rules/*.mdc, and .github/copilot-instructions.md. The author says the tool was created and works, and provides the agent-fanout repository at https://github.com/untactit/agent-fanout.
This generation process covers the differences that can be addressed by producing the instruction files from the same source rather than keeping independent copies.
Generation Alone Cannot Eliminate Drift
However, the author reports that the underlying problem remains unresolved. Through real-world testing, the author found that generating every instruction file from one source does not, by itself, eliminate instruction drift between agents.
The central point is therefore the gap between having a functioning generation tool and actually preventing instructions from diverging in operation.
ポコとTECHガイドPoko & TECH Guide
ポコと当サイトのTECHガイドが、記事の要約と収集した情報から読みどころを語るAI生成の対話です。Poko and TECH Dashboard's own TECH Guide discuss the article's highlights in an AI-generated conversation based on its summary and collected source details.
- ポコPoko仕事でAIエージェントごとに指示を書く手間が減るの？普段の管理はどう変わるんだろう。Would this cut down the work of writing instructions for every AI agent? How would day-to-day management change?
- TECHガイドTECH GuideAGENTS.mdを一つ書けば、各エージェント向けの指示ファイルを自動生成できるのじゃ。ただしこの記事では、生成しても指示のズレは残ったそうじゃよ。You can write one AGENTS.md and generate instruction files for each agent. But the author found in real-world use that generation still didn’t eliminate instruction drift.
- ポコPoko前はできなかったの？一つのファイルから作れば、全部そろってズレなくなりそうだけど。Wasn’t that possible before? If every file comes from one source, I’d expect them all to stay aligned.
- TECHガイドTECH Guide従来は指示の写しを複数持つため、内容がズレる問題があったのじゃ。今回のツールは写しの生成をまとめたが、それだけでは解決しないと報告されておる。Previously, keeping multiple copies could let instructions drift apart. This tool centralizes their generation, yet the post reports that this alone doesn’t solve the problem.
- ポコPokoへえ、一番の収穫は「元を一つにすれば終わり」ではないと実機で分かったことなんだね。Oh, so the key takeaway is that real-world testing showed one source of truth isn’t the end of the story.
- TECHガイドTECH Guideそうじゃな。次は、生成でカバーできないズレが実運用のどこで生まれるのかに注目じゃ。Exactly. The next thing to watch is where drift appears in actual use beyond what file generation can cover.
