AI 코딩 세션이 일회용이 되지 않게 만드는 실질적인 방법

AI 코딩 도구는 코드를 생성하는 것을 쉽게 만들어 주지만, 동시에 조용한 문서화 문제(documentation problem)를 야기합니다. 즉, 유용한 추론(reasoning) 과정이 나중에 찾기 어려운 세션(session) 안에 갇혀 버린다는 것입니다.

AI 세션에서 가장 유용한 부분은 종종 최종 패치(patch)가 아닙니다. 패치로 이어지게 만든 막다른 길, 가정(assumptions), 트레이드오프(trade-offs), 그리고 테스트 아이디어들입니다.

도움이 되는 몇 가지 관행은 다음과 같습니다:

1. 올바른 프로젝트 폴더에서 세션을 시작하세요.
2. 작업 이름을 모델이 아닌 작업 내용 중심으로 명명하세요: auth-timeout-fix, migration-plan, release-checklist 등.
3. 중요한 프롬프트(prompts)와 결정 사항들을 저장소(repo) 근처에 보관하세요.
4. 모델에게 유사한 버그를 다시 해결하라고 요청하기 전에 이전 세션들을 검토하세요.
5. 세션 복구(session recovery)를 에디터 탭을 복구하는 것처럼 개발 환경(dev environment)의 일부로 취급하세요.

저는 이러한 워크플로우를 Shelf라는 오픈 소스 데스크톱 앱으로 구축해 왔습니다.

Shelf는 또 다른 코딩 모델이 아닙니다. 여러 저장소(repos)에서 Claude Code와 Codex를 사용하는 사람들을 위한 작은 Tauri 데스크톱 워크스페이스 관리자(workspace manager)입니다.

현재 버전은 다음과 같은 기능을 제공합니다:

• 프로젝트별 세션 정리
• 이전 Claude Code 및 Codex 세션 재개
• 로컬 AI 대화 기록 스캔
• 재시작 후 워크스페이스 상태 복구
• 동일한 창 내에서 파일 트리(file tree) + 실제 PTY 터미널 유지

핵심 아이디어는 간단합니다: AI 코딩 기록은 일회용(disposable)이 아니라 탐색 가능(browsable)해야 합니다.

Repo: https://github.com/Harukaon/shelf