Overview
Devin はリポジトリを自動的にインデックス化し、アーキテクチャ図、情報源へのリンク、コードベースの要約を含む Wiki を生成するようになりました。 コードベースの不慣れな部分をすばやく把握するのに活用できます。サイドバーから確認してください。 Ask Devin は Wiki の情報を利用して、コードベース内の関連するコンテキストをより適切に理解し、見つけられるようになります。Ask Devin の高度なコード検索機能と DeepWiki を組み合わせることで、コードに基づいた詳細かつ正確な回答を生成できます。短い紹介動画については、DeepWiki チュートリアルをご覧ください。DeepWiki の動作例
公開リポジトリ向け
公開 GitHub リポジトリに対応した無料版の DeepWiki と Ask Devin が利用可能になりました。見慣れないコードベースをすばやく理解できるように、アーキテクチャ図、ドキュメント、ソースコードへのリンクを自動生成します。コードベースについて複雑な質問を投げかけて、コンテキストに根ざした具体的な回答を得ることもできます。高度なコード検索、プランニング、セッション作成を含む Ask Devin のすべての機能は、Devin アプリ で利用できます。Public DeepWiki と DeepWiki MCP では、基本的なドキュメントおよび Q&A 機能を提供します。
エフォートレベルとコスト
Wiki生成は、wikiページからorgごとに設定できる3つのエフォートレベルのいずれかで実行されます。設定はrepoごとに上書きできます。
Enterprise orgは常に低エフォートで実行され、この設定は変更できません。
DeepWiki の制御

.devin/wiki.json ファイルを使うと、Devin のデフォルトの wiki 生成動作を制御できます。これは、組み込みの制限に達する可能性がある大規模リポジトリでは特に重要です。
wiki 生成中にリポジトリのルートディレクトリで .devin/wiki.json ファイルが見つかった場合、指定された repo_notes と pages を使用して wiki 生成を制御します。どちらのフィールドも必須で、pages には少なくとも 1 ページを列挙する必要があります。設定ファイルが存在する場合、デフォルトのクラスターベースのプランニングをスキップし、指定したページだけを正確に作成します。そのため、必要なページはすべて列挙してください。これにより、自動生成システムではスキップされてしまう場合でも、コードベースの重要な部分が確実にドキュメント化されるようになります。
設定形式
.devin/wiki.json ファイルを作成します。
設定項目
repo_notes (Array, required)
ドキュメンテーションシステムがリポジトリをより正確に理解できるようにするためのコンテキストやガイダンスを提供します。追加するノートがない場合でもrepo_notes キーは含めてください。その場合は空の配列 ([]) を使用します。
- content (string, required): ノートの内容 (最大 10,000 文字)
- author (string, optional): ノートの作成者
pages (Array, required)
wiki に作成するページを厳密に指定します。 このフィールドは必須で、少なくとも 1 ページを含める必要があります。ページは明示的な指示として扱われ、JSON で定義したページのみが生成され、それ以上でもそれ以下でもありません。pages を省略した (または空にした) .devin/wiki.json は拒否されるため、作成したいページをすべて列挙してください。
- title (string, required): ページタイトル (一意かつ空でない必要があります)
- purpose (string, required): このページで何を文書化するか
- parent (string, optional): 階層構造のための親ページのタイトル
- page_notes (array, optional): このページに固有の追加ノート
検証の制限
- 最大 30 ページ (エンタープライズでは 80 ページ)
- ノート数は合計で最大 100 個 (
repo_notesとすべてのpage_notesの合計) - ノート 1 件あたり最大 10,000 文字
- ページタイトルは一意で、かつ空であってはなりません
実用例
例 1: Repo Notes を利用して優先事項を強調する
repo_notes を利用して Devin に重視してほしい点を伝え、あわせて必要な pages を列挙します。Notes は各ページをどのように書くかをガイドし、pages はどのページを作成するかを決定します。
例 2: 特定のフォルダがドキュメントに含まれるようにする
repo_notes を利用してなぜ重要なのかを説明してください。
例 3: ドキュメント化されていないコンポーネントへの対処
repo_notes で強調してください:
例 4: 階層的なドキュメント構造
ベストプラクティス
- Repo Notes を戦略的に活用する
- コードベースのうち、どの部分が特に重要かについてのコンテキストを提供する
- 優先すべき特定のフォルダやコンポーネントに言及する
- システム内の各部分同士の関係を説明する
- ページを論理的に整理する
- まずは高レベルな概要ページから始める
- 親子関係を設定して明確な階層構造を作る
- 関連する機能をまとめて整理する
- ページの目的を具体的にする
- 各ページで何を文書化すべきかを明確に記載する
- 注力したい特定のディレクトリ、ファイル、または概念を明示する
- システムが意図を理解できるだけの十分な詳細を提供する
- 既知の抜け漏れに対処する
- コードベース内で特定の部分が見落とされているとわかっている場合は、それらを明示的に含めるようにする
- 何を対象としているかが一目でわかる、説明的なタイトルを付ける
一般的な問題のトラブルシューティング
「一部のフォルダしかドキュメント化されない」
.devin/wiki.json を使って、コードベースのどの部分をドキュメント化するかを明示的に指定してください。
「重要なコンポーネントが wiki から抜けている」
はじめに
- リポジトリのルートに
.devin/wiki.jsonを作成します - コードベースの構造や優先度を説明する
repo_notesを追加します - 作成したいすべてのページを漏れなく指定し、それぞれに明確なタイトルと目的を設定します (少なくとも 1 ページが必要です)
- ファイルをコミットし、wiki を再生成します

