phasegate 0.122.0 → 0.124.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.124.0] - 2026-05-08
+
+### Added
+
+- **WI-088 Phase B — bundled guidance skill `phasegate-config-doctor`** — `phasegate.config.json` の現状を schema + プロジェクト検出結果と突き合わせて改善案を **diff 形式で提案する診断スキル** を追加。Phase A の `phasegate-toolkit-guide` (read-only Q&A) と対をなす設定変更系 skill。AI による silent な書き換えを禁止し、必ずユーザー承認 → Edit → `phasegate validate --layer L2` 検証の手順を踏む。
+  - **新規ファイル**: `skills/phasegate-config-doctor/SKILL.md` を `skill-creator` skill (`init_skill.py`) 経由で作成 (validation pass)。9 診断観点 (schema バージョン / project.preset / architecture.preset / paths / quickMode / harnesses / baseline / agentIntegration.stopHook.enforce / hook-config.json) ごとに OK / WARN / SUGGEST 判定の基準と提案 diff フォーマットを定義。
+  - **設計原則**: silent 書き換え禁止 / schema を読んでから提案 / 機械検出を優先 / AI 推論は判断要素のみ・根拠提示必須 / read-only Q&A は phasegate-toolkit-guide に委譲。
+  - **skill-deployer 拡張**: `SKILL_CATEGORIES.guidance` に `phasegate-config-doctor` を追加。`getSkillsForSet("all")` に含まれるが `getSkillsForSet("core")` には含まれない (Phase A と同じ責務分離)。
+  - **テスト追加**: 4 ケース (guidance カテゴリ登録 / `getCategoryForSkill('phasegate-config-doctor') === 'guidance'` / `getSkillsForSet('all')` に含まれる / `getSkillsForSet('core')` に含まれない)。全 3499 テスト (前回 3495 + 新規 4) グリーン。
+  - **互換性**: 既存 deploy ロジックに変更なし。consumer プロジェクトで `phasegate init` 実行時、`.claude/skills/` 配下に `phasegate-toolkit-guide` (Phase A) と `phasegate-config-doctor` (Phase B) の 2 つが追加 deploy される。
+
+## [0.123.0] - 2026-05-08
+
+### Added
+
+- **WI-088 Phase A — bundled guidance skill `phasegate-toolkit-guide`** — phasegate を導入したプロジェクトで AI エージェントが phasegate ツールキット自体の概念 (L0-L4 / 防御プリセット / アーキプリセット / Quick Mode / Hook 仕様 / config 全般) について質問されたとき、`node_modules/phasegate/docs/guide/` 配下の canonical doc を読み込んで正確に回答するための skill を追加。
+  - **設計原則 (stale 回避)**: SKILL 本体に概念知識を固定せず、概念カテゴリごとに canonical doc へのポインタのみを記述。`npm update phasegate` で knowledge が自動追従する構造。
+  - **新規ファイル**: `skills/phasegate-toolkit-guide/SKILL.md` を `skill-creator` スキル (`init_skill.py`) 経由で作成 (validation pass)。9 概念カテゴリ (L0-L4 layer model / preset 2 系統 / Quick vs Full Mode / hook 仕様 / config 全般 / CLI / installation / skills overview / codex integration) ごとに `docs/guide/*.md` への参照を整理。
+  - **skill-deployer 拡張**: `scripts/harness/setup/skill-deployer.ts` の `SkillCategory` type union に `"guidance"` を追加、`SKILL_CATEGORIES.guidance = ["phasegate-toolkit-guide"]` を登録、`getSkillsForSet("all")` の返り値に guidance カテゴリを含めた。`getSkillsForSet("core")` には含めない (core は continuous governance 用、guidance は ad-hoc Q&A 用なので責務分離)。
+  - **テスト追加**: 4 ケース (`scripts/harness/__tests__/unit/setup/skill-deployer.test.ts` に `SKILL_CATEGORIES.guidance` 登録 / `getCategoryForSkill('phasegate-toolkit-guide') === 'guidance'` / `getSkillsForSet('all')` に含まれる / `getSkillsForSet('core')` に含まれない)。全 3495 テスト (前回 3491 + 新規 4) グリーン。
+  - **互換性**: 既存 deploy ロジックに変更なし、`getSkillsForSet("core")` の返り値も変更なし。consumer プロジェクトで `phasegate init` 実行時、`.claude/skills/` 配下に `phasegate-toolkit-guide` が追加 deploy されるのみ。
+
 ## [0.122.0] - 2026-05-08
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.122.0",
+  "version": "0.124.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/scripts/harness/setup/skill-deployer.ts

