☰ 분류

분류

새 대화에서 이어갈 인계문 쓰는 프롬프트

결정보다 결정한 이유를 적습니다. 안 통한 것도 이유와 함께 남깁니다.

분류AI 사용법 › 대화 관리
태그요약초안작성템플릿
프롬프트 (영어 본문 · 답은 한국어로 옵니다)
Write a handoff so this work can continue in a fresh conversation.

**The reader knows nothing. Assume no shared history.**

**Include:**
1. **The goal** — one sentence. What "done" means
2. **Decisions already made, and why.** ***The reason matters more than the decision*** — **without it the next session re-opens settled questions**
3. **What was tried and did not work**, with the reason. *Otherwise it gets tried again*
4. **Current state** — what exists now, where it is
5. **The immediate next step**, concretely
6. **Constraints that still apply** — and ***which ones are decisions versus which are hard limits***
7. **What is still open**, and who decides it

**Rules:**
- ***Do not include the history of how we got here.*** **Only what changes what happens next**
- **Write terms so they cannot be misread.** A name only meaningful in the old conversation gets defined
- ***Mark anything uncertain as uncertain.*** **A handoff that states a guess as a decision is worse than one that leaves a blank**
- Keep it to one screen. **If it will not fit, that is a sign the work needs splitting**
붙여 넣으면 맨 아래에 채울 칸(지금까지의 작업 · 다음에 할 일)이 나옵니다

어떤 프롬프트인가

인계문에서 가장 자주 빠지는 게 "왜 그렇게 정했는지"다. 이유가 없으면 다음 세션이 이미 끝난 논의를 다시 연다. 실패한 시도도 이유가 없으면 다시 시도된다. 이 프롬프트는 과정이 아니라 다음 행동을 바꾸는 것만 담고, 한 화면을 넘으면 작업을 쪼개라는 신호로 읽는다.

모델 비교

ChatGPT가 불확실성과 하드 제한을 가장 충실히 처리했다. Gemini는 구조는 좋지만 추정 내용을 사실처럼 추가했고, [C]는 제출되지 않았다.

ChatGPT종합 1위
45/ 50

＋ 불확실성을 표시하고 실제 제약까지 빠짐없이 담았다.

－ 일부 결정권자를 임의 지정했고 성공 기준은 더 구체화해야 한다.

Gemini
37/ 50

＋ 결정과 이유, 다음 실행 단계를 선명하게 구분했다.

－ 무중단·TTL·결정권자 등 입력에 없는 내용을 단정했다.

기준ChatGPTGemini앞선 모델
지시 준수97ChatGPT +29%
정확성95ChatGPT +80%
구체성98ChatGPT +13%
구성·가독성99동점
분량 적정성98ChatGPT +13%

gpt-5.6-sol가 모델 이름을 가린 채 1~10점으로 채점했습니다 (2026-09-25). 측정값이 아니라 AI 심사 결과입니다.

답 전문 보기

같은 입력을 세 모델에 넣어 받은 답을 그대로 옮겼습니다. 각 CLI(에이전트 하네스)에서 실행했습니다. ChatGPT·Claude 앱이나 웹에서는 답이 다를 수 있습니다.

넣은 입력
지금까지의 작업: 쇼핑몰 '오늘장터'의 장바구니 API 리팩터링 작업. 기존엔 세션 기반 장바구니였는데 비회원 장바구니가 유지되지 않아 DB 기반으로 전환하기로 결정(비회원 이탈률 18% 감소가 목표). cart_items 테이블을 새로 설계해 마이그레이션 스크립트까지 작성 완료. 기존 세션 기반 로직은 삭제하지 않고 feature flag로 병행 운영 중(안전한 롤백을 위해). Redis 캐싱을 붙이려다 캐시 무효화 로직이 복잡해져서 보류함.

다음에 할 일: cart_items 마이그레이션을 스테이징 환경에 적용하고, feature flag를 5% 트래픽에 먼저 켜서 에러율을 모니터링하기.
gpt-5.6-luna (codex CLI · 에이전트 하네스) · 실행일 2026-09-24

오늘장터 장바구니 API 리팩터링 핸드오프

  1. 목표
    비회원 장바구니가 유지되도록 DB 기반 API로 전환하고, 비회원 이탈률을 18% 낮추는 것을 목표로 한다.

  2. 확정된 결정과 이유

  • cart_items 테이블을 도입한다. 세션 기반 장바구니는 비회원 상태에서 유지되지 않기 때문이다.
  • 기존 세션 로직은 삭제하지 않고 feature flag로 병행 운영한다. 문제 발생 시 즉시 롤백할 수 있어야 하기 때문이다.
  • Redis 캐싱은 보류한다. 캐시 무효화 로직이 복잡해져 안정적인 1차 전환 범위를 벗어나기 때문이다.
  1. 시도했으나 진행하지 않은 것
  • Redis 캐싱 도입: 캐시 무효화 복잡성 때문에 보류했다. 다음 세션에서 우선 재시도하지 않는다.
  1. 현재 상태
  • cart_items 테이블 설계 완료.
  • 마이그레이션 스크립트 작성 완료.
  • 기존 세션 기반 로직은 남아 있으며 feature flag로 병행 운영 중.
  • 작업 파일의 정확한 경로와 현재 flag 설정값은 확인되지 않음.
  1. 즉시 다음 단계

스테이징 환경에 cart_items 마이그레이션을 적용한 뒤, DB 기반 로직 feature flag를 전체 트래픽의 5%에 활성화하고 에러율을 모니터링한다. 이상이 있으면 세션 기반 로직으로 롤백한다.

  1. 계속 적용되는 제약
  • 결정: 기존 세션 로직은 검증이 끝날 때까지 삭제하지 않는다.
  • 결정: Redis 캐싱은 이번 단계 범위에 포함하지 않는다.
  • 결정: 처음에는 5% 트래픽만 전환한다.
  • 하드 제한: Gotcha 테스트 하네스/스킬은 사용하지 않는다. 프로젝트의 기본 테스트와 직접 코드 검사를 사용한다.
  1. 아직 열린 사항과 결정권자
  • 스테이징 마이그레이션 실행 시점과 담당자: 미정 — 프로젝트 담당자가 결정.
  • 5% 전환 후 성공 기준(허용 에러율, 관찰 기간): 미정 — 프로젝트 담당자와 운영 담당자가 결정.
  • 전체 트래픽 확대 및 세션 로직 삭제 시점: 5% 모니터링 결과 확인 후 결정.

같은 분류의 프롬프트

채팅 내역 내보내기 프롬프트
컨텍스트 이전 문서 프롬프트
작업 이어가기 요약 프롬프트
긴 자료를 나눠 넣는 순서 짜는 프롬프트
서로 충돌하는 내 지시를 찾아내는 프롬프트