[docs-as-code
-
Docs-as-Code로 사이드 프로젝트 문서화하기 — 코드 위키 실전 적용기IT 2026. 4. 25. 21:00
사이드 프로젝트에 문서가 없으면 생기는 일사이드 프로젝트를 몇 달 방치하다 다시 열면, 내가 짠 코드인데도 "이게 뭐였지?" 하게 된다. README에 설치 방법 세 줄 적어둔 게 전부라, 어디서부터 손대야 할지 감이 안 온다. 함수 이름으로 역할을 유추하고, git log로 당시의 의도를 추적하는 고고학이 시작된다.이건 혼자 작업해도 마찬가지고, AI 코딩 에이전트를 쓸 때는 더 심각하다. Claude Code나 Cursor 같은 도구에 "이 프로젝트 구조 파악해줘"라고 하면, 코드를 전부 읽긴 하지만 왜 이런 설계를 했는지는 코드만으로 알 수 없다. 결국 매 세션마다 같은 설명을 반복하게 된다.이 문제의 해법이 바로 코드 위키(Code Wiki)다. 코드와 함께 버전 관리되는, 살아있는 문서 체계.코..