# ListAppDocs

MAESTRO のプロジェクト内ドキュメントを **カテゴリ別に一覧**するメタツール（常時利用可能、引数なし）。質問に答える前に、関連 doc を探すために使う。各エントリの symbolic name は [ReadAppDoc](./readappdoc.md) にそのまま渡せる。

## 引数

なし。

## 出力（4 カテゴリの Markdown）

| セクション | 内容 | 読み込み形式 |
|-----------|------|------------|
| 利用者向けヘルプ | `ui/src/content/help/*.md` の frontmatter `title` | `help/<name>` |
| Piece 一覧 | `pieces/*.yaml` の名前＋ description 1 行 | `piece/<name>` |
| ドキュメント | `docs/` 配下の `.md`（後述の除外を除く） | `docs/<path>` |
| ツール参照 | `docs/tools/*.md` 全件 | `tool/<name>`（`ReadToolDoc` と同等） |

実際の出力から抜粋（各行は 1 件ずつ、見出しの直後に空行が入る）:

```
ListAppDocs()
→
# 利用者向けヘルプ (`help/<name>` で読み込み — アプリ内ヘルプと同じ内容)

- `help/06-schedules` — 自動実行を設定する
...
# Piece 一覧 (`piece/<name>` で読み込み)

- `piece/chat` — 汎用デフォルト piece。質問・調査・コード生成・文書作成・データ処理など、
...
# ドキュメント (`docs/<path>` で読み込み)

- `docs/mcp` — The orchestrator can call tools hosted on external **MCP servers** (OAuth-secured
...
# ツール参照 (`tool/<name>` で読み込み — ReadToolDoc と同等)

- `tool/browseweb` — ヘッドレスブラウザで Web ページを操作するツール。同一ジョブ内ではブラウザコンテキスト（Cookie・ログイン状態）が永続化される。
```

## 一覧から除外されるもの

内部向け・履歴的な doc はノイズになるため `docs/` セクションから除外される:

- `docs/design/`
- `docs/maintenance-checklist`

これらは `ReadAppDoc` でも基本的に読めない（block 対象）。

## 制約

- description は各ファイルの frontmatter を飛ばした最初の見出し/段落から最大 140 字を自動抽出。利用者向けヘルプだけは frontmatter の `title` を使う（無ければファイル名）。
- 合計エントリが 150 件を超えると、末尾に「個別取得を促す注記」が付く。

## 関連

個別の doc を読むには [ReadAppDoc](./readappdoc.md)。