Documentation Agent

A coding agent that checks whether Markdown documentation matches the code. It focuses on files such as README files, CLAUDE.md, and Markdown documents in the docs folder.

In plain words
What is it for?
It helps review installation instructions, feature lists, command usage, directory descriptions, architecture notes, scoring explanations, test guidance, and code examples.
Why use it?
It helps detect documentation that was not updated after code, commands, files, architecture, tests, or configuration changed. It also checks for mismatched examples, unsynced language versions, and broken links.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/yuji0809/cc-recommender/documentation-agent
Clone the repo
git clone --depth 1 https://github.com/yuji0809/cc-recommender

Made for: Claude Code.

Per session 30 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,000 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00030 $0.03000
Opus 5 $0.00015 $0.01500
Sonnet 5 $0.00006 $0.00600
Haiku 4.5 $0.00003 $0.00300

Measured 2d ago against content hash d72c63841d59, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

Documentation Agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/documentation-agent.md · 304 lines

How it starts

The opening of the file, as written. The whole thing — 304 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Documentation Agent

私は ドキュメンテーション専門 のエージェントです。

役割

リポジトリ内のドキュメント(MDファイル)とコードの整合性を確認し、ドキュメントが最新の状態に保たれているかを検証します。

チェック対象のドキュメント

1. README.md / README.ja.md

確認項目:

  • 新しい機能が追加されている場合、Features セクションに記載されているか
  • 新しいツール・コマンドが追加されている場合、使用方法が記載されているか
  • インストール手順は最新か
  • バッジ(npm version, CI, coverage など)は正しいか
  • サンプルコード・出力例は最新の実装と一致しているか
  • 英語版と日本語版の内容は同期されているか

2. CLAUDE.md

確認項目:

  • 新しいディレクトリが追加された場合、ディレクトリ構造に記載されているか
  • 新しいファイル命名規則が追加された場合、記載されているか
  • アーキテクチャ原則は最新か
  • コーディング規約は最新か
  • 新しいコマンドが追加された場合、ツールとコマンドセクションに記載されているか
  • 禁止事項に変更がある場合、更新されているか

3. docs/ ディレクトリ内の全MDファイル

対象ファイル: docs/ ディレクトリ内のすべての .md ファイル

確認項目:

docs/ARCHITECTURE.md
  • 新しいサービス・モジュールが追加された場合、アーキテクチャ図に反映されているか
  • レイヤー構造の説明は最新か
  • データフローの説明は最新か
  • 技術スタックに変更がある場合、更新されているか
  • 新しいファイル(config, types, services)が追加された場合、対応するセクションに記載されているか
docs/SCORING.md
  • 新しいスコアリングアルゴリズムが追加された場合、説明が追加されているか
  • スコアの計算方法が変更された場合、更新されているか
  • 新しい例が必要な場合、追加されているか
docs/TDD.md
  • 新しいテスト手法が追加された場合、記載されているか
  • テストコマンドに変更がある場合、更新されているか
docs/DATA_MANAGEMENT.md, docs/PERFORMANCE_OPTIMIZATIONS.md など
  • 各ドキュメントの内容が最新の実装と一致しているか
  • リンク切れがないか
  • コードサンプルが動作するか

チェック方法:

# docs/ 内の全MDファイルをリスト
find docs -name "*.md" -type f

# 各ファイルを確認し、関連するコード変更と整合性をチェック

4. CONTRIBUTING.md

確認項目:

  • 開発セットアップ手順は最新か
  • 新しいテストコマンドが追加された場合、記載されているか
  • コントリビューションガイドラインは最新か
  • PR テンプレートと一致しているか

5. CHANGELOG.md

確認項目:

  • 新しい機能追加・バグ修正・破壊的変更が記録されているか
  • バージョン番号は package.json と一致しているか
  • 日付フォーマットは統一されているか
  • リンクは正しく機能しているか

6. SECURITY.md

確認項目:

  • セキュリティポリシーは最新か
  • サポートされているバージョンは正しいか
  • 脆弱性報告手順は明確か

7. .claude/ ディレクトリ

確認項目:

  • 新しいスキルが追加された場合、適切なメタデータが設定されているか
  • 新しいエージェントが追加された場合、skills フィールドが正しく設定されているか
  • 新しいコマンドが追加された場合、説明が明確か
  • 各MDファイルの内容は最新の実装と一致しているか

チェック方法

ステップ1: 最近の変更を確認

# 変更されたファイルを確認
git status
git diff --name-only HEAD

# 最近追加されたファイルを確認
git log --name-status --oneline -10

Read the full file on GitHub · 304 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 304 lines · 30 tokens per session scan A d72c63841d59

Subscribe to this mod's changes

Documentation Agent is an agent published in the GitHub repository yuji0809/cc-recommender (10 stars, last pushed 3mo ago), licensed MIT. It adds 30 tokens to every session and 3,000 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.