株式会社ずんだもん技術室AI放送局 podcast 20260326

youtube版(スライド付き) 関連リンク AGENTS.md完全入門 ── 60,000リポジトリが採用した事実上の共通フォーマット AIコーディングエージェント（GitHub Copilot, Cursor, Claude Code等）の普及に伴い、ツールごとに独自の指示ファイルを用意する手間や、指示の不整合が課題となっていました。本記事は、それらを解決する共通規格「AGENTS.md」について、新人エンジニアにも分かりやすく解説したガイドです。 1. AGENTS.mdとは何か 一言で言えば「AIエージェント向けのREADME」です。これまでは、Cursorなら.cursorrules、Copilotなら.github/copilot-instructions.mdと、ツールごとに異なるファイルに同じ指示（使用技術や命名規則など）を書く必要がありました。AGENTS.mdはこれらを一本化し、1つのMarkdownファイルで複数のエージェントに共通の指示を伝えるためのオープンフォーマットです。現在はLinux Foundationの「Agentic AI Foundation」によって標準化が進められており、すでに6万件以上のリポジトリで採用されています。 2. なぜ導入するのか（メリット） 重複管理の解消: 1つのファイル（AGENTS.md）を更新するだけで、チーム内の異なるツール利用者に同じルールを適用できます。導入の容易さ: 標準的なMarkdown形式であり、特別な学習やツール導入は不要です。品質の安定: 「テストコードは必ず書く」「.envファイルは触らない」といった境界線を明示することで、AIの誤操作を防ぎ、PR（プルリクエスト）のレビュー修正数を減らせます。 3. 効果的な構成要素 AIに正しく動いてもらうために、以下のセクションを含めることが推奨されています。 Project Overview: 使用技術（React 18, Node.js等）を具体的に記載。Commands: pnpm testなど、エージェントが実行すべき完全なコマンド。Code Style: 命名規則など。文章より「良いコード例」を載せるのが効果的。Boundaries（重要）: 「本番環境の設定は変えない」など、AIに「やってはいけないこと」を伝えます。 4. 運用のポイント 新人エンジニアが今日から実践できるポイントは以下の通りです。 書きすぎない: 指示が多すぎるとAIが混乱します。まずは最重要ルールを5〜10個程度から始めましょう。READMEと使い分ける: 人間が読むための説明はREADME.mdに、AIが作業するための技術的な指示はAGENTS.mdに書くのがベストです。モノレポ対応: ルートディレクトリだけでなく、サブディレクトリにも配置可能です。AIは作業対象に最も近いファイルを優先して読み取ります。 5. まとめ AGENTS.mdは、AIとの協調開発をスムーズにするための「共通言語」です。個人の開発効率を上げるだけでなく、チーム全体のコード品質を保つための強力な武器になります。まずは最小構成からリポジトリに配置し、AIエージェントの挙動がどう安定するかを体感してみてください。 引用元: https://qiita.com/nogataka/items/ad15bfa383c98ae5cc36 Storybook MCP を試してみた 「Storybook MCP」は、AIエージェントが開発プロジェクト内のStorybook（UIコンポーネントのカタログ）を直接参照し、デザインシステムに一貫したUIコードの生成や、インタラクションテストの実行を自律的に行えるようにする仕組みです。 これまでAIにUIの実装を依頼すると、既存のコンポーネントを無視して独自のコードを生成してしまったり、Propsの仕様を誤認してエラーが発生したりといった課題がありました。Storybook MCPを活用することで、AIはコンポーネントのドキュメントを「読んで」理解し、正しいPropsの利用やテストまでを一人で完結できるようになります。 主な機能とメリット: ドキュメントの自動参照: AIがコンポーネントの一覧や詳細な仕様（Props、バリアント、使用例）を取得します。これにより、AIが仕様を「捏造」するのを防ぎます。自律的なテストと修正: 生成したUIに対してインタラクションテストを実行し、失敗した場合はAIが自らコードを修正して再テストを行います。カラーコントラストなどのアクセシビリティチェックも可能です。プレビュー連携: 生成されたストーリーをStorybook上で確認するためのプレビューURLを発行し、開発者が即座に動作を確認できる環境を提供します。 新人エンジニアが知っておくべきポイント: AIエージェントが...