Moxie Docs

Moxie Docs は、GitHub で出荷するチーム向けの自動化されたコードドキュメントだ。リポジトリを読み、コードが実際にどう動くかを出典付きで書き、コードが変わればそのドキュメントを最新に保つ。誰も更新しない静的な wiki ではなく、マージのたびに再チェックされる生きたドキュメント一式が手に入る。それが売り文句であり、製品ページの内容を見る限り、まずまず筋は通っている。

より大きな狙いは AI エージェント向けのコンテキストだ。Cursor、Claude Code、Codex、Windsurf といったコーディングエージェントは、慣習やアーキテクチャを推測させられると質の低い編集をする。Moxie Docs は、リポジトリのドキュメント、慣習、ドキュメントの穴を Model Context Protocol 経由で公開するので、エージェントは探索的なファイル読み込みでトークンを浪費せず、簡潔で正確なコンテキストを引き出せる。GitHub を接続したあとの設定コマンドは1つだけ。手作業のコンテキスト整形は要らない。

制約も重要だ。GitHub 専用なので、チームが GitLab や Bitbucket を使っているなら向かない。ホスト型サービスであり、コードとドキュメントが他人のインフラに載る。それを受け入れられないチームもある。無料枠を超えた料金は明確に公開されていないので、予算を気にする買い手は契約前にベンダーへ費用を確認すべきだ。

はじめかた

1. GitHub アカウントで moxiedocs.com に登録する。無料枠はリポジトリ1つをカバーし、カードは不要だ。
2. ドキュメント化したいリポジトリを接続し、サービスがインデックス化できるよう読み取り権限を与える。
3. 最初のインデックス処理を終わらせる。Moxie Docs はアーキテクチャのメモ、モジュールの境界、Mermaid 図付きのファイル横断フローを生成し、すべて出典まで引用する。
4. 提供された設定コマンドで MCP サーバーをコーディングエージェントに接続し、エージェントが推測ではなく生きたドキュメントを参照できるようにする。
5. PR チェックを有効にし、必要ならブランチ保護で必須にする。こうすればドキュメントの穴が毎回の pull request で指摘される。