세션 프로토콜: TODO.md로 AI 메모리 손실을 해결한 방법
Source: Dev.to
TL;DR: AI 코딩 어시스턴트가 당신이 작업 중인 내용을 계속 잊어버리나요? 이 TODO.md 구조가 해결합니다. 설정하는 데 몇 분이면 되고, 컨텍스트를 다시 설명하는 데 걸리는 시간을 몇 시간씩 절약합니다.
빠른 시작으로 이동하거나 아래 템플릿을 확인하세요.
문제: 그라운드호그 데이 개발
상상해 보세요. 게임을 만들거나, 앱을 기획하거나, AI 도움을 받아 멋진 무언가를 코딩하고 있습니다. 하루가 끝나고 생산적인 느낌으로 노트북을 닫습니다. 다음 날 아침, 다음 프롬프트를 입력했을 때 무서운 “대화 요약 중” 스피너가 나타나고 … 전날의 흐름이 사라집니다.
You open a new chat:
You: “프로젝트 파일을 읽고 우리가 멈춘 부분부터 계속해 주세요.”
AI: [당신의 50개 아이템 TODO 리스트를 스캔] “다이빙 시스템을 구축하고 있군요! 백로그에 ‘거대한 오징어 조우’가 있는 것도 보입니다. 현재 다이빙 코드를 작업 중이니, 나중에 지원할 수 있는 생물 공격 훅을 추가할 수도 있겠어요—”
You: “아니요. 다이빙 시스템만요.”
AI: “알겠습니다! ‘사운드 디자인’도 목록에 있네요. 플레이스홀더 오디오 트리거를 추가할까요—”
You: [내면의 비명]
모든 세션이 같은 루틴을 반복하며 소중한 시간을 낭비합니다:
- 우리가 만들고 있던 것을 다시 설명하기
- 백로그 항목에서 벗어나도록 리디렉션하기
- 범위를 다시 설정하기
- “그게 아니라, 이것!”이라고 단호히 말하기
AI가 고장 난 것이 아니라, 문서가 문제입니다.
가장 빠른 시도 방법
설명을 건너뛰고 바로 체험하고 싶나요?
-
리포지토리를 엽니다
-
AI 어시스턴트와 새로운 채팅을 시작합니다 (가능하면 “thinking” 모델을 사용하세요)
-
다음 프롬프트를 입력합니다:
read this article and design a TODO.md structure with supporting markdown documentation for my project that implements the Session Protocol
AI는 전체 글을 읽고 패턴을 이해한 뒤, 프로젝트에 맞는 맞춤형 TODO.md를 생성합니다. 그 후 반복해서 수정하세요.
(구현하기 전에 왜 이 방법이 작동하는지 이해하고 싶다면 계속 읽으세요.)
근본 원인: 인간을 위해 설계된 TODO 리스트
My original TODO.md looked like every other list:
# TODO
## Current Tasks
- [ ] Build diving system
- [ ] Add captain's log UI
- [ ] Implement oxygen consumption
## Future Ideas
- Multiple ocean depths
- Port trading mechanics
- Crew morale system
- Giant squid encounters
- Sound design
[...30+ more items]인간에게는 괜찮습니다—컨텍스트가 있고, 무엇을 작업 중인지 알고 있으며, 백로그는 아이디어를 위한 주차장일 뿐이죠.
하지만 AI 어시스턴트에게는 동등하게 유효한 옵션들의 뷔페와 같습니다. 모든 것이 실행을 기다리는 제안처럼 보이며, “여기에 집중하고 저것은 무시하라”는 신호가 없습니다. AI는 현재 작업 3개와 미래 아이디어 30개를 동등하게 취급해 지속적인 산만함과 반복적인 컨텍스트 복원을 초래합니다.
AI에게 구조화된 TODO를 제공하지 않으면, AI는 스스로 하나를 만들어 그것에 집착하며, 당신이 원하지 않았던 우선순위를 제시하게 됩니다.
세션 프로토콜은 기존에 없던 구조를 추가하는 것이 아니라, AI가 어차피 사용할 구조를 우리가 제어하는 것에 관한 것입니다.
해결책: 세션 프로토콜
세션 프로토콜은 AI 협업자의 주의를 유도하도록 특별히 재구성된 TODO.md입니다. 이 문서는 작업 추적을 위한 것이 아니라, AI의 집중을 프로그래밍하기 위한 것입니다.
1. 빠른 컨텍스트 (30초 부트스트랩)
## Quick Context (For New Chats)
**Read these docs to understand the project:**
- [DESIGN_PHILOSOPHY](./docs/DESIGN_PHILOSOPHY.md) — Core principles
- [AESTHETIC.md](./docs/AESTHETIC.md) — The vibe we're aiming for
**One‑line pitch:** "Command your own Nautilus" — a Victorian submarine simulation where you manage pressure, oxygen, and crew through uncharted depths.
**Tech:** Godot 4.x (GDScript). Prototype phase.왜 작동하나요: AI는 이를 가장 먼저 읽고 즉시 프로젝트 목적, 기술 스택, 현재 라이프사이클 단계를 파악합니다—왕복 설명이 필요 없습니다.
2. 완료 로그 (빵 부스러기)
## Completion Log
- **Nov 30** — First playable loop (navigation, save/load)
- **Dec 1** — Captain's Log UI (message list, pagination)
- **Dec 2** — Pressure system (physics, hull stress, depth gating)왜 작동하나요: 날짜는 시간적 컨텍스트를 제공해 AI가 이미 구축된 부분을 이해하고, 이미 완성