コーディングエージェント向け DESIGN.md とは？ (opens in new tab)

コーディングエージェントは高速で自信満々ですが、指示しない限りコードベースのアーキテクチャを知りません。Claude CodeやCodexに曖昧なチケットを渡すと、コンパイルできて簡単なテストに通るコードは作れます。しかし、ドメイン層とHTTP層の境界、トランザクション方針、API契約などを静かに破ることがあります。DESIGN.mdは、エージェントが必ず参照できるリポジトリ内に、アーキテクチャ上の意図・制約・判断理由を書き残すための実用的なファイルです。 今すぐApidogを試す TL;DR DESIGN.mdは、コードベースのアーキテクチャ意図、制約、設計判断をMarkdownで記録するリポジトリ内ドキュメントです。 主な目的は次のとおりです。 Claude Code、Codex、Cursorなどのコーディングエージェントに設計上の前提を渡す レイヤー境界、ドメイン不変条件、API契約を守らせる 「なぜこの設計なのか」を説明する AGENTS.mdやCLAUDE.mdを肥大化させず、そこから参照させる 役割の違いはシンプルです。 README.md: これは何か、どう始めるか...