> For the complete documentation index, see [llms.txt](https://livlog-llc.gitbook.io/engineering-handbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://livlog-llc.gitbook.io/engineering-handbook/riburoguno/8-knowledge-search.md).

# 8. 知識の探し方

リブログでは、複数のプロダクト、データ、記事、API、GitHubリポジトリが存在します。

必要な情報を探せる状態にしておくことは、開発効率と保守性に直結します。

## 探す順番

情報を探すときは、次の順番を基本にします。

1. README
2. docsディレクトリ
3. Issue
4. コード
5. データファイル
6. 公開サイト
7. Handbook
8. 過去のAIプロンプト

## READMEで探すこと

READMEでは、プロジェクトの概要、実行方法、環境変数、デプロイ方法を確認します。

READMEに書かれていない詳細は、docsディレクトリを確認します。

## docsで探すこと

docsには、仕様、設計、運用手順、判断理由を残します。

特に、コードからは分かりにくい情報を優先して記載します。

* なぜその仕様にしたのか
* どのデータを使っているのか
* どのように加工しているのか
* どの外部APIに依存しているのか
* どの制約があるのか

## Issueで探すこと

Issueでは、過去の作業内容や判断経緯を確認します。

実装結果だけでなく、迷ったこと、保留したこと、次にやることも残しておくと、後から役に立ちます。

## AIに聞く前に確認すること

AIに質問する前に、次の情報を渡せる状態にします。

* 対象プロダクト
* 目的
* 関連ファイル
* 期待する動作
* 現在の問題
* 参考にすべき仕様

AIは文脈が不足すると推測で補いやすいため、必要な情報をできるだけ明示します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://livlog-llc.gitbook.io/engineering-handbook/riburoguno/8-knowledge-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.