정의
Implementation Notes as Shared Context Ledger는 구현 중 발생한 결정, 실패, 질문, 발견, follow-up을 별도 문서에 기록해 Claude와 사용자가 같은 작업 상태를 공유하게 만드는 방법이다. Chat history에만 의존하지 않고, 작업의 map을 파일로 유지한다.
왜 필요한가
Agentic coding에서는 구현 도중 unknown이 계속 발견된다. 이 정보를 prompt 안에만 두면 context window, 세션 전환, 기억 왜곡 때문에 쉽게 사라진다. Implementation notes는 발견된 unknown을 known으로 바꾸고, 다음 run이나 review에서 재사용 가능한 context로 만든다.
기록할 것
- 이번 작업의 목표와 비목표.
- 읽은 파일과 중요한 구조.
- 결정한 trade-off와 이유.
- 실패한 접근과 실패 이유.
- 아직 남은 질문.
- 검증 방법과 결과.
- 다음 agent나 reviewer에게 넘길 handoff.
좋은 점
Implementation notes는 agent가 더 오래 일하게 만드는 것이 아니라, 사람이 다시 설명해야 하는 비용을 줄인다. 또한 post-implementation explainer나 quiz의 기준 자료가 된다.
연결
- 20260710-unknowns-taxonomy-for-agentic-coding — unknown을 실행 중 context로 전환하는 방법.
- 20260706-state-memory-skills-agent-loop — state, memory, skill 중심 agent loop.
- 20260710-skills-are-agent-senses-not-just-prompts — 기록과 검증을 skill로 고정하는 방식.