docs-architect

リポジトリのドキュメント構成を診断し、プロジェクトの種別・段階に合った構成を処方・適用する。

設計原則 (全モード共通):

1. 責務分離 — 1 ファイル 1 責務。README に何でも書かない
2. 正本一元化 — 詳細の正本は 1 箇所、他は全部ポインタ。二重メンテを作らない
3. 読者軸 — user / contributor / maintainer / operator の誰向けかを常に明示する
4. 箱を先に作らない — 空の Diátaxis 4 分類や空ディレクトリの生成は禁止 (Diátaxis 公式の警告)
5. 持たないファイルも処方 — community files の機械的全部置きはアンチパターン。省略は理由付きで明示する

モード判定 (2 軸分離)

「ユーザー意図 → モード」と「repo 状態 → 診断結果」は別物。 repo 状態からモードを自動決定しない。状態は提案材料に留め、モードはユーザー指示を優先する。