Claude를 위한 두 번째 뇌 – MCP가 포함된 나의 Outline 위키

여러 프로젝트와 AI 비서로 작업하는 사람이라면 누구나 이 문제에 직면합니다. 모든 저장소(repo)에서 사물 명명 규칙, 레이어 아키텍처의 모습, 그리고 왜 특정 라이브러리를 의도적으로 사용하지 않는지 등을 매번 새로 설명해야 합니다. 이러한 결정들은 오래전에 내려진 것들입니다. 하지만 그것들은 머릿속에 존재하며, 여러 저장소에 흩어져 있고, 비서는 현재 보고 있는 조각(slice)만을 알 뿐입니다.

그래서 저는 이 지식을 저와 Claude가 모두 찾을 수 있는 한곳에 모으기 시작했습니다.

Outline을 선택한 이유 – 그리고 자체 호스팅의 이유

선택은 Outline으로, 별도의 서브도메인에 자체 호스팅(self-hosted)하기로 했습니다. 세 가지 이유가 결정적이었습니다.

첫째: 저는 제 데이터를 가지고 있고 특정 공급업체에 의존하고 싶지 않습니다. 수년 동안 제가 내린 모든 결정이 흘러들어갈 지식 저장소는 다른 사람의 손에 맡기고 싶지 않은 자산입니다.

둘째: 언제든지 전체 데이터 내보내기(full data export)가 가능합니다. 만약 제가 내일 다른 시스템으로 옮기고 싶다면, 모든 것을 가지고 갈 수 있습니다. 종속성(lock-in)이 없습니다.

셋째: 자체 호스팅은 나중에 더 나은 선택지를 열어줍니다. 예를 들어, 제 자신의 지식 기반 전체를 검색하는 저만의 RAG(Retrieval-Augmented Generation) 시스템을 원하게 될 수도 있습니다. 지금 당장은 필요하지 않습니다. 하지만 문이 열려 있다는 것 자체가 가치가 있습니다.

요리책 (The cookbook) – 핵심 부분

개별 프로젝트와는 별도로 '요리책'이라는 자체 컬렉션이 존재합니다. 이는 여러 프로젝트에 걸쳐 사용되며 일반적인 내용이라서 바로 그 점이 가치 있습니다. 이곳에는 제가 현재 어떤 제품을 사용하고 있든 상관없이, 어떻게 구축하는지에 대한 내용이 담겨 있습니다.

대략적으로는 몇 가지 영역으로 나뉩니다:

• 컨벤션 (Conventions) – 명명 규칙(naming), 코드 스타일, 문서 블록(docblocks), git 커밋, 마크다운, 패키지 관리자, 작성 스타일 등. 프로젝트마다 세 번씩 다시 논의하게 될 지루하지만 결정적인 사항들입니다.
• 백엔드 (Backend) – 계층형 아키텍처(layer architecture), 통일된 API 오류 형식, 테스트 전략, 마이그레이션 및 인덱스, i18n(국제화), 비동기 작업 및 Idempotency(멱등성).
• 프론트엔드/모바일 (Frontend / mobile) – 기능 중심 아키텍처(core/, shared/, features/), 디자인 시스템, 폼, 네트워킹, 상태(state), 라우팅, 저장소, 스타일링, 테스트.
• 배포 (Deployment) – Caddy를 에지(edge)로, Hetzner VPS를 사용하는 저의 표준 설정입니다.
• 템플릿 (Templates) – 프로젝트 시작점으로 사용되는 ADR 템플릿과 RULES.md가 있습니다.

제가 특히 마음에 드는 두 가지 항목이 있습니다. 하나는 대략

제가 특히 마음에 드는 두 가지 항목이 있습니다. 하나는 대략
"제품 소개(About the product)", 도메인 지식을 위한 "개념 및 기초(concepts & fundamentals)", 권한 부여, API 및 기술 스택을 위한 "아키텍처 및 기술(architecture & tech)", 프로젝트별 "규약(conventions)", 하위 도메인별로 정리된 "데이터 모델(data model)", "프로세스 및 워크플로우(processes & workflows)", 그리고 의도적인 아키텍처 선택에 대한 ADR을 포함하는 "로드맵 및 결정(roadmap & decisions)\

솔직히 처음 생각한 건 그냥: 마법적이었다.

그리고 이것이 전체 시스템의 핵심입니다. 단순히 어시스턴트가 내 메모를 받아 적는 것에 관한 것이 아닙니다. 내가 잊었거나 프롬프트에 포함하지 않은 지식을 가져오는 것에 관한 것입니다. 위키는 AI가 직접 접근하는 두 번째 기억 장치가 되며, 이는 주어진 순간 모든 것을 생각하지 못하는 인간의 약점을 정확히 보완해 줍니다.

이것은 완성된 시스템이 아니며, 모두에게 적합한 것도 아닙니다. 여러 프로젝트에 걸쳐 동일한 결정을 내리고 그것들을 반복해서 설명하는 것에 지치기 시작할 때 비로소 효과를 보기 시작합니다. 그 시점부터, 한 번 깔끔하게 작성한 모든 항목은 일관성, 속도, 그리고 AI가 현재 프롬프트에 담기지 않는 만큼 당신의 제품에 대해 더 많이 알고 있다는 이상하게 안심되는 확신으로 계속해서 보상해 줍니다.

나는 나 자신을 위한 요리책을 작성한다. 클로드가 그것을 읽어 내려가는 것이 실제 트릭이다.

_원래 grossbyte.io에 게시됨