DESIGN.md란 무엇인가? AI 시대의 개발을 극적으로 바꾸는 「설계도」 작성법

엔지니어들 사이에서 지금 폭발적인 주목을 받고 있는 파일이 있습니다. 그것이 바로 **「DESIGN.md」**입니다.

Cursor나 GitHub Copilot 같은 AI 코딩 도구를 사용하고 있을 때, "AI가 멋대로 의도하지 않은 코드를 쓰기 시작했다", "프로젝트의 전체상을 이해하지 못한다"라고 고민해 본 적은 없으신가요?

그 고민을 단번에 해결해 주는 것이 바로 이 DESIGN.md라는 마법의 파일입니다.

DESIGN.md란, 프로젝트의 「설계 사상」, 「구조」, 「목표」를 인간뿐만 아니라 「AI가 이해하기 쉬운 형태」로 정리한 Markdown 형식의 파일을 말합니다.

기존에는 설계서가 Word나 Excel, Wiki 등에 흩어져 있었습니다. 하지만 DESIGN.md는 코드와 동일한 디렉토리(Directory)에 배치됩니다. 이를 통해 AI가 "이 프로젝트는 무엇을 목적으로 하며, 어떤 규칙으로 움직이는가"를 항상 참조하면서 코드를 생성할 수 있게 됩니다.

공식 사이트에 대하여:

DESIGN.md에는 RFC와 같은 엄격한 「공식 사양」이나 「공식 사이트」는 존재하지 않습니다. 하지만 AI 네이티브(AI-native)한 개발 스타일을 제창하는 개발자들 사이에서

**데파크토 스탠다드 (De facto standard, 사실상의 표준)**로서 퍼지고 있습니다.

장점	단점
AI의 출력 정밀도가 극적으로 향상된다	문서 작성의 수고가 든다
...

최대의 장점은 AI에게 **「문맥 (Context)」**을 제공할 수 있다는 점입니다. 이를 통해 "말하지 않아도 알아주는" 상태를 만들어낼 수 있습니다.

그렇다면 실제로 어떤 내용을 작성해야 할까요? 다음의 4가지 단계로 구성하는 것을 추천합니다.

「이 앱은 무엇을 위해 존재하는가」를 한 문장으로 기술합니다.

사용하는 언어, 프레임워크 (Framework), 디렉토리 구조의 규칙을 명기합니다.