← ClaudeAtlas

docs-curatelisted

Curates the document set one item at a time: inspects, then merges duplicate facts / demotes one step / or deletes, always checking reverse references first (zero current dependents before any demotion), re-rendering the projections (Overview, ICD-index, Context Map) from the model afterward, and shrinking the always-injected set whenever it exceeds the injection cap by consolidating facts and clearing expired review_by items. Use this skill when the user wants to "clean up the docs", "curate", "remove orphans", "merge duplicate facts", "the context is too big / over the cap", "shrink the always-set", "deprecate this doc", "re-render the projections", or runs the periodic "docs cleanup / 定例整理".
Forest-Project-Lab/doctrine · ★ 2 · AI & Automation · score 66
Install: claude install-skill Forest-Project-Lab/doctrine
# docs-curate ## 役割 文書の集合を一片ずつ整える。点検し、重複する事実を統合する/一段だけ降格する/削除する。降格の前には必ず逆参照を確かめ(降格の前に現行の依存元がゼロ)、その後に投影(Overview・ICD 一覧・Context Map)をモデルから描き直し、常時注入する集合が上限を超えたときは、事実を一本化し期限切れの `review_by` 項目を片づけて縮める。主な要求は R8。 決定論の処理は `${CLAUDE_PLUGIN_ROOT}/scripts/` の `dep-graph.py`・`render-projection.py`・`term-extract.py` に委ねる。この技能は、何を残すかと、統合か降格か削除かの判断を���つ。 ## 何に頼るか - `${CLAUDE_PLUGIN_ROOT}/scripts/dep-graph.py`(逆方向)— 逆参照の確認。降格の前に現行の依存元がゼロかを見る。 - `${CLAUDE_PLUGIN_ROOT}/scripts/render-projection.py` — Overview・ICD 一覧をフロントマターから描き直す。 - `${CLAUDE_PLUGIN_ROOT}/scripts/term-extract.py` — 用語辞書の候補(c-TF-IDF)。候補だけを出し、採否は人間が決める。 - DECIDED・WATCH 正本 — 期限切れ・置換した事実を一本化するため。`inject-contract.py` の上限と対になる。 - `${CLAUDE_PLUGIN_ROOT}/scripts/docs-audit.py` の結果(孤児・逆孤児・`canonical_for` 衝突・語彙の酷似・投影ドリフト・`review_by` 超過・陳腐化の疑い・アーカイブ整合)を作業一覧として使う。取得は `docs-audit.py --root <統治木> --json`。 ## doctrine_docs/ の外の .md ファイル(手順の前に) 手順に入る前に、統治木の外の .md ファイルを一度だけ見る。まず統治木の名前を解決する(既定は `doctrine_docs/`。`_system/` を持つ `docs/` も後方互換で統治木。ADR-022)。次に `git ls-files '*.md' ':!:<統治木>/**'` で追跡下の .md を出す(git は .gitignore を尊ぶ。git が無い・使えない、または git 管理でないときは非 git の代替を使う)。各ファイルを投影・出所・ビュー・非文書に分け、出所は doc-author で取り込み、ビューには刻印(ADR-073)を打つ。doctrine_docs/ の外のファイルは自動で消さない。退避・取り込み・そのまま残すの三つだけを行う。要否は各ファイルごとに人間が判断する。詳細は `references/external-md-intake.md`。 ## 手順(一片ずつ) 1. 点検。監査の作業一覧(孤児・逆孤児・語彙の近い対・`canonical_for` 衝突・`review_by` 超過・投影ドリフト)を取る。一片ずつ進める。壊す変更をまとめて行わない。 2. 各候補について、統合(重複する事実を一つの正本へ一本化)/降格(§3.8 の階段を一段下げる)/削除(孤児かつ証跡なしかつ再現できる一時文書だけ。§3.8 の段)を決める。