코드에는 결정의 이유가 남지 않습니다. 왜 이 구조를 골랐는지, 어떤 순서로 손대야 하는지는 파일 어디에도 적히지 않습니다. 깨뜨리면 안 되는 불변 조건이 무엇이고 어디에 함정이 있는지도 대개 사람 머릿속에만 있습니다. CodeAlmanac은 개발자와 팀 리드가 그 층을 따로 적어 두는 코드베이스 위키입니다. 읽는 쪽에는 사람뿐 아니라 AI 코딩 에이전트도 들어갑니다. 기존 작업 흐름에 붙여 두고 화면에서 항목을 넣거나 꺼내는 구조라, 별도 문서 체계를 새로 세울 일은 없습니다.
