context 복사 명령 및 새 창 인계 문서 정리

질의 원문

이 프로젝트도 새로운 창에서 작업을 하려고 해. 그래서 기존의 내용을 모두 정리 요약하여 context를 이어갈 수 있도록 해심적인 내용을 요약해주고 상세 내용이 필요할 경우 세부 내용에 맞는 파일을 설명해주고 프로젝트 내부의 파일들에 대한 설명 문서도 남겨서 필요한 경우 읽고 내용을 정확하게 파악할 수 있도록 해줘.

지금 위의 내용을 명령어로 하나 추가해서 'context 복사' 라는 키워드 명령을 하나 만들어서 진역 지침에 넣어줘.

수집 경로와 시점

• 시점: 2026-08-10 KST
• 확인 경로: 로컬 저장소 파일, git status --short --branch, git log --oneline -8
• 데이터 등급: 프로젝트 내부 원본 문서와 Git 상태. 외부 웹 데이터 없음.

가정

• 새 창 사용자는 같은 로컬 저장소와 같은 worktree 경로에 접근할 수 있다고 봤다.
• 런타임 데이터와 reports/ 산출물은 원칙적으로 재생성 가능하므로, 인계 요약에서는 커밋 후보와 분리해 표기한다.

처리 결과

• 새 창 인계용 요약 문서 docs/CONTEXT_HANDOFF.md를 추가했다.
• 프로젝트 내부 파일 설명 문서 docs/PROJECT_FILE_MAP.md를 추가했다.
• context 복사 명령 운영 기준 docs/guides/context-copy-command.md를 추가했다.
• Codex용 AGENTS.md와 Claude Code용 CLAUDE.md에 동일한 context 복사 명령 규약을 넣었다.

명령 원칙

사용자가 context 복사라고 말하면 구현 작업을 새로 진행하기보다 먼저 세션 인계 자료를 만든다.

반드시 현재 작업 폴더, 브랜치, 변경/미추적/생성물 구분, 최근 완료 작업, 남은 작업, 핵심 명령,

먼저 읽을 파일 목록을 포함한다. 중요한 구현이나 분석이 추가된 뒤라면 docs/CONTEXT_HANDOFF.md도

최신화한다.

한계

이 문서는 2026-08-10 현재 작업 트리를 기준으로 한다. 새 커밋, 새 분석, 새 런타임 데이터가 생기면

context 복사 응답 전에 Git 상태와 최신 문서를 다시 확인해야 한다.