AI That WritesとEngineering Docs From GitHubを整理

何が起きたか

# Notican：GitHubの変更を自動でNotionドキュメントに変換するAIツール

何が起きたか 開発者向けプラットフォームで、GitHubとNotionを連携させ、エンジニアリングドキュメントを自動生成するツール「Notican」が公開された。このツールはClaude AIを活用し、プルリクエスト（PR）やコミット、イシューの変更内容を解析して、Notion上にドキュメントを自動作成する。 具体的には、PRがマージされるとClaudeが差分を読み取り、チェンジログのエントリを自動生成する。変更がアーキテクチャに関わるものであれば、Architecture Decision Record（ADR、アーキテクチャ決定記録）を作成。APIファイルの変更があればAPIリファレンスを更新し、インフラの変更があればランブック（運用手順書）を生成する。GitHubのイシューはNotionのタスクに変換され、Notion側でタグ付けされたタスクはGitHubにイシューとして同期される。日本の開発チームにとっても、ドキュメント作成の工数削減につながるツールと言える。

背景 Noticanは、Notionが主催する「Notion MCP Challenge」への応募作品として開発された。MCP（Model Context Protocol）は、AIモデルが外部ツールやデータソースと連携するためのプロトコルで、Notion MCPはClaudeなどのAIがNotionのデータを読み書きするためのインターフェースを提供する。 ソフトウェア開発現場では、コードの変更に伴うドキュメント更新が長らく課題とされてきた。開発者は実装に集中したい一方で、チェンジログやAPI仕様書、運用手順書の更新も求められる。この作業は手動で行われることが多く、更新忘れや記述の不備が発生しやすい。Noticanは、この「ドキュメントの陳腐化」問題をAIで解決しようとする試みだ。

重要なポイント Noticanの技術的な特徴は、Notion MCPを「書き込み層」として活用している点にある。Claudeが生成したすべてのドキュメントは、MCPクライアントを通じてNotionに書き込まれる。書き込みは冪等性（べきとうせい）を備えており、GitHubの外部ID（PR番号、コミットSHA、イシュー番号）をキーとして各ページを管理する。そのため、同じイベントを再処理してもページが重複することなく、既存ページが更新される仕組みだ。 もう一つの重要な機能は双方向同期だ。Notionタスクウォッチャーが60秒ごとに「github_sync」タグの付いたタスクを検索し、GitHub APIを呼び出してイシューを作成する。これにより、Notionがエンジニアリングワークフロー全体の「信頼できる唯一の情報源」として機能する。ツールはオープンソースとして公開されており、ソースコードはGitHubで、デモサイトも公開されている。

今後の焦点 Noticanのようなツールの登場は、AIを活用したドキュメント自動化が実用段階に入りつつあることを示している。特にClaudeなどのLLM（大規模言語モデル）は、コードの差分を理解し、人間が読める形式で説明文を生成する能力が向上している。今後は、より複雑なプロジェクトでの精度検証や、複数のリポジトリをまたぐ変更への対応が課題となるだろう。 日本の開発現場では、ドキュメント作成を「後回しにしがちな作業」として捉える文化も一部に存在する。Noticanのようなツールが普及すれば、ドキュメントの品質向上と開発者の負担軽減が同時に実現される可能性がある。ただし、生成されたドキュメントの精度を人間が確認する工程は当面必要であり、AIと人間の協調ワークフローをどう設計するかが鍵になる。

導入を検討する企業や開発者は、精度だけでなく運用負荷と安全性の扱いも確認する必要がある。 公開時点では断片的な情報しか出ていないため、見えている事実と今後の追加説明を分けて読む必要がある。 単発の話題として受け取るより、どの層にどんな変化が出るのかを切り分けて見る方が実用的だ。

初報だけでは判断しにくい論点を切り分けておくことで、続報が出た際の評価精度を上げやすくなる。

モデル競争の文脈では、今回の動きが単なる機能追加なのか、現場のワークフローを変える実装なのかを見極めたい。 関連トレンドとしては Claude があり、周辺の発表や競合の動きと合わせて追う必要がある。 続報では、正式提供範囲、価格体系、既存ワークフローとの互換性まで確認したい。

背景

モデル競争の文脈では、今回の動きが単なる機能追加なのか、現場のワークフローを変える実装なのかを見極めたい。 関連トレンドとしては Claude があり、周辺の発表や競合の動きと合わせて追う必要がある。 続報では、正式提供範囲、価格体系、既存ワークフローとの互換性まで確認したい。

重要なポイント

読者にとっての論点は、機能の新しさよりも導入判断に値する差があるかどうかだ。企業や開発者にとっては、既存ツールとの競合や置き換え余地まで含めて見ていく必要がある。

今後の焦点

続報では、提供条件、料金体系、既存モデルとの差、実際の利用例がどこまで示されるかを確認したい。