AIが迷わないリポジトリ設計――agent legibility を実装に落とす4つのパターン
Claude Code / Codex を本格運用しても出力が安定しない原因は、多くの場合プロンプトではなくリポジトリ構造側にあります。AGENTS.md / サブエージェント / フック / 作業コンテキストを役割別に配置する4つの設計パターンを、Growth Lab の実リポジトリを例にまとめました。
Growth Lab編集部
読了時間 約19分
読み込み中...
4 件の記事が見つかりました
Claude Code / Codex を本格運用しても出力が安定しない原因は、多くの場合プロンプトではなくリポジトリ構造側にあります。AGENTS.md / サブエージェント / フック / 作業コンテキストを役割別に配置する4つの設計パターンを、Growth Lab の実リポジトリを例にまとめました。
暗黙知は個人ではなく組織設計の問題。10〜50名の開発組織でEM・Tech Leadが押さえるべき4本柱(オンボーディング/Decision Log/レビュー/文脈ファイル)と、AI時代のCLAUDE.md/AGENTS.md運用を一次情報で解説。診断テンプレ配布。
CLAUDE.md を長文化するだけでは運用は安定しない。このリポジトリで使っている AGENTS.md、タスク台帳、REPORT.md、skills、hooks の責務分離を、Claude Code 運用の実例として整理する。
CLAUDE.md最適化の本質は「何をたくさん書くか」ではなく「何をどこに分離するか」。Anthropicの公式ドキュメントに沿って、AIエージェントが迷わず安全に働けるリポジトリ環境の構築設計を解説します。