아프니까 개발자다 아프니까 개발자다

2024년 4월에 Cognition Labs(같은 회사의 AI 소프트웨어 엔지니어 Devin으로 유명한)가 deepwiki.com을 공개했다. GitHub repo URL 앞에 prefix만 붙이면 LLM이 자동 생성한 위키가 떠오르는 서비스이다. 곧 커뮤니티에서 deepwiki-open이 self-host 버전을 들고 등장했고, 2025년 11월에는 Google이 codewiki.google로 비슷한 영역에 들어왔다.세 도구는 첫인상이 거의 똑같다. "GitHub repo 던지면 LLM이 8섹션짜리 위키 만들어 줌"이라는 한 줄 컨셉. 그런데 막상 깊이 보면 누가 만들었고, 어디서 돌고, 어떤 LLM을 어떻게 쓰는지가 완전히 다르다. 이 글은 그 세 가지를 정직하게 비교하는 글이다 — 어느 게 "더 좋..

시리즈 맥락 복기앞서 #0에서는 프로세스 지도를, #1에서는 에이전트가 지켜야 할 규칙을 준비했습니다. 그런데 규칙만 있으면 AI는 "이 코드가 왜 이렇게 짜였는지"를 모릅니다. 코드를 읽으면 파악되는 것(함수 시그니처)과 코드에서 절대 읽히지 않는 것(순서 제약, 설계 의도)은 전혀 다르기 때문입니다.#0 업무 프로세스 매핑#1 프로젝트 규칙 설정#2 Code Wiki 작성 ← 이번 편#3 Skill 정의... (#8까지)이 단계의 의미 — 하네스에서 Code Wiki가 하는 일Step 2는 에이전트에게 "이 프로젝트의 지형도"를 건네주는 단계입니다. 말이 익숙하지 않은 길을 달릴 때 넘어지듯이, AI도 맥락이 없는 코드베이스에서는 엉뚱한 위치에 기능을 붙이거나, 이미 결정된 사항을 뒤집으려 합니다. ..