docsweep — MCP 利用イメージ

AI コーディングエージェント × docsweep MCP（stdio）
ユーザー
AI（Claude Code 等）
MCP ツールコール
[計画]
[様子見]
[保留]
[完了]
要修正
1

セッション開始：「続きやって」だけで AI が残作業を把握する

triage

会話

You
ユーザー
続きやって。
AI
Claude Code
docsweep の triage を呼んで残作業を確認します。
AI
Claude Code
要判断が 3 件・保留が 2 件あります。一番古い
docs/local/plan_files-tree-search-child-filter.md（92 日経過・[様子見]）から進めますね。 検証が通っているので [完了] に昇格して archive に送りますか？

MCP ツールコール

▸triage()
// 戻り値（抜粋）
{
  "items": [
    {
      "rel": "docs/local/plan_files-tree-search-child-filter.md",
      "title": "files タブ検索で子要素が出ない",
      "state": "watching",   // [様子見]
      "type":  "plan",
      "age_days": 92,
      "actions": ["promote", "keep", "discard"]
    },
    {
      "rel": "docs/local/pending_winget-publish.md",
      "state": "pending",
      "age_days": 40,
      "actions": ["resume", "keep", "discard"]
    }
    // … 計 5 件
  ],
  "needs_fix": []
}
ファイル名を覚えていなくても 「次にやるべき作業」が先頭に出る。 AI は actions から実行可能な手だけ提案できる（不可な手は最初から選べない）。
2

ユーザーが OK → AI が 1 アクションで昇格＆archive

apply sweep

会話

You
ユーザー
うん、完了でいい。archive にも送って。
AI
Claude Code
promote で [様子見]→[完了] に書き換えて、sweep で archive へ送ります。
AI
Claude Code
完了しました。
plan_files-tree-search-child-filter.md を docs/local/archive/2026-06/ に移送しました（要判断 3→2、保留 2 のまま）。

MCP ツールコール

▸apply(path="…/plan_files-tree-search-child-filter.md", action="promote", to="done")
{
  "ok": true,
  "path": "docs/local/plan_files-tree-search-child-filter.md",
  "changed": {
    "state": ["watching", "done"],
    "label": ["[様子見]", "[完了]"]
  }
}
▸sweep(dry_run=false)
[
  {
    "from": "docs/local/plan_files-tree-search-child-filter.md",
    "to":   "docs/local/archive/2026-06/plan_files-tree-search-child-filter.md",
    "state": "done"
  }
]
apply は 1 ファイルに閉じた操作のみ受け付け、sweep は done/discarded のみ移送する（[様子見] や [保留] は触らない）。AI が暴走しても被害が出ない設計。
3

横断ビュー：別プロジェクトに飛ぶ前に全体の様子を圧縮 JSON で読む

summary

会話

You
ユーザー
他のリポジトリも含めて、今どこが詰まってる？
AI
Claude Code
summary で全プロジェクトの要点だけ取りますね。
AI
Claude Code
詰まり順は project-a（要判断 7・要修正 1） ＞ project-b（要判断 4） ＞ docsweep（要判断 2）。
まず project-a の壊れたラベル 1 件（bugfix_login-flow_2026-05-12.md）から直しましょうか？

MCP ツールコール

▸summary()
{
  "projects": [
    { "name": "project-a", "todo":7, "pending":3, "fix":1 },
    { "name": "project-b", "todo":4, "pending":1, "fix":0 },
    { "name": "docsweep",  "todo":2, "pending":2, "fix":0 }
  ],
  "oldest_todo": "project-a/docs/local/plan_login-flow-refactor.md (134d)",
  "needs_fix": [
    "project-a/docs/local/bugfix_login-flow_2026-05-12.md  (H1 ラベル欠落)"
  ]
}
summary は AI のコンテキスト圧迫を避ける用。フル INDEX が要るときは index を呼ぶ。

セットアップ（参考）

# 1. docsweep を MCP extra 付きで導入
pip install 'docsweep[mcp]'

# 2. Claude Code 側の MCP 設定（~/.claude/mcp.json など）
{
  "mcpServers": {
    "docsweep": {
      "command": "python",
      "args": ["-m", "docsweep", "mcp"]
    }
  }
}

# 3. グローバル導線を一発で（セッション開始時に triage を読ませる）
docsweep inject-global --agent claude