@@ -17,7 +17,7 @@ const HOOKS_TARGET_DIR = ".claude";
 
 // ── Skill Category Map ──
 
-export type SkillCategory = "core" | "aidlc" | "utility";
+export type SkillCategory = "core" | "aidlc" | "utility" | "guidance";
 export type SkillSet = "core" | "all";
 
 export const SKILL_CATEGORIES: Record<SkillCategory, readonly string[]> = {
@@ -52,13 +52,19 @@ export const SKILL_CATEGORIES: Record<SkillCategory, readonly string[]> = {
     "unit-test-logic-designer",
   ],
   utility: ["codex-delegator", "skill-creator"],
+  guidance: ["phasegate-toolkit-guide", "phasegate-config-doctor"],
 } as const;
 
 export function getSkillsForSet(skillSet: SkillSet): string[] {
   if (skillSet === "core") {
     return [...SKILL_CATEGORIES.core];
   }
-  return [...SKILL_CATEGORIES.core, ...SKILL_CATEGORIES.aidlc, ...SKILL_CATEGORIES.utility];
+  return [
+    ...SKILL_CATEGORIES.core,
+    ...SKILL_CATEGORIES.aidlc,
+    ...SKILL_CATEGORIES.utility,
+    ...SKILL_CATEGORIES.guidance,
+  ];
 }
 
 export function getCategoryForSkill(skillName: string): SkillCategory | null {

package/skills/phasegate-config-doctor/SKILL.md

@@ -0,0 +1,199 @@
+---
+name: phasegate-config-doctor
+description: 現在の phasegate.config.json を schema + プロジェクト検出結果と突き合わせて改善提案する診断スキル。read-only Q&A の phasegate-toolkit-guide とは異なり、設定変更を伴う相談に応える。使用タイミング:「phasegate のセットアップを最適化して」「architecture preset 入ってないけど何が適切？」「Quick Mode の relaxedGates に推奨設定教えて」「baseline 有効化しても大丈夫？」「monorepo に対して targetDirs / formatter が正しく検出されてる？」「v2 schema warning が出る、何を直せばいい？」など、現状 config の診断と改善 diff 提案を求める質問。
+---
+
+# Phasegate Config Doctor
+
+現在の `phasegate.config.json` を診断し、改善案を **diff 形式** でユーザーに提示する skill。**silent 書き換えは禁止** — 必ずユーザー確認を取ってから Edit を実行する。
+
+## このスキルが解決する問題
+
+phasegate を導入した直後の config は単純な default で、実プロジェクトの構造 (monorepo / formatter 選定 / architecture style / Quick Mode の運用方針) に最適化されていない。ユーザーが「設定を最適化したい」と言ったとき、AI が schema を知らずに勘で書き換えると壊れるため、**schema + 検出結果に基づいた決定的提案** が必要。
+
+## 重要な設計原則
+
+1. **silent 書き換え禁止** — 全提案は diff として提示し、ユーザー承認後に Edit
+2. **schema を読んでから提案** — `node_modules/phasegate/scripts/harness/.../schemas/harness-config-v3.schema.json` を Read してから値域を確認
+3. **検出結果を優先** — 機械的に決定可能な部分 (workspace 構造、formatter、bash 互換性) は AI 推論ではなく検出結果を採用
+4. **AI 推論は判断要素のみ** — architecture preset 選定、relaxedGates 推奨値などは AI が判断するが、根拠を必ず示す
+5. **read-only な Q&A は phasegate-toolkit-guide に委譲** — 「L2 って何？」など概念質問は本 skill のスコープ外
+
+## 診断プロセス
+
+### Step 1: 現状把握 (read-only)
+
+以下のファイルを **必ず Read** してから診断する:
+
+| 情報源 | パス | 用途 |
+|---|---|---|
+| 現 config | `phasegate.config.json` | 診断対象 |
+| schema | `node_modules/phasegate/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v3.schema.json` (or `harness-config-v2.schema.json` if v2) | 値域確認 |
+| package.json | `package.json` | devDependencies (formatter 検出) / workspaces 検出 |
+| pnpm workspace | `pnpm-workspace.yaml` | workspace 検出 |
+| lerna config | `lerna.json` | workspace 検出 |
+| hook config | `.claude/scripts/hook-config.json` | 既存 hook 設定確認 |
+
+phasegate リポジトリ自体 (dogfood) の場合は `node_modules/phasegate/` を `docs/` / `scripts/harness/config-foundation/...` に置換。
+
+### Step 2: 診断観点
+
+以下の観点で順に診断する。各観点で **OK / WARN / SUGGEST** のいずれかを出す。
+
+#### 観点 1: schema バージョン
+
+- `architecture` キーが無い → v2 として扱われる → v0.120 以降では `architecture: { preset: "..." }` 追加を推奨 (SUGGEST)
+- `architecture.preset` が "custom" だが `architecture.layers` 未定義 → schema validator で reject される (WARN)
+
+#### 観点 2: project.preset (防御プリセット)
+
+- `project.preset` が未指定 → SUGGEST: プロジェクト規模に応じて `minimal` / `standard` / `strict` から推奨
+- 値が enum 外 → WARN
+
+#### 観点 3: architecture.preset (アーキプリセット)
+
+- 未指定 + `scripts/`, `src/` 配下のディレクトリ構造を検査して推測:
+  - `domain/` `application/` `infrastructure/` `presentation/` の 4 層あり → `clean` を推奨
+  - DDD タクティカル (entities/aggregates/repositories) あり → `strict-ddd` を推奨
+  - `core/`, `adapters/`, `ports/` パターン → `hexagonal` を推奨
+  - 上記いずれも無し、または独自命名 → ユーザーに確認 + `custom` を提案
+- 検出根拠を必ず提示 (例: 「`scripts/harness/{domain,application,infrastructure,presentation}` を検出 → `clean` 推奨」)
+
+#### 観点 4: paths
+
+- `paths.designDocs` / `paths.inceptionDocs` が default のまま (`docs/product/construction` / `docs/inception`) → 実プロジェクトのパスに合っていれば OK
+- 異なるパスに設計文書がある場合 → SUGGEST: 実パスに合わせて変更
+
+#### 観点 5: quickMode
+
+- `quickMode.allowedCategories` が default `['bugfix', 'docs', 'test', 'config']` のまま → プロジェクトの慣習に応じて拡張提案
+- `quickMode.relaxedGates` が空 → small team なら `['phase-gate']` 追加を SUGGEST、enterprise なら現状維持を OK
+
+#### 観点 6: harnesses (cascade / bundle / dead-code)
+
+- `cascadeUpdate: false` → AI 主導開発なら true 推奨 (SUGGEST)
+- `agentLessonCollection: false` → AI セッションの教訓を蓄積したいなら true 推奨 (SUGGEST)
+- `bundleSizeLimit: 0` → frontend プロジェクトなら値設定推奨
+
+#### 観点 7: baseline
+
+- `baseline` セクション不在 → default `enabled: true, path: .phasegate/baseline.json` (v0.117 以降)
+- 既存大規模プロジェクトに後追い導入なら baseline 有効化推奨 (新規違反のみ厳しく検査)
+
+#### 観点 8: agentIntegration.stopHook.enforce (WI-087 Phase C-2)
+
+- 未指定 (`false` 相当) → AI セッションの Stop hook 失敗を **warning のみ** で許容
+- `true` セット → Complete Check 失敗時に Claude Code の turn を hard block (exit 2)
+- 推奨: AI 主導開発で本格運用するなら `true` を SUGGEST
+
+#### 観点 9: hook-config.json (`.claude/scripts/`)
+
+- `targetDirs: ["src"]` のままで monorepo の場合 → WARN: `phasegate init` を再実行すれば WI-087 Phase B の自動検出が効く
+- `formatter: "biome"` だが `@biomejs/biome` が devDependencies に無い → WARN: prettier に切り替え推奨
+- WI-087 v0.119 未満で deploy された hook script (mapfile 使用) → WARN: macOS で silent fail
+
+### Step 3: 提案フォーマット
+
+診断結果を以下の形式でユーザーに提示する:
+
+```markdown
+## phasegate.config.json 診断結果
+
+### サマリ
+- ✅ OK: N 件
+- ⚠️ WARN: N 件
+- 💡 SUGGEST: N 件
+
+### ⚠️ 修正推奨 (WARN)
+
+#### W1: `architecture.preset = "custom"` だが `architecture.layers` が未定義
+- 影響: schema validator で reject される
+- 修正案:
+  ```json-diff
+  - "architecture": { "preset": "custom" }
+  + "architecture": {
+  +   "preset": "custom",
+  +   "layers": [ /* layer 定義 */ ]
+  + }
+  ```
+- 補足: layer 構造が clean / strict-ddd / hexagonal / onion / layered / flat のいずれかに該当するなら、`preset: "<その値>"` に変更する方が簡潔
+
+### 💡 改善提案 (SUGGEST)
+
+#### S1: `architecture.preset` 未指定 → "clean" を推奨
+- 検出根拠: `scripts/harness/{domain,application,infrastructure,presentation}` の 4 ディレクトリが存在
+- 修正案:
+  ```json-diff
+   {
+     "project": { ... },
+  +  "architecture": { "preset": "clean" },
+     "layers": { ... }
+   }
+  ```
+
+### ✅ 問題なし (OK)
+- project.preset = "standard"
+- paths.designDocs / paths.inceptionDocs はデフォルト値で実プロジェクトと一致
+- baseline セクション不在 → default 有効 (v0.117+)
+
+---
+
+上記提案のうち、適用するものを選択してください:
+- [全て適用]
+- [W1 のみ適用]
+- [S1 のみ適用]
+- [何も適用しない (情報のみ)]
+- [カスタム (個別選択)]
+```
+
+### Step 4: 適用
+
+ユーザーが適用対象を確定したら、`Edit` ツールで `phasegate.config.json` を変更。
+
+**変更後の必須検証**:
+
+```bash
+npx phasegate validate --layer L2
+```
+
+L2 でエラーが出た場合は変更を **rollback** し、ユーザーに報告 (silent に進めない)。
+
+## アンチパターン
+
+- ❌ 現 config を読まずに「一般論として推奨」を出す (実態と乖離する)
+- ❌ schema を読まずに値を提案する (enum 外の値を出してしまう)
+- ❌ ユーザー確認を取らずに Edit する
+- ❌ 「とりあえず全部 strict にしておく」のような根拠なき強気提案
+- ❌ phase-dependency-model 関連の改修を無検証で提案 (memory `feedback_dogfood_before_release.md` 適用 — paths config / Artifact 改修は dogfood 必須)
+- ❌ 設定変更後に `npx phasegate validate --layer L2` を走らせずに完了報告
+
+## phasegate-toolkit-guide との使い分け
+
+| 質問種別 | 使う skill |
+|---|---|
+| 「L2 って何？」「Quick Mode の仕組み教えて」(read-only Q&A) | phasegate-toolkit-guide |
+| 「config の relaxedGates 何にすべき？」(設定診断 + 提案) | phasegate-config-doctor |
+| 「monorepo 対応されてる？」(現状確認) | phasegate-toolkit-guide |
+| 「monorepo 用に config 直して」(設定変更) | phasegate-config-doctor |
+
+ユーザー質問が両方にまたがる場合は、まず phasegate-toolkit-guide で概念を説明 → ユーザーが「じゃあ修正して」と言ったら phasegate-config-doctor に切り替える。
+
+## 出力例 (簡易)
+
+ユーザー: 「phasegate のセットアップ最適化して」
+
+```
+[phasegate.config.json を Read]
+[harness-config-v3.schema.json を Read]
+[package.json / pnpm-workspace.yaml を Read]
+[scripts/ ディレクトリ構造を ls]
+
+診断結果:
+- ✅ OK: 5 件 (project / paths / harnesses / reporting / baseline)
+- ⚠️ WARN: 1 件 (W1: architecture.preset 未指定 → v2 schema 扱い → warning が出る)
+- 💡 SUGGEST: 2 件 (S1: clean preset 推奨 / S2: cascadeUpdate=true 推奨)
+
+提案 diff: [上記フォーマット]
+
+どれを適用しますか？
+```

package/skills/phasegate-toolkit-guide/SKILL.md

@@ -0,0 +1,166 @@
+---
+name: phasegate-toolkit-guide
+description: phasegate ツールキット自体に関する Q&A スキル。ユーザーが phasegate の概念 (L0-L4 レイヤーモデル / 防御プリセット / アーキプリセット / Quick Mode と Full Mode / Hook 仕様 / config 全般) について質問したとき、対応する canonical doc を読み込んでから回答する。使用タイミング:「phasegate の L1 と L2 の違いは？」「Quick Mode で許可されるカテゴリを増やしたい」「architecture.preset の使い分けは？」「phasegate の hook って何が動いている？」「phasegate.config.json の relaxedGates は何のため？」など phasegate ツールキット内部の仕様・設定を尋ねる質問。
+---
+
+# Phasegate Toolkit Guide
+
+phasegate ツールキット自体の概念・仕様・設定について、ユーザーの質問に正確に答えるための skill。
+
+## このスキルが解決する問題
+
+ユーザーが phasegate を導入したプロジェクトで、AI に phasegate 関連の質問や設定変更を依頼したとき、AI が `node_modules/phasegate/` を grep で調査して仕様を推測する非効率を防ぐ。
+
+phasegate の概念と仕様は **canonical doc が `node_modules/phasegate/docs/guide/` 配下に同梱されている**。本 skill はそれらへの正確なポインタを提供する。
+
+## 重要な設計原則
+
+**knowledge を skill 本体に固定しない**。本 SKILL.md は「どの doc を読めば答えられるか」のポインタだけを持つ。実際の概念知識は phasegate 同梱 canonical doc から動的に読み込む。
+
+これにより `npm update phasegate` で knowledge が自動追従する (skill markdown に概念本文を書いてしまうとバージョン乖離が起きる)。
+
+## 回答プロセス
+
+1. ユーザー質問を以下の **概念カテゴリ** にマッピング
+2. 対応する canonical doc を **Read tool で読む**
+3. Read した内容に基づいて回答
+4. 回答内に **doc 内の該当セクションへのポインタ** を含める (ユーザーが詳細確認できるように)
+
+### canonical doc の場所
+
+phasegate がインストールされたプロジェクトでは、以下のいずれかにある:
+
+```
+node_modules/phasegate/docs/guide/   # npm 経由でインストールされた consumer プロジェクト
+docs/guide/                           # phasegate リポジトリ自体 (dogfood)
+```
+
+**先に `node_modules/phasegate/docs/guide/` を試し**、見つからなければ `docs/guide/` を試す。
+
+## 概念カテゴリと参照先 doc
+
+### 1. L0-L4 レイヤーモデル
+
+ユーザー質問例:
+- 「phasegate の L1 と L2 の違いって何？」
+- 「L0 ってどこで動いてる？」
+- 「L3 と L4 の検査内容を教えて」
+
+**参照先**: `docs/guide/layer-model.md`
+
+**読み方**: ファイル全体を読む (各層のセクションが明確に分かれている)。
+
+### 2. 防御プリセット / アーキプリセット (重要: 2 系統あり)
+
+ユーザー質問例:
+- 「preset って何？」
+- 「standard と strict の違いは？」
+- 「architecture.preset で onion と clean どっち選ぶべき？」
+- 「アーキプリセットを custom にしたいんだけど」
+
+**重要**: phasegate には **「防御プリセット」(`project.preset`) と「アーキプリセット」(`architecture.preset`) の 2 系統** がある。質問が曖昧な場合は **どちらを聞いているか確認** すること:
+
+| 呼称 | 概念 | 設定キー | 値の例 |
+|---|---|---|---|
+| **防御プリセット** | L3 CI で検査強度を選ぶ | `project.preset` | `minimal` / `standard` / `strict` |
+| **アーキプリセット** | L1 の層構造と依存方向を定義 | `architecture.preset` | `clean` / `strict-ddd` / `onion` / `hexagonal` / `layered` / `flat` / `custom` |
+
+**参照先**: `docs/guide/preset-selection.md` (両系統の詳細解説)
+
+### 3. Quick Mode と Full Mode
+
+ユーザー質問例:
+- 「Quick Mode と Full Mode の違いは？」
+- 「Quick Mode で書き込みが許可されるカテゴリを増やしたい」
+- 「relaxedGates って何のため？」
+- 「allowedCategories はどこで設定する？」
+
+**参照先**: `docs/guide/quick-vs-full-mode.md`
+
+設定キーは `phasegate.config.json` の `quickMode` セクション (`allowedCategories` / `relaxedGates` / `fullModeRequiredWhen`)。詳細は `docs/guide/configuration.md` の `quickMode` セクションも併読。
+
+### 4. Hook 仕様 (PreToolUse / PostToolUse / Stop / SessionStart / UserPromptSubmit)
+
+ユーザー質問例:
+- 「phasegate の hook って何が動いてる？」
+- 「PreToolUse で何が走る？」
+- 「Stop hook の enforce オプションって何？」
+- 「post-tool-use で format / lint が走らない、なぜ？」
+
+**参照先**: `docs/guide/hooks-integration.md`
+
+`Responsibility Separation` セクションに pre / post / Stop の責務分担表がある (WI-086 で追加)。Stop hook の `agentIntegration.stopHook.enforce` オプションは WI-087 Phase C-2 で追加された。
+
+### 5. config 全般 (`phasegate.config.json`)
+
+ユーザー質問例:
+- 「phasegate.config.json の各セクションの意味は？」
+- 「baseline.enabled って何？」
+- 「protectedFiles って何？」
+- 「project.paths にはどうやって書く？」
+
+**参照先**: `docs/guide/configuration.md`
+
+各 top-level セクションごとに説明あり: `project` / `layers` / `quickMode` / `phaseDependencies` / `harnesses` / `paths` / `reporting` / `architecture` / `agentIntegration` / `protectedFiles` / `baseline`。
+
+### 6. CLI コマンド一覧
+
+ユーザー質問例:
+- 「phasegate のコマンド一覧を教えて」
+- 「validate と lint と check-phase の違いは？」
+- 「init コマンドは何をする？」
+
+**参照先**: `docs/guide/cli-reference.md`
+
+### 7. インストールと初期設定
+
+ユーザー質問例:
+- 「phasegate のインストール方法は？」
+- 「monorepo で使うときは？」
+- 「既存プロジェクトに後から導入したい」
+
+**参照先**:
+- 新規導入: `docs/guide/installation.md`, `docs/guide/quickstart.md` (存在する場合)
+- 既存プロジェクト導入: `docs/guide/retrofit-adoption.md`
+
+### 8. skill 一覧と使い分け
+
+ユーザー質問例:
+- 「phasegate にはどんな skill がある？」
+- 「story-implementor と quick-implementor の違いは？」
+
+**参照先**: `docs/guide/skills-overview.md`
+
+### 9. Codex 統合
+
+ユーザー質問例:
+- 「codex CLI と組み合わせて使うには？」
+- 「codex-delegator って何？」
+
+**参照先**: `docs/guide/codex-integration.md`
+
+## 回答時のスタイル
+
+- 簡潔に答える (2-3 段落 + コード例 1 つ程度)
+- canonical doc の **該当セクション名** を必ず引用 (ユーザーが doc を直接開いたときの navigation 補助)
+- 質問が複数カテゴリにまたがる場合は、最も関連性の高い doc を先に読む
+- doc を読まずに回答しない (本 skill の存在意義は「正確な情報源を引く」こと)
+
+## マッピングが曖昧な場合
+
+ユーザー質問が上記カテゴリのいずれにも明確に当てはまらない場合:
+
+1. `docs/guide/` 配下の doc 一覧 (`ls node_modules/phasegate/docs/guide/`) を取得
+2. ファイル名から推測して最も近い doc を読む
+3. それでも見つからなければ、ユーザーに **どの観点を知りたいか** を質問で絞り込む
+
+## 設定変更を伴う質問
+
+「config の X を変更したい」など **設定変更を伴う質問** は、本 skill の範囲外。phasegate-config-doctor skill (存在すれば) に委譲するか、ユーザーに「設定変更には phasegate-config-doctor を起動するのが推奨」と案内する。本 skill は **read-only な Q&A に徹する**。
+
+## アンチパターン
+
+- ❌ canonical doc を読まずに training data 依存で答える (バージョン乖離リスク)
+- ❌ doc 全文をユーザーに貼り付ける (要約して該当セクションへのポインタを返す)
+- ❌ `phasegate.config.json` を直接編集する (本 skill は read-only)
+- ❌ skill 本文に概念解説を書き加える (doc に書くべき。skill はポインタ役)