prd.md 관련

Question

안녕하세요.   prd.md claude.md roadmap.md   세가지의 차이점이 무엇인지 헷갈립니다. 처음에는 claude.md에 원하는 프로젝트 사항을 입력하고 init으로 설정한다고 생각했는데요.   강의를 듣다보니, roadmap.md도 나오고 prd.md도 나오는데 왜 굳이 claude.md와 유사한 파일들을 만들어서 진행하시는 것인지 잘이해가 되지 않습니다.   cluade.md가 너무 비대해져서 프로젝트의 상세 사항들을 나눠주는 목적 정도 일까요?

강대웅 · Answer

잘 참고가 됐습니다. 감사합니다.

짐코딩 · Answer

안녕하세요 🙂 결론부터 말씀드리면, 세 파일은 비슷해 보이지만 역할이 완전히 달라요. CLAUDE.md 가 커져서 쪼갠 게 아니라 처음부터 목적이 다른 파일들입니다. CLAUDE.md — 항상 지켜야 할 규칙 클로드 코드가 세션을 시작할 때마다 자동으로 읽는 파일 이에요. 프로젝트의 기술 스택, 코딩 컨벤션, 폴더 구조, 작업할 때 항상 따라야 할 원칙을 담습니다. 한 번 정해두면 계속 적용되는 내용들이에요. PRD.md — 무엇을 만들지 기획 단계 에서 작성하는 요구사항 문서예요. 어떤 기능이 필요한지, 사용자는 누구인지, 어떤 화면이 있어야 하는지를 정리합니다. "무엇을" 만들지를 정의하는 거예요. ROADMAP.md — 어떻게, 어떤 순서로 만들지 구현 단계 에서 쓰는 작업 계획서예요. PRD에서 정의한 기능을 실제로 어떤 순서와 단위로 만들어갈지 쪼갠 것. "어떻게" 만들지를 정의합니다. 한 줄 정리 CLAUDE.md = 항상 적용되는 규칙 PRD.md = 만들어야 할 대상 ROADMAP.md = 만드는 순서 왜 나누는가? CLAUDE.md 가 비대해져서 나누는 게 아니라, 각 파일이 읽히는 시점과 목적이 다르기 때문 이에요. 한 파일에 다 넣으면 이런 문제가 생깁니다. 첫째, 토큰 낭비 . CLAUDE.md 는 매 세션마다 자동으로 읽혀요. 여기에 PRD와 ROADMAP 내용까지 다 넣으면, 기획 단계에서만 필요한 내용이 구현할 때도 컨텍스트를 잡아먹습니다. 둘째, 역할 혼재 . 규칙, 요구사항, 작업 순서가 한 문서에 섞이면 클로드가 지금 뭘 기준으로 판단해야 할지 흐려져요. 셋째, 유지보수 . 요구사항이 바뀌었는데 작업 순서 옆에 섞여 있으면 어디를 고쳐야 할지 찾기 어려워집니다. 이렇게 읽히는 시점과 목적으로 파일을 분리하는 것 이 컨텍스트 엔지니어링의 핵심이에요. 강의 전체를 관통하는 탐색 → 계획 → 구현 워크플로우에서도 CLAUDE.md 는 항상, PRD.md 는 계획 단계, ROADMAP.md 는 구현 단계에서 주로 활용됩니다. 감사합니다 🙂

인프런 AI 인턴 · Answer

안녕하세요, 인프런 AI 인턴입니다. 강대웅님. 프로젝트 문서화를 효율적으로 관리하기 위해 여러 .md 파일들을 사용하는 것은 매우 중요한 전략 중 하나입니다. 각각의 파일은 특정 목적을 가지고 관리의 편의성과 프로젝트의 명확성을 높이기 위해 사용됩니다. 세 가지 파일의 차이점을 간단히 설명드리겠습니다: CLAUDE.md : 목적 : 주로 AI 모델인 Claude가 프로젝트의 주요 지침을 읽고 이해할 수 있도록 정보를 담고 있는 파일입니다. 클로드가 작업하는 동안 참조해야 하는 중요한 규칙이나 전반적인 프로젝트 정보를 명시합니다. init 명령어를 통해 이 파일이 생성되며, 프로젝트의 기본 설정을 담당합니다. ROADMAP.md : 목적 : 프로젝트의 개발 계획을 정리하는 데 사용되는 파일입니다. 프로젝트의 주요 마일스톤, 향후 목표, 진행 계획 등을 포함합니다. 직접적으로 코드 실행에 관여하기보다는 팀원들이 개발 계획을 명확히 이해할 수 있도록 돕습니다. PRD.md (Product Requirements Document) : 목적 : 제품 요구사항을 정리한 문서로, 프로젝트 목표, 기능적 요구사항 및 비기능적 요구사항 등을 상세히 작성합니다. 개발자, 디자이너, 제품 관리자 등 팀의 여러 구성원이 프로젝트 요구사항을 통일되게 이해할 수 있도록 지원합니다. 이러한 문서들 중에서도 claude.md는 AI가 필요로 하는 지침을 담고 있어 과도한 정보로 인해 복잡해질 수 있습니다. 이를 해결하기 위해 roadmap.md나 prd.md와 같은 문서로 프로젝트의 특정 부분들을 나누어 관리합니다. 이렇게 나누는 것은 문서의 가독성과 관리의 용이성을 높이기 위한 방법입니다. 유사한 질문과 답변은 다음 링크를 참고하시면 도움될 것입니다: - “CLAUDE.md와 ROADMAP.md, README.md 뭐가 다른거에요?” 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.