reusable-doc-structurelisted
Install: claude install-skill thinkyou0714/claude-lab-skills
## Purpose
「毎回ゼロから書く / 更新するたびに構造が崩れる」を防ぐ。
ドキュメントが変化に強く、別の文脈・読み手・AIセッションにも転用できる構造になっているかを評価・設計する。
## Use When
- 新規ドキュメントの構造を設計する場合
- 既存ドキュメントが肥大化・陳腐化してきた場合
- 複数のドキュメントで似た情報が重複している場合
- 別のAI・人間に引き継ぐためのドキュメントを整備する場合
## Inputs
以下を準備すること。不足している場合は推測せず、不足を明示する。
- **ドキュメント一覧または対象ドキュメント**: 評価・設計の対象
- **更新頻度**: 各ドキュメントがどの頻度で変わるか(日次 / 週次 / 変更時のみ / 固定)
- **読み手の種類**: 人間(エンジニア / 非エンジニア)/ AI(Claude / 他LLM)
- **再利用の目的**: 別プロジェクトへの転用 / テンプレート化 / 引き継ぎ / 自動化入力
## Output Contract
以下の順で出力すること。順序を変えない。
1. **論点**: このドキュメント構造の再利用性を左右する核心的な問題
2. **根拠**: その論点をそう判断した理由
3. **構造評価**: 評価項目ごとのチェック結果
4. **含意**: 構造の問題が引き起こす長期的なドキュメント負債リスク
5. **改善案**: 再利用性を高める最小限の構造変更案
6. **代替案**: 目的・更新頻度が異なる場合の別構造案
7. **判断材料**: 「現構造を維持 / 部分的に再設計 / 全体から再設計する」を選ぶための情報
### 構造評価 フォーマット
| チェック項目 | 状態 | 備考 |
|---|---|---|
| 変化する情報と固定情報が分離されている | OK / 注意 / NG | |
| セクションが独立して更新・参照できる | OK / 注意 / NG | |
| 他ドキュメントへの参照が相互依存になっていない | OK / 注意 / NG | |
| テンプレート化・変数化できる部分が特定されている | OK / 注意 / NG | |
| 情報の所在が一元化されている(重複がない) | OK / 注意 / NG | |
| 削除・統合・分割のコストが低い | OK / 注意 / NG | |
| 他LLMが構造を解析して正しく処理できる | OK / 注意 / NG | |
## Review Lens
- **目的妥当性**: 構造設計の評価基準がドキュメントの用途に対して適切か
- **範囲の過不足**: ドキュメントセット全体の構造が評価されているか
- **中長期リスク**: 半年後・1年後に構造が崩れるリスクはないか
- **LAB全体との整合性**: CLAUDE.md / CONTEXT.md / TASKS.md の構造設計原則と整合しているか
- **非エンジニア理解可能性**: 構造の設計意図を非技術者に説明できるか
- **他LLM移植耐性**: 構造が特定のAIの処理前提に依存していないか
## Instructions
1. ドキュメントを「変化する情報」と「固定情報」に分類する
2. 各セクションが独立して更新できるか(他セクションに依存していないか)を確認する
3. 複数ドキュメントに重複している情報を特定し、一元化の案を提示する
4. テンプレート化でき