> For the complete documentation index, see [llms.txt](https://docs.wantedly.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wantedly.dev/introduction/catching-up-on-in-house-knowledge.md).

# 効率的な社内知識の調べ方

ウォンテッドリーには大量の社内ドメイン知識が存在します。 それらは業務中頻繁に遭遇するため、はじめに効率の良いキャッチアップ手順を覚えておくとよいでしょう。

## 4 ステップで調べる

社内で何かを調べる際は以下の 4 ステップで調べましょう

1. [Handbook](https://docs.wantedly.dev/) で調べる
2. [Backstage](https://backstage.internal.wantedly.com) で調べる
3. AI に聞く
4. Slack で聞く・過去の GitHub Issue/PR で調べる

### 社内向け

現在 Handbook に対する社内フィードバックを積極的に集めています。「欲しい情報が見つからなかった」「知りたいことが知れて便利だった」などは是非[こちらの Discussion (internal) ](https://github.com/wantedly/dev/discussions/1923)にコメントしてください。

## 詳しく

### 重要なことは大体 Handbook に書いてある

Handbook は公開前提で書かれていたり、[元々オンボーディング資料として作られていた](https://docs.wantedly.dev/preface)こともあって社内で一番読みやすいドキュメンテーションになっています。 そのため、New Joiner のオンボーディングや専門外の領域について調べる際はまず初めに Handbook で調べると良いでしょう。 また、検索だけでなく目次をざっと眺めて「こういう概念あるんだ〜」のインデックスを頭に作っておくことも重要です。

![検索窓の場所の画像](/files/Y1jbeSfbgwP4UymaNvB7)

ただし特定のチームやマイクロサービスに紐づく詳細情報は Handbook ではなく、個々のリポジトリに記載する運用なので、それらは後述の Backstage を用いて検索してください。

### 詳細情報は BackStage で調べる

Backstage は複数の GitHub リポジトリに存在するマークダウンファイルを横断的に検索できるツールです。

![Backstage で検索したときの png](/files/G0FiQZNpwqQltXTlTJJA)

Backstage には大量のドキュメンテーションが保存されています。そのため、検索キーワードさえ知っていれば簡単に目当ての情報を得ることが可能です。

一方で、ページ数が多すぎるがゆえ明確な検索キーワードを持っていないと非常に扱いづらいです。 New Joiner や専門外の領域について調べる際は、まずは Handbook で全体像を掴んだ上で個別のトピックを Backstage で検索すると良いでしょう。

### 検索で見つからなければ AI に聞く

Handbook や Backstage の検索は、明確な検索キーワードを持っていないと目当ての情報にたどり着けないことがあります。 そんなときは AI に調べさせましょう。曖昧な聞き方でも、AI が関連するドキュメントやコードを探して回答してくれます。

調べる対象に応じてツールを使い分けると効率的です。

* 組織横断的に調べたい場合は Devin が向いています。複数のリポジトリやドキュメントを横断して調査できます
* 特定のリポジトリについて調べたい場合は Claude Code をはじめとする各種 AI エージェントツールが向いています。リポジトリのコードやドキュメントを直接読んで回答してくれます

ただし AI の回答は誤りを含むことがあります。重要な判断をする際は、回答内で参照されている Handbook・Backstage・コードなどの一次情報を確認しましょう。

### それでも分からなければ Slack で聞く、過去 Issue を調べる

Handbook・Backstage・AI を利用すればほとんどの調べ物は行えますが、時には目当ての情報にたどり着けないこともあります。 そんなときは Slack で質問をしたり、過去の Issue/PR を探すことで欲しい情報を探しましょう。

![Slack で検索したときの png](/files/H6kZtVrS5KgsN5dkqYuZ)

ただし、次回以降も違う人が Slack で質問したり、過去 Issue/PR を探したりするのは非効率です。 ドキュメンテーション化されていなくて困った情報は積極的に PR を作成しましょう。

#### 話を聞きに行きたい

* Slack: [#devops\_guild](https://wantedly.slack.com/archives/C04P8GL7ZPS)