エンジニアの間で今、爆発的に注目を集めているファイルがあります。それが「DESIGN.md」です。
CursorやGitHub CopilotなどのAIコーディングツールを使っている時、「AIが勝手に意図しないコードを書き始めた」「プロジェクトの全体像を理解してくれない」と悩んだことはありませんか？
その悩みを一気に解決するのが、このDESIGN.mdという魔法のファイルです。
DESIGN.mdとは何か？
DESIGN.mdとは、プロジェクトの「設計思想」「構造」「ゴール」を、人間だけでなく「AIが理解しやすい形」でまとめたMarkdown形式のファイルのことです。
従来、設計書はWordやExcel、Wikiなどに散らばっていました。しかし、DESIGN.mdはコードと同じディレクトリに配置されます。これにより、AIが「このプロジェクトは何を目的とし、どのようなルールで動くのか」を常に参照しながらコードを生成できるようになります。
公式サイトについて：
DESIGN.mdには、RFCのような厳格な「公式仕様」や「公式サイト」は存在しません。しかし、AIネイティブな開発スタイルを提唱する開発者たちの間でデファクトスタンダード（事実上の標準）として広まっています。
DESIGN.mdには、RFCのような厳格な「公式仕様」や「公式サイト」は存在しません。しかし、AIネイティブな開発スタイルを提唱する開発者たちの間でデファクトスタンダード（事実上の標準）として広まっています。
DESIGN.mdを導入するメリット・デメリット
| メリット | デメリット |
|---|---|
| AIの出力精度が劇的に向上する | ドキュメント作成の手間がかかる |
| プロジェクトの「ブレ」がなくなる | 実装と設計の乖離（ドキュメント腐敗）のリスク |
| 新規メンバーへの引き継ぎが爆速になる | 常に更新し続ける運用コストが発生する |
最大のメリットは、AIに対して「文脈（コンテキスト）」を与えられる点です。これにより、「言わなくてもわかってくれる」状態を作り出せます。
【実践】DESIGN.mdの書き方と手順
では、実際にどのような内容を書けばよいのでしょうか。以下の4つのステップで構成するのがおすすめです。
1. プロジェクトの概要と目的
「このアプリは何のために存在するのか」を1文で記述します。
2. 技術スタックとアーキテクチャ
使用する言語、フレームワーク、ディレクトリ構造のルールを明記します。