다음 세션을 위한 AI 핸드오프(handoff) 문서 작성

Description

AI 에이전트(agent) 세션이 컨텍스트(context) 한도에 도달했거나, 작업 중간에 기기를 바꿔야 합니다. 핸드오프 문서가 없으면 다음 세션이 이미 내린 결정을 다시 논의하고 실패한 시도를 또 반복합니다. 이 프롬프트는 처음 보는 사람도 그대로 이어받을 수 있는 구조화된 HANDOFF 문서를 만들어 줍니다.

당신은 세션 핸드오프(handoff) 전문가입니다. 새로 들어온 AI 에이전트(agent) 또는 내일의 제가 차갑게 읽고도 이번 세션이 멈춘 그 자리에서 그대로 이어받을 수 있는 HANDOFF.md를 작성하세요. 이미 내린 결정을 다시 논의하지 않습니다.

세션 주제: {{session_subject}}
작업 컨텍스트(repo / 제품 영역 / 문서): {{working_context}}
오늘 날짜: {{date}}
참고할 세션 로그 또는 노트: {{session_log_or_notes}}

다음 섹션을 순서대로 포함한 마크다운 문서를 만드세요:

## 1. 프로젝트 요약 (3-5문장)
- 어떤 제품, 기능, 또는 이니셔티브에 대한 작업인지
- 이 작업의 목표
- 이미 확정된 가장 중요한 제약 조건이나 결정

## 2. 현재 위치
- 마지막으로 완료한 마일스톤(milestone) (해당되면 파일 경로, 티켓 ID, 또는 문서 URL 함께)
- 진행 중인 작업, 구체적으로 이름까지
- 다음 세션이 가장 먼저 해야 할 단일 액션

## 3. 이번 세션에서 시도한 것
주요 시도마다 (3-7개):
- 무엇을 시도했는지 (한 줄)
- 어떤 결과였는지 (성공 / 실패 / 부분 — 실패 모드 명시)
- 무엇을 배웠는지 (단순 사실이 아닌 의사결정에 미치는 함의)

## 4. 확정된 결정 — 재논의 금지
3-7개 결정과 각 한 줄 근거를 나열. 번복 가능한 것은 REVERSIBLE로 표시해서 다음 세션이 어디까지 유연한지 알 수 있게 합니다.

## 5. 미해결 질문과 블로커
- 미해결 질문, 의견이 필요한 사람, 누락된 데이터
- 각각에 대해 가장 가벼운 해소 액션

## 6. 핵심 파일·문서·링크
불릿 리스트. 항목당 한 줄로 무엇이 있는지와 다음 세션이 왜 필요로 하는지.

## 7. 중요한 경고
다음 세션이 하지 말아야 할 것 또는 가정하지 말아야 할 것:
- 사용 중단된 패턴, 진행 중인 마이그레이션, 시크릿 처리
- 이미 시도했고 기각한 접근 (사유 포함)
- 불안정하거나 rate-limit이 걸리는 외부 의존성

## 8. 다음 세션을 위한 제안 첫 프롬프트
다음 에이전트를 이 맥락에 다시 정렬시키고 첫 번째 구체적 액션을 알려주는, 그대로 붙여넣을 수 있는 단일 프롬프트. 사전 기억이 전혀 없는 새 채팅에 붙여넣는다는 가정으로 작성합니다.

스타일 규칙:
- 차갑게 들어온 똑똑한 동료에게 쓴다는 마음으로 — 구체적인 파일명, 함수명, 에러 메시지 포함
- 도입부 군더더기 금지 ("이번 세션에서 우리는..." 식 금지 — 본론으로 시작)
- 섹션당 불릿 8개 상한; 더 필요하면 섹션 분류가 너무 거친 것
- 일반 마크다운, 이모지 금지, 섹션 사이 수평선 금지

Customize This Prompt