코딩 에이전트 DESIGN.md란? (opens in new tab)

코딩 에이전트는 빠르게 코드를 작성하지만, 지시하지 않으면 코드베이스의 아키텍처 의도를 모릅니다. Claude Code나 Codex에 모호한 티켓을 주면 컴파일되고 테스트도 통과하지만, 도메인 계층과 HTTP 계층의 경계를 조용히 깨는 코드를 만들 수 있습니다. DESIGN.md는 저장소 안에 아키텍처 의도, 제약 조건, 설계 결정을 기록해 에이전트가 추측하지 않고 규칙에 맞춰 작업하게 만드는 파일입니다. 지금 Apidog 사용해 보기 요약 DESIGN.md는 코드베이스의 아키텍처 의도, 제약 조건, 설계 결정을 Markdown으로 기록하는 저장소 파일입니다. README.md: 프로젝트가 무엇이고 어떻게 시작하는지 설명 AGENTS.md: 에이전트가 어떻게 빌드, 테스트, 린트해야 하는지 설명 CLAUDE.md: Claude Code 전용 지침 DESIGN.md: 코드가 왜 이런 구조인지, 무엇을 절대 깨면 안 되는지 설명 즉, AGENTS.md가 “어떻게 작업하는가”를 다룬...