HANDOFF.md 문서작성

Question

강의 : [13. 5. SDD 워크플로우 러너 - AI 페어 프로그래밍] 문의지점 : 07:58~08~37 부분 SDD 워크플로우에서 <모든 검증 통과 후 Task.md 업데이트 -> HANDOFF.md 작성>을 클로드가 자동으로 하는 모습이 나오고, 강사님께서는 "오토 컴팩트를 신뢰하지 않기 때문에 전역설정에 무조건 핸드오프 문서(다음 세션에서 이전 세션에 뭐 했는지를 알아보기 위해 작성하는 문서)를 작성하라고 명령을 해두었다"고 말씀주셨는데 (** 경로 : claudedocs > HANDOFF.md ) 제 결과물에서는 HANDOFF.md 문서작성이 자동으로 되지 않더라구요. 요거 혹시 따로 설명주신 부분이 있을까요..? 찾지 못해 여쭙니다. 플코님 강의 너무 잘듣고 있습니다.

FlowCoder · Answer

안녕하세요, teamevople님. 먼저 매끄럽지 못한 부분을 찾아주셔서 감사합니다. SDD workflow init - 프로젝트 구조 생성 plan - PRD 작성 design - Tech_spec 작성 build - 코드 구현 review - 품질 검증 강의 기준으로 위와 같이 흐름이 구성되어 있고, 이 단계가 종료되면 handoff.md 를 작성하도록 claude.md 에 지침을 추가하시면 됩니다. 클로드에게 "SDD workflow에서 품질 검증이 통과되면 handoff.md 를 작성할 수 있도록 claude.md에 지침을 추가해줘." 라고 지시해보세요. 아래는 claude.md 와 관련하여 모든 프로젝트에 공통 적용하는 전역 지침과 프로젝트 개별 지침에 대한 내용을 추가로 작성했으니 참고해보세요. Mac 전역설정 경로 보기 : 터미널에 명령어 입력, open ~/.claude Windows 전역설정 경로 보기 : 탐색기에 경로 입력, %USERPROFILE%\.claude 전역설정 경로(~/.claude)에 있는 claude.md 파일에 지침을 추가하면 모든 프로젝트에 반영됩니다. (없다면 생성하여 작성) 전역 claude.md 와 프로젝트 claude.md 가 중복되면 프로젝트 claude.md가 우선순위를 가져가지만 같은 주제로 모순되는 지침을 두면 흔들릴 수 있으니 전역에는 개인 취향만 넣고, 프로젝트 규칙은 프로젝트 cluade.md에만 두는 방안으로 역할을 분리하는게 깜끔합니다.

communityai8509 · Answer

안녕하세요, 인프런 AI 인턴입니다. teamevople님, 이렇게 질문 주셔서 감사합니다. HANDOFF.md 문서의 자동 작성을 원하시는 경우, Claude Code 설정에서 관련 사항이 제대로 구성되었는지 확인해 보셔야 합니다. 강의에서 설명한 &ldquo;전역 설정&rdquo;은 이런 자동화 작업의 핵심 요소이기 때문에, 설정이 올바르게 되어 있어야 합니다. 관련 내용 및 설정 점검 전역 설정 확인 : 클로드의 설정 파일에서 HANDOFF.md 작성과 관련된 명령어가 포함되어 있는지 체크해야 합니다. 강의의 해당 부분을 다시 한번 확인하면서 설정 파일이 동일하게 구성되어 있는지 보시는 것이 좋습니다. 로컬 환경 및 설정 확인 : 로컬 환경에서 필요한 설정들이 제대로 되어 있는지 점검해주세요. 특히, API 키나 필요한 플러그인들이 빠짐없이 설정되었는지 확인하는 것이 중요합니다. 강의 내 관련 답변 에서 AI 페어 프로그래밍 세션 설정에 대한 참고 자료를 통해 자세한 설정 방법을 도움이 되는 유사 질문을 확인하실 수 있습니다. 위 게시물에서는 Claude의 설정과 각종 자동화 명령에 대한 개념을 다루고 있으니 참고하시면 좋겠습니다. 또한, 강사님이 제공한 자료들이 최신 자료인지 언급된 바와 같이 강의 중간중간의 자료나 코드 업데이트 내용을 반영하셨는지도 중요합니다. 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.