Claude Code 세션 간 프로젝트 컨텍스트는 어떻게 관리하시나요?

위의 두 댓글이 정답입니다. 안정적인 프로젝트 컨텍스트(CLAUDE.md, 컨벤션, 건드리면 안 되는 경계 등)를 레포에 유지하고, 에이전트가 행동하기 전에 이를 읽도록 강제하는 세션 시작 의식을 만드세요. /onboard 슬래시 명령어 패턴이 제가 본 것 중 가장 깔끔합니다. 사람이 오리엔테이션을 요청하는 걸 깜빡했는지 고민할 필요가 없으니까요. 제가 강조하고 싶은 건, 결정 사항을 코드와 분리하라는 점입니다. CLAUDE.md는...

제대로 생각하고 계시네요. 새 Claude Code 세션은 요청하면 레포를 검사하긴 하지만, 컨텍스트가 어딘가에 저장되어 있지 않으면 이전 대화 내용을 마법처럼 알 수는 없습니다. 보통 통하는 워크플로우는 이렇습니다: CLAUDE.md, 아키텍처 노트, 설정 명령어, 컨벤션, '건드리지 마시오' 경고 등 안정적인 프로젝트 컨텍스트를 레포에 유지하세요. 그리고 새 세션을 시작할 때 'CLAUDE.md를 읽고 관련 파일을 검사한 뒤 아키텍처를 요약해' 같은 명시적인 오리엔테이션 단계를 거치세요.

저는 memory/sessions/{날짜}.md 메모리 시스템을 유지합니다. 세션이 끝날 때마다 Claude가 무엇을 했는지, 어떤 문제나 특이사항이 있었는지 로그를 남기죠. 매 세션 시작마다 이걸 다 불러오지는 않지만(memory.md에 참조만 남겨서 모든 세션이 존재를 알게 함), '2주 전에 작업했던 X 기능 기억나?' 같은 질문을 가능하게 합니다. 더 높은 수준에서는 Claude에게 프로젝트 전체를 심층 분석해서 빌드하게 시키기도 하죠.

저만의 설정을 만들었는데 컨텍스트 관리가 그 일부입니다. https://github.com/AIOSAI/AIPass

현재 프로젝트에서는 이걸 위해 구조를 따로 잡았습니다. README, Claude.md, 모든 문서를 Claude의 60kb 읽기 제한 내에 들어오게 해서 초기 읽기 오류가 안 나게 했죠. README와 Claude.md가 다른 문서들을 가리키고, 문서들에는 에이전트가 프로젝트 개요를 파악하고 바로 기여를 시작할 수 있는 지침이 들어있습니다. 레포를 클론하고 에이전트한테 '가!'라고 하는 사람들을 불평하는 대신, 그런 행동 방식까지 고려하려고 노력 중입니다.

이걸 위한 앱을 만들었습니다: https://github.com/perpetualsoftware/pad 노션과 아사나를 대체하도록 설계되었고 에이전트가 구동하는 것을 의도했습니다. 수동 프로젝트 관리 시스템으로도 완벽하게 작동하지만, 진짜 힘은 에이전트가 워크스페이스를 설정하게 할 때 나옵니다. 오픈 소스이고 로컬에서 실행되며, 셀프 호스팅도 가능하고 원격 MCP를 통해 설치 없이도 사용할 수 있습니다.

도움 될 만한 거 두 가지 알려줄게. 아키텍처 패턴이랑 제약 사항 적어둔 CLAUDE.md 파일을 만드는 거랑, 세션 끝날 때마다 다음 세션 시작할 때 붙여넣을 짧은 인수인계 메모를 남기는 거야. 이렇게 하면 파일이 너무 커지지 않으면서도 맥락을 잘 유지할 수 있어. 좀 큰 작업할 때는 세션 끝에 "우리가 뭘 바꿨고 뭐가 남았는지 한 문단으로 요약해줘"라고 시킨 다음 그 내용을 다음 세션 시작할 때 붙여넣어. 매번 처음부터 다시 설명하는 것보다 훨씬 깔끔함.