다음 세션의 나에게 — 데일리 노트와 인수인계 (4)

"분석함, 필터 추가함, 결과 개선됨." 한 달 뒤의 내가 이 세 줄로 이어서 일할 수 있을까요.

요약만 남은 기록은, 이어지지 않는다

앞의 세 편이 AI가 읽는 규칙과 메모리였다면, 이번 편은 다음 세션의 내가 읽는 기록입니다. 오늘 무엇을 왜 어떻게 했는지를 시간순으로 남기는 데일리 노트입니다.

문제는 대부분의 기록이 요약에서 멈춘다는 것입니다.

## 이상탐지 작업
- 오경보 분석함
- 필터 추가
- 결과 개선

한 달 뒤에 이 노트를 열면, 왜 필터였는지, 얼마나 개선됐는지, 무엇이 남았는지를 알 수 없습니다. 결과물은 무엇을 했는지는 보여 주지만, 왜 그렇게 했는지는 담지 못하기 때문입니다.

왜(Why)를 남기는 것은, 업계가 오래 다듬어 온 규율이다

"결과가 아니라 이유를 남긴다"는 새삼스러운 조언이 아닙니다. 소프트웨어 업계는 이걸 여러 형태로 제도화해 왔습니다.

• 아키텍처 결정 기록(ADR) — 2011년 마이클 나이가드가 제안한 형식으로, 결정마다 제목·상태·맥락(Context)·결정·결과를 한두 쪽으로 남깁니다. 핵심은 "맥락", 곧 그때 어떤 힘들이 작용했는지를 적는 것입니다. 이유를 남기지 않으면 새로 온 사람이 과거 결정을 맹목적으로 받아들이거나 뒤집는다는 문제의식에서 출발했습니다(원문, 2011). ThoughtWorks는 이 관행을 기술 레이더의 Adopt 링(2017)에 올렸습니다.
• 커밋 메시지 — 개발자들이 널리 따르는 커밋 메시지 작법의 일곱 번째 규칙은 "본문에는 무엇을, 왜를 설명하라(어떻게는 코드가 보여 준다)"입니다.

한국 기업의 현장도 같습니다. 우아한형제들은 신규 입사자 온보딩에서 "지나온 발자국을 남기듯 이슈 히스토리를 문서로 기록"한다고 밝혔고(우아한형제들 기술블로그), 결정된 내용을 ADR로 남겨 "새 팀원 합류나 과거 결정 배경 확인에 큰 도움"이 됐다고 적었습니다(우아한형제들 기술블로그).

이론의 뿌리도 있습니다. 노나카 이쿠지로의 지식창조 이론에서 표출화(externalization)는 머릿속의 암묵지를 글로 옮겨 형식지로 만드는 단계입니다. 국내 연구도 이 표출화 역량이 조직의 서비스 품질과 성과로 이어짐을 실증했습니다(서비스경영학회지, 2016). 기록은 잡무가 아니라, 머릿속 지식을 자산으로 바꾸는 과정입니다.

다시 이어갈 수 있는 노트의 모양

같은 작업이라도 이렇게 남기면 한 달 뒤에도 바로 이어집니다.

## 진동 이상탐지 — 오경보 원인 분석 (09:10~)
- 문제: 현장 오경보 7건(목표 주 1건 이하), 모두 22~24시
- 원인: 인접 공조기 기동 진동이 120Hz 대역에 섞임 (가동 로그와 7건 시각 일치)
- 처음엔 센서 불량 의심 → 다른 센서 2대에도 같은 성분 있어 기각
- 조치: 110~130Hz 노치 필터 추가 → 오경보 7건→1건
- 결정: 재학습(2일) 대신 필터(+0.4ms). 비용 대비 효과
- 보류: 다른 설비 영향 미확인 — 설비 목록 회신 대기
- 다음: 필터 적용본으로 현장 시험 재개

규칙은 몇 가지뿐입니다.

• 하루 한 파일, 일 하나 끝날 때마다 끝에 추가. 세션 끝에 몰아 쓰지 않습니다.
• 원인 → 조치 → 수치 → 결정 → 보류의 뼈대. "고쳤음"이 아니라 근거까지.
• 틀린 진단도 지우지 않습니다. "처음엔 X로 봤으나 Y로 기각"까지 남겨야 같은 오판을 반복하지 않습니다.
• 마지막 줄에 "다음". 이 한 줄이 다음 세션의 출발점입니다.

특히 마지막 줄이 중요합니다. 1편에서 "○○ 이어서 하자"로 세션을 시작한다고 했는데, 그 복원의 품질은 전날 남긴 "다음" 줄에서 갈립니다.

이어지는 이야기

여기까지가 개인의 기록이었습니다. 다음 편은 이 기록을 팀의 언어로 승격하는 이야기입니다 — 트래커·위키·Git. 실무자의 하루를 따라가며 비슷한 내용을 풀어낸 다른 연재도 참고하실 수 있습니다.

좋은 데일리 노트 양식과 예시가 필요하시다면, 문의하기로 연락 주세요.

---

「AI를 기억하는 동료로 쓰는 법」 시리즈

1. AI는 왜 어제를 잊는가 — 세션의 망각과 맥락 비용
2. 규칙은 한곳에 — AI 규칙 파일 쓰는 법
3. 하나의 파일에 하나의 사실 — AI 자동 메모리
4. 다음 세션의 나에게 — 데일리 노트와 인수인계 (현재 글)
5. 팀의 언어로 승격 — 트래커·위키·Git
6. 함정과 4주 도입 로드맵