DOCs와 스킬관련 PRD 폴더트리

Question

PRD 부분 파트를 거의 5번넘게봤는데..
업데이트 전인거 같기도하고 github 코드보면,

ai한테 물어보고 공식문서를 봐도 docs폴더에 관한 내용은 안보이더라구요.

코드를 깃헙소스를 봐도,
agents/ 안데도 docs가 있고,

밖에도 docs가 있는데, 헷갈려서 . 루트 폴더의 docs는 그냥 예시로 강의자님이 만든 프로젝트 구조같기한데 맞는지는 모르겠네요.

agents/ 안에 docs 파일 안에 md는 서브에이전트같은데 ? 현재 서브 에이전트를 만들면 docs안에 들어가는게 아니라 agents/폴더안에 바로 md 형태로 만들어지더라구요.

그래서, 업데이트 전후로 비교해서 skills.md 방식때문에 그런것인지 물어봐도. 그 부분이 아니고 의도적 설계라고 나오네요.?
공식문서 폴더 디렉토리 best pratice도 보고 구글링도 해봣는데, docs관련해서는 안나와서요.
서브 에이전트도 그냥 만들어지는데 일부러 agents 안에 docs를 만들거나 dev폴더 만들어서 넣은건가요? 만약 그렇다면 그것도 제대로 작동하는건지. 여러번 돌려보고 찾아봐도 이 부분이 조금 헷갈립니다.

communityai8509 · Answer

안녕하세요, 인프런 AI 인턴입니다. luke님. 강의에서 다룬 PRD 및 서브에이전트 관리에 관하여 혼란스러우신 것 같습니다. 강의 내의 설명이나 깃허브의 코드가 현재 업데이트된 코드 구조와 차이가 있음을 이해하고 계신 것 같습니다. 여러분의 이해를 돕기 위해 다음과 같이 요약하겠습니다: PRD와 Docs 폴더 구조 루트 폴더의 docs 폴더 : 일반적으로 프로젝트의 공식 문서 및 설명서를 포함하기 위한 폴더로 사용됩니다. 강의자님이 프로젝트 시나리오 예시로 설정한 것입니다. 주로 프로젝트 소개, 사용법 설명서 등이 포함될 수 있습니다. agents 폴더 내의 docs 폴더 : 서브에이전트를 정의하기 위한 폴더로 사용되며 .md 파일 형태로 서브에이전트 문서가 배치될 수 있습니다. 강의에 따라 서브에이전트 역할을 관리하고자 할 때의 위치입니다. .claude/agents 폴더 : 현재 클로드 코드는 업데이트로 인해 새로운 폴더 구조가 적용될 수 있습니다. 이 폴더 구조 내에서는 특정 기능을 수행하는 서브에이전트 문서를 포함할 수 있습니다. 생성된 파일은 프로젝트의 요구사항에 따라 위치시킬 수 있으며, .claude/agents 하위에 자체적으로 직접 생성하거나 관리하는 것이 적합합니다. 최근 업데이트 사항 서브에이전트가 docs 폴더 안에 들어가는 것이 아닌 agents 폴더 안에 바로 생성될 수 있다는 점은 클로드 코드의 업데이트나 개선사항에 따른 것이며, 의도적인 설계일 가능성이 높습니다. 추가적으로 도움이 될 수 있는 자료 관련 예제나 보다 구체적인 설명을 원하시면 강의 내 자료 및 커뮤니티에서 제공된 다른 사용자분들의 질문을 참고하실 수 있습니다. 서브에이전트 활용 및 관련 질문 게시글 에서 다양한 상황에 대한 답변을 참조하시면 도움이 되실 것입니다. 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.