작업 요약 저장
목표는 일주일 후에 사람(또는 새 세션의 당신)이 무슨 작업을 했는지, 왜 했는지, 무엇이 남았는지 1분 안에 이해할 수 있도록 하는 것입니다. 따라서 요약은 대화 전체를 재구성하는 것이 아니라 간결하고 핵심적이어야 합니다.
저장 위치
- 프로젝트 루트: git 저장소 루트 (
git rev-parse --show-toplevel)를 사용합니다. git 저장소가 아닌 경우 현재 작업 폴더를 사용합니다. - 루트에
summaries/폴더를 생성하고, 없으면 새로 만듭니다. - 파일명 형식:
YYYY-MM-DD-짧은-주제.md, 예:2026-10-16-kafka-outbox.md. 주제는 2–5개의 단어로, 라틴 문자, 소문자, 하이픈으로 연결합니다. 같은 파일이 이미 존재하면-2,-3을 추가하고, 기존 파일을 절대 덮어쓰지 않습니다. 기존 파일에는 기록이 담겨 있습니다.
작성 내용
대화에 사용된 언어로 작성합니다. 대화와 실제 결과(실행된 명령, 변경된 파일)에서만 사실을 가져옵니다. 신뢰할 수 없는 요약은 없는 것보다 나쁩니다. 따라서 꾸미거나 자신의 결론, 조언, '아마도 확인되지 않음' 같은 추측을 덧붙이지 마십시오. 대화에서 어떤 작업이 완료되지 않았거나 확인되지 않았다고 명시적으로 언급된 경우 '남은 과제' 섹션에 기록하고, 언급되지 않았다면 해당 항목을 생략합니다.
다음 구조를 사용하며, 빈 섹션은 생략합니다:
# <작업 주제>
**날짜:** YYYY-MM-DD
## 작업
한두 문장: 요청한 작업과 그 이유.
## 수행한 작업
- 주요 변경 사항이나 결론, 3–7개 항목.
## 변경된 파일
- `경로/파일명` — 변경 내용.
## 검증 방법
- 실행한 항목과 결과.
## 남은 과제
- 열린 질문, 다음 단계, 위험 요소.
요약은 약 15–40줄로 유지하십시오. 큰 코드 블록이나 로그를 삽입하지 말고, 대신 파일 경로와 한 문장 설명을 사용하십시오. 대화 중에 등장했더라도 비밀번호, 토큰, 키 또는 기타 비밀 정보를 절대 기록하지 마십시오.
저장 후
사용자에게 파일 경로를 간략히 알려주고, 응답에서 전체 요약을 다시 말하지 마십시오. 요약은 이미 파일에 저장되어 있습니다.