[Phase 1: スキャン] → Bash (モデル不要)
  ├─ .claude/skills/*/SKILL.md → スキル ID 抽出 (ディレクトリ名)
  ├─ .claude/agents/*.md → エージェント ID 抽出 (ファイル名)
  └─ docs/manuals/pipelines/*.md → パイプライン ID 抽出 (ファイル名)

[Phase 2: 表示]
  ├─ スキルリストテーブル (番号 + tool-id + 簡略説明)
  ├─ エージェントリストテーブル (番号 + tool-id + 簡略説明)
  ├─ パイプラインリストテーブル (番号 + pipeline-id + 簡略説明)
  └─ サブコマンド使用案内

[Phase 1: スキャン] → Haiku
  ├─ ツール種別判別 (スキル vs エージェント)
  ├─ SKILL.md / agent .md 読み取り
  ├─ MANIFEST.json 読み取り (あれば)
  ├─ 既存マニュアル読み取り (あれば、手動補強部分保存用)
  └─ 関連文書参照 (tool-usage-guide.md, CLAUDE.md)

[Phase 2: 抽出] → Haiku
  ├─ MANIFEST → tier, version, triggers, calls/called_by, outputs
  ├─ SKILL.md → description, workflow, examples, constraints
  └─ 既存マニュアル → 手動補強されたプレイブック/落とし穴保存

[Phase 3: 生成] → Sonnet
  ├─ 抽出データ + テンプレート → マニュアル生成
  ├─ 既存手動補強部分 → 統合 (上書き防止)
  └─ staleness_hash 計算 (SHA256 of ソースファイル群)

[Phase 4: 検証] → Haiku
  ├─ 必須セクション存在確認 (スキル: 7セクション、エージェント: 6セクション)
  ├─ 内部リンク有効性
  ├─ manifest.json 更新 (staleness_hash 含む)
  └─ CHANGELOG.md 項目追加

[Phase 0: インベントリ + Staleness 分類] → Haiku
  ├─ .claude/skills/*/SKILL.md → スキル ID リスト
  ├─ .claude/agents/*.md → エージェント ID リスト
  ├─ manifest.json 1回読み取り → 各ツールの staleness_hash 抽出
  ├─ 現在のソースファイルの SHA256 計算
  └─ 3-tier 分類:
       ├─ current: ソース未変更 (ハッシュ一致)
       ├─ stale:   ソース変更済み (ハッシュ不一致)
       └─ missing: マニュアル未存在または manifestに hash なし

[Phase 1: 分類結果表示]
  ├─ 3-tier 分類テーブル出力
  ├─ current: ✅ (スキップ予定)
  ├─ stale:   🔄 (更新予定)
  └─ missing: ➕ (新規生成予定)

[Phase 2: 更新実行] → Sonnet
  ├─ 基本モード: stale + missingのみ単件ワークフロー実行
  ├─ --force モード: current 含む全体再生成
  └─ 並列最大 2個ずつ処理 (コンテキスト圧縮防止)

[Phase 3: 仕上げ] → Haiku
  ├─ manifest.json 全体更新
  ├─ README.md 再生成
  ├─ CHANGELOG.md 一括項目追加
  └─ 最終結果要約: 更新 N個、新規 N個、スキップ N個

[Phase 1] → Haiku
  ├─ manifest.json 1回読み取り → 各ツールの staleness_hash 抽出
  ├─ 現在のソースファイルの SHA256 計算
  ├─ 比較 → current | stale | missing 分類
  └─ 結果テーブル出力 (変更なし)

[Phase 1: スキャン] → Haiku
  ├─ パイプライン参加ツール識別
  └─ 各ツールの SKILL.md/MANIFEST.json 読み取り

[Phase 2: 分析] → Opus
  ├─ Stage 順序決定
  ├─ Bridge Artifact 識別
  └─ 失敗シナリオ分析

[Phase 3: 生成] → Opus
  ├─ pipeline-manual.md テンプレートベースマニュアル生成
  └─ ダイアグラム生成 (テキストベース)

[Phase 4: 検証] → Haiku
  └─ manifest.json, CHANGELOG.md 更新

[Phase 1] → Haiku
  ├─ docs/manuals/ 配下の全マニュアルスキャン
  ├─ frontmatterからメタデータ抽出 (Read limit: 15)
  │   └─ staleness_hash, manual_version, target_version など
  ├─ manifest.json 再生成 (staleness_hash 含む)
  └─ README.md 再生成

manual_version: '1.2.0' # マニュアル自体の変更
target_version: '9.1.0' # 対象スキル/エージェントバージョン
last_verified: '2026-02-08' # 整合性最終確認日
staleness_hash: 'abc123...' # ソースファイル SHA256

// スキル: SKILL.md + MANIFEST.json 連結後 SHA256
const crypto = require('crypto');
const fs = require('fs');
let content = fs.readFileSync('.claude/skills/{id}/SKILL.md', 'utf-8');
try {
  content += fs.readFileSync('.claude/skills/{id}/MANIFEST.json', 'utf-8');
} catch (e) {}
const hash = crypto.createHash('sha256').update(content).digest('hex');

// エージェント: agent .md ファイル SHA256
const content = fs.readFileSync('.claude/agents/{id}.md', 'utf-8');
const hash = crypto.createHash('sha256').update(content).digest('hex');