AIが迷わないリポジトリ設計
Claude Code / Codex の出力が安定しない原因はプロンプトではなくリポジトリ構造側にある。ルール階層・エージェント定義・スキルとフックの棲み分け・作業コンテキスト外部化の4パターンを実リポジトリを例に解説。
AI開発の検証室 編集部
読了時間 約25分
読み込み中...
4 件の記事が見つかりました
Claude Code / Codex の出力が安定しない原因はプロンプトではなくリポジトリ構造側にある。ルール階層・エージェント定義・スキルとフックの棲み分け・作業コンテキスト外部化の4パターンを実リポジトリを例に解説。
暗黙知は個人ではなく組織設計の問題。オンボーディング/Decision Log/レビュー/文脈ファイルの4本柱と、CLAUDE.md・AGENTS.md を SSoT に組み込む運用を診断10項目付きで解説。
CLAUDE.md を長文化するだけでは運用は安定しない。このリポジトリで使っている AGENTS.md、タスク台帳、REPORT.md、skills、hooks の責務分離を、Claude Code 運用の実例として整理する。
CLAUDE.md最適化の本質は「何をたくさん書くか」ではなく「何をどこに分離するか」。Anthropicの公式ドキュメントに沿って、AIエージェントが迷わず安全に働けるリポジトリ環境の構築設計を解説します。