Claude의 프로젝트 요약을 저장소에 체크인하세요 — 사람이 작성한 문서보다 낫습니다

HN의 한 개발자가 실용적인 워크플로를 공유합니다: 프로젝트에서 Claude를 사용한 후, 해결한 내용과 변경 사항에 대한 구조화된 고수준 요약을 작성하도록 요청하고, 검토한 후 저장소에 커밋하는 것입니다. 이 요약은 개발자가 직접 작성하는 것과 비교해 품질이 비슷하지만, 1시간 대신 10초면 생성되며, 검토 시간도 1시간에 크게 못 미칩니다.

게시글의 주요 내용:

• Claude의 핸드오프 문서를 버리지 마세요. PROJECT.md 등으로 커밋하세요.
• Claude는 프로젝트가 끝날 때 처음부터 새로운 개요를 작성할 수도 있습니다.
• 개발자는 커밋하기 전에 직접 검토하고 편집합니다 — 인간 프로그래머의 작업과 마찬가지로요.
• 한 가지 주의할 점: Claude가 이전 요약의 "Approved-by" 단락을 새 요약에 복사했습니다. CLAUDE.md에 지침을 추가해 이를 방지하세요.
• 이 조언은 명백하지 않지만, 저자는 프로젝트 연속성에 게임 체인저라고 생각합니다.

실용적인 결론: Claude를 많이 사용한 프로젝트가 끝나면 요약을 생성하고 커밋하세요. 다음 개발자 — 또는 미래의 여러분 — 이 git 히스토리를 뒤질 몇 시간을 절약할 수 있습니다.