ShipDocsプライベートリポジトリを2分で生きたドキュメントに

コードが増えるほど、ドキュメントは腐っていく。READMEは更新されず、Wikiは前回の組織再編のまま。新しいメンバーはコードを読み解くしかない。ShipDocsは、そんな「誰もメンテしないドキュメント」をAIでよみがえらせようというツールだ。

公式サイトの売り文句を見ると、プライベートリポジトリを取り込んで2分で“生きたドキュメント”に仕立ててくれるらしい。そして、単なる文章の要約ではなく、回答が必ず実ファイルのパスと行番号を指し示してくれる。

解決したいのは「ドキュメントの腐敗」

ある程度の規模のチームなら、誰でも思い当たる光景がある。新人はコードを読むしかなく、ベテランの開発者は毎週何時間も「このエンドポイントはどこ？」「このフックの仕様教えて」と質問攻めにされる。GitHubのREADMEは数年前のまま、Slackの過去ログには答えがあるのに検索にヒットしない。ShipDocsは、その“ドキュメントの管理人”をAIに置き換える。

例えば「webhookの署名はどこで検証している？」と質問すると、曖昧な説明ではなくsrc/routes/billing.tsという実ファイルのパスと、該当行を表示してくれる。これは新人の導線としても、リファクタリング時の調査としてもかなり実用的だ。

実際に何ができるのか

機能を箇条書きにすると、ざっとこんな構成だ。

• 引用式のAIチャット：回答が実ファイルパスに紐づくので、幻のAPIや存在しない関数を答案にしない。
• 9種類のドキュメントモジュール：バックエンド、フロントエンド、workers、CLIなど、リポジトリ構造に合わせて自動生成してくれる。
• インポートと自動同期：GitHub、GitLab、Bitbucket、ZIPアップロード、CLIに対応。コードをpushすればドキュメントも追従する。
• MCP統合：CursorやClaudeに構造化された文脈を渡せる。

公式サイトに載っているユーザー証言によると、フィンテック系のエンジニアは「以前は毎スプリント4時間をWikiの更新に費やしていたが、ShipDocsでmonorepoを索引するのに3分もかからなかった」と話す。また、「前のAIツールは存在しないAPIを平気で生成したのに、ShipDocsは初回の回答でいきなり正しいファイルを指してきた」という声もある。ただしこれらはあくまで公式のプロモーション枠なので、数値は参考程度に見ておきたい。

さらに、同社は640以上のエンジニアチームが利用し、平均でスプリントあたり6時間以上を節約できたと主張している。この数字は聞き流すのが無難だが、導入のしやすさ自体は想像できる。

セキュリティとプライバシーは「公式の言葉」だけに留まる

プライベートコードベースを扱う以上、一番気になるのはデータ漏れ。ShipDocsは一貫してAES-256-GCMによる暗号化を謳い、プロジェクトごとに独立した鍵を使うという。さらに「コードを学習に使用しない」「データはいつでも削除可能」「90日後にハード削除」といったポリシーも明記している。これらを読む限り、設計思想は誠実だ。

だが、鍵の管理方式や監査プロセスといった実装の細部は公開されていない。企業内で採用するなら、そのあたりの説明をあらかじめ取り寄せておいたほうが安心だろう。

どういうチームに刺さるか

導入ハードルは低い。3日間の無料トライアルはクレジットカード不要で、手元のリポジトリを一つ入れて試せる。これだけでも「ドキュメント化」の光景がイメージできるはずだ。

ただし、正式な料金プランは公開されていない。“Advanced”というプラン名だけがサイトに記載されている。長期契約を検討するなら、まずは少人数のチームで回答精度を試して、特に大規模なmonorepoでの索引品質を自分の目で確認したい。

ドキュメントは、本来なら「知識を流れ続けさせる」ためのもの。ShipDocsがやろうとしているのは、AIで文章を量産することではなく、コードの在りかを引用付きで示すことだ。流行りの生成要約より、ずっと実務に近い選択に思える。