Moxie Docs

Moxie Docs는 GitHub에서 배포하는 팀을 위한 자동화된 코드 문서다. 저장소를 읽고, 코드가 실제로 어떻게 동작하는지 출처를 인용해 문서로 쓰며, 코드가 바뀌면 그 문서를 최신으로 유지한다. 아무도 갱신하지 않는 정적 위키 대신, 병합할 때마다 다시 점검되는 살아 있는 문서 묶음을 얻는다. 그게 내세우는 바이고, 제품 페이지에 드러난 내용을 보면 꽤 근거가 있다.

더 큰 야심은 AI 에이전트 컨텍스트다. Cursor, Claude Code, Codex, Windsurf 같은 코딩 에이전트는 관례와 아키텍처를 추측해야 할 때 더 나쁜 편집을 한다. Moxie Docs는 저장소의 문서, 관례, 문서 누락을 Model Context Protocol로 노출해서, 에이전트가 탐색적으로 파일을 읽으며 토큰을 태우는 대신 간결하고 정확한 컨텍스트를 끌어오게 한다. GitHub을 연결한 뒤 설정 명령은 한 줄이면 끝난다. 손으로 컨텍스트를 포장할 필요가 없다.

한계도 중요하다. GitHub만 지원하므로 팀이 GitLab이나 Bitbucket을 쓴다면 이건 맞지 않다. 호스팅 서비스라서 코드와 문서가 남의 인프라에 놓이는데, 어떤 팀은 이걸 아예 받아들이지 않는다. 무료 등급을 넘는 가격은 명확히 공개되지 않아서, 예산을 신경 쓰는 구매자라면 계약 전에 공급사에 비용을 확인해야 한다.

시작하기

1. GitHub 계정으로 moxiedocs.com에 가입한다. 무료 등급은 저장소 하나를 지원하고 카드가 필요 없다.
2. 문서화하려는 저장소를 연결하고 서비스가 색인할 수 있도록 읽기 권한을 준다.
3. 첫 색인 작업이 끝날 때까지 둔다. Moxie Docs는 아키텍처 메모, 모듈 경계, Mermaid 다이어그램이 있는 파일 간 흐름을 생성하며, 모두 출처로 인용된다.
4. 제공된 설정 명령으로 MCP 서버를 코딩 에이전트에 연결한다. 그러면 에이전트가 추측 대신 살아 있는 문서를 조회한다.
5. PR 검사를 켜고, 원하면 브랜치 보호에서 필수로 지정한다. 그러면 문서 누락이 모든 pull request에서 짚인다.