phasegate 0.160.16 → 0.160.18

package/README.ja.md

@@ -97,7 +97,17 @@ claude
 
 `init` は legacy 互換の bootstrap 経路です。既存 hooks / scripts / package metadata に構造化 merge したい場合は `install` を使います。「設計してから書け」を強制する仕組みなので、設計文書はユーザーがスキル経由で作るのが既定動作です。
 
-既存プロジェクトに導入する場合は、構造化 install で差分を確認してから適用します。
+既存プロジェクトへの導入は、**チーム共通で入れる (team install)** か **自分だけで試す (personal install)** かで手順が変わります。誰のリポジトリで誰がメンテするかで選んでください。
+
+| シナリオ | コマンド | 影響範囲 |
+|---|---|---|
+| 新規プロジェクトを bootstrap | `npx phasegate init --name <name> --with-husky --with-ci` | リポジトリ全体（team） |
+| 既存プロジェクトにチーム共通で導入 | `npx phasegate install --apply` | リポジトリ全体（team） |
+| チーム所有リポジトリで個人評価 | `npx phasegate install --personal --agent claude --apply` | 自分の作業コピーのみ（ローカル） |
+
+#### team install — チーム共通で導入する場合
+
+`package.json` / `CLAUDE.md` / `.husky/*` / `.github/workflows/*` などのチーム共有ファイルを merge 対象に含めます。**この変更はコミット後にチーム全員へ影響します**。事前に dry-run で差分を確認してから apply してください。
 
 ```bash
 npx phasegate install --dry-run
@@ -107,6 +117,24 @@ npx phasegate doctor
 
 `install` は既存の Claude / Codex hooks や Husky script を捨てずに PhaseGate の設定を merge します。書き込み前に変更予定を表示し、package scripts と `phasegate` devDependency、root `skills/` への selected bundled skills 配布、agent skill symlink、未作成の CI workflow、`.phasegate/manifest.json` を整えます。強制的な managed 更新が必要な場合は `npx phasegate install --apply --force` を使います。この場合、置き換え対象は `.phasegate/backups/` に退避されます。<!-- @work-item-id WI-210 -->
 
+#### personal install — 自分だけで試す場合（チーム所有リポジトリで評価したい）
+
+チーム所有のリポジトリで自分だけ PhaseGate を試したい場合は `--personal` フラグを使います。**チーム共有ファイルには一切触れず、自分の agent runtime だけを設定する** ローカル専用パスです。
+
+```bash
+npx phasegate install --personal --agent claude --dry-run
+npx phasegate install --personal --agent claude --apply
+```
+
+| 項目 | personal install の挙動 |
+|---|---|
+| **触らないファイル** | `package.json` / `AGENTS.md` / `CLAUDE.md` / `.husky/*` / `.github/workflows/*` / `.gitignore` / GitHub CLI 設定 / repo secrets / CI 設定 |
+| **作るファイル** | `.phasegate-local/phasegate.config.json`（ローカル専用 config）／ `.claude/CLAUDE.local.md` または `.codex/AGENTS.local.md`（agent context）／ `.claude/settings.json` + `.claude/skills/` または `.codex/hooks.json` + `.codex/skills/`（選択した agent の runtime artifact）／ `.git/hooks/pre-commit` + `.git/hooks/commit-msg`（ローカル git hook）／ `.phasegate-local/docs/`（設計原則文書コピー）／ `.phasegate/manifest.json` |
+| **コミット漏れ対策** | `.git/info/exclude` にローカル専用 block を管理して、個人用ファイルが誤ってチームの commit に混ざらないようにする。commit 時の L2 防御は `.git/hooks/` で発火する |
+| **Codex hook flag** | user-level feature flag の有効化は手動アクションとして残る（`codex features enable hooks`） |
+
+Codex を併用する場合は `--agent codex` または `--agent both` を指定します。アンインストールは team install と同様に `npx phasegate uninstall --apply` を使えば manifest 経由でローカル成果物のみが除去されます。<!-- @work-item-id WI-207 --> <!-- @work-item-id WI-208 --> <!-- @work-item-id WI-209 --> <!-- @work-item-id WI-213 -->
+
 後で PhaseGate を外す場合は、manifest ベースの uninstall を使います。
 
 ```bash
@@ -277,6 +305,12 @@ L2-STORY-REFLECTION バリデータがこのアノテーションを検出し、
   "phaseDependencies": { "preset": "standard", "storyReflection": { "enabled": true } },
   "quickMode":      { "allowedCategories": ["bugfix", "docs", "test", "config"] },
   "protectedFiles": { "exclude": ["package.json"] },
+  "paths": {
+    "designDocs": "docs/product/construction",
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
+  },
   "baseline":       { "enabled": true, "path": ".phasegate/baseline.json" }
 }
 ```
@@ -301,6 +335,7 @@ phasegate には独立した 3 系統の preset があります。役割が違
 |---|---|
 | `quickMode.fullModeRequiredWhen` | Quick Mode → Full Mode への強制エスカレート条件（複数カテゴリ混在 / 新規ドメインファイル / API 契約変更）。安全側の default は全 `true` |
 | `protectedFiles.exclude` | デフォルト保護対象（`package.json`, `tsconfig.json`, `biome.json` 等）から除外したいファイル |
+| `paths.designDocs` / `paths.inceptionDocs` / `paths.principlesDocs` / `paths.folderRulesDoc` | PhaseGate が参照・配置する設計/原則/配置ルール文書の場所。`docs/` 以外の既存規約にもマッピング可能 |
 | `baseline.enabled` | 既存リポジトリ導入時の retrofit grandfather。default `true`。`npx phasegate baseline` で snapshot 生成 |
 | `phaseDependencies.storyReflection` | inception 設計が product docs に反映されるまで `src/{unit}/` への書き込みをブロック |
 

package/README.md

@@ -109,7 +109,7 @@ npx phasegate install --personal --agent claude --dry-run
 npx phasegate install --personal --agent claude --apply
 ```
 
-`--personal` does not plan or write `package.json`, `AGENTS.md`, `CLAUDE.md`, `.husky/*`, `.github/workflows/*`, `.gitignore`, GitHub CLI config, repo secrets, or CI settings. It creates `.phasegate-local/phasegate.config.json`, real local-only agent runtime artifacts for the selected agent (`.claude/settings.json` + `.claude/skills/` and/or `.codex/hooks.json` + `.codex/skills/`), a managed local-only block in `.git/info/exclude`, and `.phasegate/manifest.json`. Codex user-level hook feature enablement remains a manual action. <!-- @work-item-id WI-207 --> <!-- @work-item-id WI-208 --> <!-- @work-item-id WI-209 -->
+`--personal` does not plan or write `package.json`, `AGENTS.md`, `CLAUDE.md`, `.husky/*`, `.github/workflows/*`, `.gitignore`, GitHub CLI config, repo secrets, or CI settings. It creates `.phasegate-local/phasegate.config.json`, local agent context (`.claude/CLAUDE.local.md` and/or `.codex/AGENTS.local.md`), real local-only agent runtime artifacts for the selected agent (`.claude/settings.json` + `.claude/skills/` and/or `.codex/hooks.json` + `.codex/skills/`), local git hooks under `.git/hooks/`, local reference docs under `.phasegate-local/docs/`, a managed local-only block in `.git/info/exclude`, and `.phasegate/manifest.json`. Codex user-level hook feature enablement remains a manual action. <!-- @work-item-id WI-207 --> <!-- @work-item-id WI-208 --> <!-- @work-item-id WI-209 --> <!-- @work-item-id WI-213 -->
 
 For agent-driven setup planning, use:
 
@@ -416,6 +416,12 @@ For selection guidance and config examples see [Preset Selection Guide](docs/gui
   "protectedFiles": {
     "exclude": ["tsconfig.json", "package.json"]
   },
+  "paths": {
+    "designDocs": "docs/product/construction",
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
+  },
   "baseline": {
     "enabled": true,
     "path": ".phasegate/baseline.json"
@@ -425,6 +431,8 @@ For selection guidance and config examples see [Preset Selection Guide](docs/gui
 
 `quickMode.fullModeRequiredWhen` declares which conditions force a Quick Mode change to escalate to the full `/story-implementor` flow. All three triggers default to `true` so retrofits stay safe; flip individual flags to `false` only when a project intentionally accepts the risk.
 
+`paths` maps PhaseGate's design and reference documentation roots. Repositories that do not use `docs/` can point `designDocs`, `inceptionDocs`, `principlesDocs`, and `folderRulesDoc` at their own documentation layout; product-wide Level 1 artifacts are overridden separately with custom `phaseDependencies.gates[]`. <!-- @work-item-id WI-214 -->
+
 `baseline` opts in to the **Phase A-2 retrofit grandfather**: pre-existing files captured in `.phasegate/baseline.json` are exempted from `phase-gate` until they are structurally modified. Generate the snapshot with `npx phasegate baseline` before introducing the harness to an existing repository. Since v0.71.0 the `baseline.enabled` flag defaults to `true`, so simply running `npx phasegate baseline` after `init` is enough — no manual config edit needed. For a step-by-step retrofit walkthrough see [Retrofit Adoption Guide](docs/guide/retrofit-adoption.md).
 
 ---

package/docs/guide/configuration.md

@@ -64,7 +64,9 @@ The plan identifies target fields, managed artifacts, commands, validation, risk
   },
   "paths": {
     "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
   },
   "reporting": {
     "format": "json",
@@ -463,10 +465,14 @@ Quick Mode with `relaxedGates: ["phase-gate"]` relaxes `storyReflection` as well
 
 #### `paths`
 
-| Sub-field       | Type     | Default                        | Description                                           |
-|-----------------|----------|--------------------------------|-------------------------------------------------------|
-| `designDocs`    | `string` | `"docs/product/construction"`  | Root directory for confirmed design documents (logical design, domain model). |
-| `inceptionDocs` | `string` | `"docs/inception"`             | Root directory for inception-phase documents (stories, unit designs).         |
+<!-- @work-item-id WI-214 -->
+
+| Sub-field        | Type     | Default                              | Description                                           |
+|------------------|----------|--------------------------------------|-------------------------------------------------------|
+| `designDocs`     | `string` | `"docs/product/construction"`        | Root directory for confirmed design documents (logical design, domain model). |
+| `inceptionDocs`  | `string` | `"docs/inception"`                   | Root directory for inception-phase documents (stories, unit designs).         |
+| `principlesDocs` | `string` | `"docs/principles"`                  | Root directory for immutable PhaseGate principles docs. |
+| `folderRulesDoc` | `string` | `"docs/folder_management_rules.md"`  | File path for the folder management rules document. |
 
 #### `reporting`
 
@@ -611,6 +617,8 @@ docs/
 
 If you move your design documents to a non-default location, update `paths` accordingly so that all validators and hooks resolve files correctly.
 
+`paths.principlesDocs` and `paths.folderRulesDoc` also control where setup deploys PhaseGate reference docs and what the pre-tool-use hook protects. Existing repositories can keep their own documentation layout, for example `documentation/principles` and `documentation/folder_rules.md`, without adopting the default `docs/` tree. <!-- @work-item-id WI-214 -->
+
 **How paths flow into the L2 phase-gate validator (since v0.117.0 / WI-085):**
 
 <!-- @work-item-id WI-149 -->
@@ -621,6 +629,8 @@ If you move your design documents to a non-default location, update `paths` acco
 |---|---|---|
 | `{designDocsRoot}` | `paths.designDocs` | `docs/product/construction` |
 | `{inceptionDocsRoot}` | `paths.inceptionDocs` | `docs/inception` |
+| `{principlesDocsRoot}` | `paths.principlesDocs` | `docs/principles` |
+| `{folderRulesPath}` | `paths.folderRulesDoc` | `docs/folder_management_rules.md` |
 
 Setting `paths.designDocs` to `mydocs/product/construction` makes the L2 phase-gate require `mydocs/product/construction/{unit}/domain_model.md` instead of the default. This setting points to the construction subtree, not the broader product root; product-wide artifacts under `docs/product/` stay literal unless you define a custom `phaseDependencies.gates[]` preset. Default values match the v0.115.0 layout for full backward compatibility.
 

package/docs/guide/installation.md

@@ -65,7 +65,9 @@ npx phasegate install --personal --agent claude --dry-run
 npx phasegate install --personal --agent claude --apply
 ```
 
-Personal install keeps team-owned files out of both the plan and apply path: `package.json`, `AGENTS.md`, `CLAUDE.md`, `.husky/*`, `.github/workflows/*`, `.gitignore`, GitHub CLI config, repo secrets, and CI settings are not touched. PhaseGate writes `.phasegate-local/phasegate.config.json`, creates real local-only agent runtime artifacts for the selected agent (`.claude/settings.json` + `.claude/skills/` and/or `.codex/hooks.json` + `.codex/skills/`), records `.phasegate/manifest.json`, and manages a local exclude block in `.git/info/exclude`. Codex user-level hook feature enablement is still reported as a manual action. <!-- @work-item-id WI-207 --> <!-- @work-item-id WI-208 --> <!-- @work-item-id WI-209 -->
+Personal install keeps team-owned files out of both the plan and apply path: `package.json`, `AGENTS.md`, `CLAUDE.md`, `.husky/*`, `.github/workflows/*`, `.gitignore`, GitHub CLI config, repo secrets, and CI settings are not touched. PhaseGate writes `.phasegate-local/phasegate.config.json`, creates local agent context (`.claude/CLAUDE.local.md` and/or `.codex/AGENTS.local.md`), creates real local-only agent runtime artifacts for the selected agent (`.claude/settings.json` + `.claude/skills/` and/or `.codex/hooks.json` + `.codex/skills/`), deploys local git hooks under `.git/hooks/`, copies reference docs under `.phasegate-local/docs/`, records `.phasegate/manifest.json`, and manages a local exclude block in `.git/info/exclude`. Codex user-level hook feature enablement is still reported as a manual action. <!-- @work-item-id WI-207 --> <!-- @work-item-id WI-208 --> <!-- @work-item-id WI-209 --> <!-- @work-item-id WI-213 -->
+
+If an existing repository keeps design or governance docs outside `docs/`, set `paths.designDocs`, `paths.inceptionDocs`, `paths.principlesDocs`, and `paths.folderRulesDoc` in `phasegate.config.json` before setup/reconcile. PhaseGate deploy and hook protection use those mappings instead of forcing the default `docs/` layout. <!-- @work-item-id WI-214 -->
 
 For agent-readable planning before writing files:
 

package/docs/templates/personal/hooks/commit-msg

@@ -0,0 +1,7 @@
+#!/usr/bin/env sh
+# PhaseGate personal commit-msg hook.
+# Local-only counterpart of the Husky commit-msg defense.
+
+PHASEGATE_CMD="${PHASEGATE_CMD:-npx phasegate}"
+
+$PHASEGATE_CMD commit-msg "$1"

package/docs/templates/personal/hooks/pre-commit

@@ -0,0 +1,21 @@
+#!/usr/bin/env sh
+# PhaseGate personal pre-commit hook.
+# Local-only counterpart of the Husky pre-commit defense.
+
+PHASEGATE_CMD="${PHASEGATE_CMD:-npx phasegate}"
+
+echo "PhaseGate personal pre-commit"
+
+$PHASEGATE_CMD lint
+L1_EXIT=$?
+if [ $L1_EXIT -ne 0 ]; then
+  echo "PhaseGate lint failed."
+  exit 1
+fi
+
+if [ "${HARNESS_QUICK_MODE:-0}" = "1" ]; then
+  $PHASEGATE_CMD validate --layer L2 --format human --no-l4
+else
+  $PHASEGATE_CMD validate --layer L2 --format human
+fi
+

package/docs/templates/personal/phasegate-local-config.json

@@ -54,8 +54,10 @@
     "deadCodeGC": false
   },
   "paths": {
-    "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "designDocs": ".phasegate-local/product/construction",
+    "inceptionDocs": ".phasegate-local/inception",
+    "principlesDocs": ".phasegate-local/docs/principles",
+    "folderRulesDoc": ".phasegate-local/docs/folder_management_rules.md"
   },
   "reporting": {
     "format": "json",

package/docs/templates/project/phasegate.config.json

@@ -20,7 +20,9 @@
   "harnesses": {},
   "paths": {
     "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
   },
   "reporting": {
     "format": "json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.16",
+  "version": "0.160.18",
   "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/agent-integration/application/usecases/handle-pre-tool-use-usecase.ts

@@ -5,6 +5,7 @@
  * @work-item-id WI-201
  * @work-item-id WI-202 / WI-204
  * @work-item-id WI-206
+ * @work-item-id WI-214
  *
  * HandlePreToolUseUseCase
  * PreToolUse Hook処理のオーケストレーション
@@ -116,7 +117,7 @@ export class HandlePreToolUseUseCase {
       const blockedFilePath = metadata?.blockedFilePath ?? input.targetFilePaths[0];
 
       if (metadata?.reason === "PROTECTED_FILE") {
-        return HandlePreToolUseUseCase.buildProtectedFileBlockOutput(blockedFilePath);
+        return this.buildProtectedFileBlockOutput(blockedFilePath);
       }
 
       if (metadata?.reason === "PHASE_GATE") {
@@ -492,15 +493,22 @@ export class HandlePreToolUseUseCase {
       message: (fp) =>
         `保護ファイルへの書き込みがブロックされました: ${fp}\nClaude Code の設定変更は /update-config スキルを使用してください。`,
     },
-    {
-      pattern: /(?:^|\/)docs\/principles\//,
-      message: (fp) =>
-        `保護ファイルへの書き込みがブロックされました: ${fp}\n原則ドキュメントは immutable です。変更はできません。`,
-    },
   ];
 
-  private static buildProtectedFileBlockOutput(blockedFilePath: string | undefined): HandlePreToolUseOutput {
+  private async buildProtectedFileBlockOutput(blockedFilePath: string | undefined): Promise<HandlePreToolUseOutput> {
     const fp = blockedFilePath ?? "不明なファイル";
+    const dynamicPrinciplesPattern = await this.findMatchingDynamicProtectedPattern(fp, "principles");
+    if (dynamicPrinciplesPattern !== null) {
+      return {
+        shouldBlock: true,
+        blockedFilePath,
+        blockReason: "PROTECTED_FILE",
+        error: {
+          message: `保護ファイルへの書き込みがブロックされました: ${fp}\n原則ドキュメントは immutable です。変更はできません。対象パターン: ${dynamicPrinciplesPattern}`,
+        },
+      };
+    }
+
     const matched = HandlePreToolUseUseCase.PROTECTED_FILE_GUIDANCE.find(({ pattern }) => pattern.test(fp));
     const message = matched
       ? matched.message(fp)
@@ -514,6 +522,20 @@ export class HandlePreToolUseUseCase {
     };
   }
 
+  private async findMatchingDynamicProtectedPattern(filePath: string, kind: "principles"): Promise<string | null> {
+    const patterns = await this.configQueryPort.getProtectedFilePatterns();
+    for (const pattern of patterns) {
+      if (kind === "principles" && !pattern.endsWith("/**")) {
+        continue;
+      }
+      const prefix = pattern.slice(0, -"/**".length);
+      if (filePath === prefix || filePath.startsWith(`${prefix}/`)) {
+        return pattern;
+      }
+    }
+    return null;
+  }
+
   private static buildStoryReflectionBlockOutput(
     blockedFilePath: string | undefined,
     blockers: readonly string[],

package/scripts/harness/agent-integration/infrastructure/adapters/harness-config-config-query-adapter.ts

@@ -36,6 +36,7 @@ interface HarnessesSection {
 }
 
 interface ProtectedFilesSection {
+  patterns?: string[];
   exclude?: string[];
 }
 
@@ -57,6 +58,12 @@ interface AgentIntegrationSection {
 }
 
 interface HarnessConfigDocument {
+  paths?: {
+    designDocs?: string;
+    inceptionDocs?: string;
+    principlesDocs?: string;
+    folderRulesDoc?: string;
+  };
   harnesses?: HarnessesSection;
   project?: ProjectSection;
   protectedFiles?: ProtectedFilesSection;
@@ -102,8 +109,15 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
   }
 
   async getProtectedFilePatterns(): Promise<string[]> {
-    // Wave 2 では追加カスタムパターンなし
-    return [];
+    const config = this.loadConfig();
+    const configured = config.protectedFiles?.patterns ?? [];
+    const principlesDocs = config.paths?.principlesDocs ?? 'docs/principles';
+    const folderRulesDoc = config.paths?.folderRulesDoc ?? 'docs/folder_management_rules.md';
+    return [
+      ...configured,
+      `${normalizeProjectPath(principlesDocs)}/**`,
+      normalizeProjectPath(folderRulesDoc),
+    ];
   }
 
   async getProtectedFileExclusions(): Promise<string[]> {
@@ -119,12 +133,13 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
   getProjectPaths(): ProjectPaths {
     const config = this.loadConfig();
     const paths = config.project?.paths;
+    const topLevelPaths = config.paths;
 
     return ProjectPaths.create(
       paths?.source ?? ['scripts/harness'],
       {
-        construction: paths?.docs?.construction ?? 'docs/product/construction',
-        inception: paths?.docs?.inception ?? 'docs/inception',
+        construction: paths?.docs?.construction ?? topLevelPaths?.designDocs ?? 'docs/product/construction',
+        inception: paths?.docs?.inception ?? topLevelPaths?.inceptionDocs ?? 'docs/inception',
       },
     );
   }
@@ -145,3 +160,7 @@ export class HarnessConfigConfigQueryAdapter implements ConfigQueryPort {
     return enforce === true;
   }
 }
+
+function normalizeProjectPath(path: string): string {
+  return path.replace(/\\/g, '/').replace(/\/+$/g, '');
+}

package/scripts/harness/config-foundation/domain/harness-config.ts

@@ -109,6 +109,8 @@ export interface HarnessConfigResolvedDocument {
   paths: {
     designDocs: string;
     inceptionDocs: string;
+    principlesDocs?: string;
+    folderRulesDoc?: string;
   };
   reporting: {
     format: string;

package/scripts/harness/config-foundation/domain/value-objects/paths-config.ts

@@ -10,18 +10,29 @@ import { ConfigValidationError } from '../errors/config-validation-error.js';
 export interface PathsConfigProps {
   readonly designDocs: string;
   readonly inceptionDocs: string;
+  readonly principlesDocs?: string;
+  readonly folderRulesDoc?: string;
 }
 
 export class PathsConfig {
   readonly designDocs: string;
   readonly inceptionDocs: string;
+  readonly principlesDocs: string;
+  readonly folderRulesDoc: string;
 
   constructor(props: PathsConfigProps) {
+    const principlesDocs = props.principlesDocs ?? 'docs/principles';
+    const folderRulesDoc = props.folderRulesDoc ?? 'docs/folder_management_rules.md';
+
     PathsConfig.validatePath(props.designDocs, 'designDocs');
     PathsConfig.validatePath(props.inceptionDocs, 'inceptionDocs');
+    PathsConfig.validatePath(principlesDocs, 'principlesDocs');
+    PathsConfig.validatePath(folderRulesDoc, 'folderRulesDoc');
 
     this.designDocs = props.designDocs;
     this.inceptionDocs = props.inceptionDocs;
+    this.principlesDocs = principlesDocs;
+    this.folderRulesDoc = folderRulesDoc;
   }
 
   private static validatePath(value: string, fieldName: string): void {
@@ -44,7 +55,9 @@ export class PathsConfig {
   equals(other: PathsConfig): boolean {
     return (
       this.designDocs === other.designDocs &&
-      this.inceptionDocs === other.inceptionDocs
+      this.inceptionDocs === other.inceptionDocs &&
+      this.principlesDocs === other.principlesDocs &&
+      this.folderRulesDoc === other.folderRulesDoc
     );
   }
 }

package/scripts/harness/config-foundation/infrastructure/presets/minimal.json

@@ -41,7 +41,9 @@
   },
   "paths": {
     "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
   },
   "reporting": {
     "format": "json",

package/scripts/harness/config-foundation/infrastructure/presets/standard.json

@@ -41,7 +41,9 @@
   },
   "paths": {
     "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
   },
   "reporting": {
     "format": "json",

package/scripts/harness/config-foundation/infrastructure/presets/strict.json

@@ -41,7 +41,9 @@
   },
   "paths": {
     "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "inceptionDocs": "docs/inception",
+    "principlesDocs": "docs/principles",
+    "folderRulesDoc": "docs/folder_management_rules.md"
   },
   "reporting": {
     "format": "json",

package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v3.schema.json

@@ -435,7 +435,9 @@
       "additionalProperties": false,
       "required": [
         "designDocs",
-        "inceptionDocs"
+        "inceptionDocs",
+        "principlesDocs",
+        "folderRulesDoc"
       ],
       "properties": {
         "designDocs": {
@@ -445,6 +447,14 @@
         "inceptionDocs": {
           "type": "string",
           "minLength": 1
+        },
+        "principlesDocs": {
+          "type": "string",
+          "minLength": 1
+        },
+        "folderRulesDoc": {
+          "type": "string",
+          "minLength": 1
         }
       }
     },
@@ -488,6 +498,14 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "patterns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        },
         "exclude": {
           "type": "array",
           "items": {

package/scripts/harness/installation/application/usecases/run-install.ts

@@ -11,6 +11,8 @@
 // @work-item-id WI-208
 // @work-item-id WI-209
 // @work-item-id WI-210
+// @work-item-id WI-213
+// @work-item-id WI-214
 
 import { mkdir, readFile, writeFile, copyFile, chmod, access, lstat, readlink, symlink, readdir, rm } from "node:fs/promises";
 import { dirname, join } from "node:path";
@@ -89,6 +91,8 @@ const TEXT_BEGIN = "# phasegate personal install exclude (BEGIN)";
 const TEXT_END = "# phasegate personal install exclude (END)";
 const PERSONAL_AGENT_RUNTIME_FILES = new Set([".claude/settings.json", ".codex/hooks.json"]);
 const SHARED_SKILLS_VERSION_PATH = "skills/.harness-version";
+const PERSONAL_PRINCIPLES_DOCS = ".phasegate-local/docs/principles";
+const PERSONAL_FOLDER_RULES_DOC = ".phasegate-local/docs/folder_management_rules.md";
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -624,6 +628,12 @@ export class RunInstallUseCase {
       },
       ...(options.includeClaude
         ? [
+            {
+              path: ".claude/CLAUDE.local.md",
+              strategy: "markdown-managed" as const,
+              templatePath: "docs/templates/agent-context/CLAUDE.md.template.md",
+              block: { start: MARKDOWN_BEGIN, end: MARKDOWN_END, content: "phasegate personal CLAUDE.local.md managed section" },
+            },
             {
               path: ".claude/settings.json",
               strategy: "copy" as const,
@@ -633,6 +643,12 @@ export class RunInstallUseCase {
         : []),
       ...(options.includeCodex
         ? [
+            {
+              path: ".codex/AGENTS.local.md",
+              strategy: "markdown-managed" as const,
+              templatePath: "docs/templates/agent-context/AGENTS.md.template.md",
+              block: { start: MARKDOWN_BEGIN, end: MARKDOWN_END, content: "phasegate personal AGENTS.local.md managed section" },
+            },
             {
               path: ".codex/hooks.json",
               strategy: "copy" as const,
@@ -640,6 +656,38 @@ export class RunInstallUseCase {
             },
           ]
         : []),
+      {
+        path: ".git/hooks/pre-commit",
+        strategy: "copy" as const,
+        templatePath: "docs/templates/personal/hooks/pre-commit",
+        executable: true,
+      },
+      {
+        path: ".git/hooks/commit-msg",
+        strategy: "copy" as const,
+        templatePath: "docs/templates/personal/hooks/commit-msg",
+        executable: true,
+      },
+      {
+        path: PERSONAL_FOLDER_RULES_DOC,
+        strategy: "copy" as const,
+        templatePath: "docs/folder_management_rules.md",
+      },
+      {
+        path: `${PERSONAL_PRINCIPLES_DOCS}/architecture-philosophy.md`,
+        strategy: "copy" as const,
+        templatePath: "docs/principles/architecture-philosophy.md",
+      },
+      {
+        path: `${PERSONAL_PRINCIPLES_DOCS}/model-routing.md`,
+        strategy: "copy" as const,
+        templatePath: "docs/principles/model-routing.md",
+      },
+      {
+        path: `${PERSONAL_PRINCIPLES_DOCS}/testing-rules.md`,
+        strategy: "copy" as const,
+        templatePath: "docs/principles/testing-rules.md",
+      },
       {
         path: ".git/info/exclude",
         strategy: "text-managed" as const,

package/scripts/harness/main.ts

@@ -17,6 +17,7 @@
  * @work-item-id WI-202 / WI-204
  * @work-item-id WI-205
  * @work-item-id WI-206
+ * @work-item-id WI-213
  *
  * Phasegate CLI エントリポイント。
  * 各Unitの Composition Root からハンドラーを取得し、コマンドに応じてディスパッチする。
@@ -167,7 +168,7 @@ Setup:
                                 --skills <core|all>, --agent <claude|codex|both>, --workflow <standard|strict>,
                                 --with-husky, --with-ci, --yes)
   update-skills                Alias for reconcile (kept for compatibility)
-  doctor                       Diagnose silent installation failures (--json, --strict, --agent <claude|codex|both>, --report-out <path>)
+  doctor                       Diagnose silent installation failures (--json, --strict, --personal, --agent <claude|codex|both>, --report-out <path>)
   scaffold-wi <unit|_cross> <story|issue|chore>
                                Create docs/inception/{unit}/WI-XXX/description.md
   emit-agent-rules             Print AGENTS.md / CLAUDE.md WI workflow rules block
@@ -2001,7 +2002,7 @@ async function main(): Promise<void> {
       }
 
       case "doctor": {
-        const KNOWN_DOCTOR_FLAGS = ["--json", "--strict", "--agent", "--report-out"];
+        const KNOWN_DOCTOR_FLAGS = ["--json", "--strict", "--personal", "--agent", "--report-out"];
         const flagError = validateKnownFlags(args, KNOWN_DOCTOR_FLAGS);
         if (flagError) {
           console.error(flagError);

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

@@ -7,7 +7,7 @@
 // Note: import.meta.url を使わず、呼び出し元 (main.ts) がパスを解決して渡す設計。
 
 import { promises as fs } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 
 const HARNESS_VERSION_FILE = ".harness-version";
 const SKILLS_SOURCE_DIR = "skills";
@@ -18,6 +18,8 @@ const CODEX_SKILLS_LINK_DIR = ".codex";
 const HARNESS_CONFIG_FILE = "phasegate.config.json";
 const HOOKS_TEMPLATE_DIR = join("templates", ".claude");
 const HOOKS_TARGET_DIR = ".claude";
+const DEFAULT_PRINCIPLES_DOCS = join("docs", "principles");
+const DEFAULT_FOLDER_RULES_DOC = join("docs", "folder_management_rules.md");
 
 // ── Skill Category Map ──
 
@@ -516,33 +518,55 @@ export interface DeployDesignDocsResult {
   skippedFiles: string[];
 }
 
+interface DesignDocsPathConfig {
+  readonly principlesDocs: string;
+  readonly folderRulesDoc: string;
+}
+
+async function resolveDesignDocsPathConfig(projectRoot: string): Promise<DesignDocsPathConfig> {
+  try {
+    const raw = await fs.readFile(join(projectRoot, HARNESS_CONFIG_FILE), "utf-8");
+    const config = JSON.parse(raw) as { paths?: { principlesDocs?: unknown; folderRulesDoc?: unknown } };
+    const principlesDocs =
+      typeof config.paths?.principlesDocs === "string" && config.paths.principlesDocs.length > 0
+        ? config.paths.principlesDocs
+        : DEFAULT_PRINCIPLES_DOCS;
+    const folderRulesDoc =
+      typeof config.paths?.folderRulesDoc === "string" && config.paths.folderRulesDoc.length > 0
+        ? config.paths.folderRulesDoc
+        : DEFAULT_FOLDER_RULES_DOC;
+    return { principlesDocs, folderRulesDoc };
+  } catch {
+    return { principlesDocs: DEFAULT_PRINCIPLES_DOCS, folderRulesDoc: DEFAULT_FOLDER_RULES_DOC };
+  }
+}
+
 export async function deployDesignDocs(harnessRoot: string, projectRoot: string): Promise<DeployDesignDocsResult> {
   const copiedFiles: string[] = [];
   const skippedFiles: string[] = [];
-  const docsTargetDir = join(projectRoot, "docs");
-  const principlesTargetDir = join(docsTargetDir, "principles");
+  const pathConfig = await resolveDesignDocsPathConfig(projectRoot);
+  const principlesTargetDir = join(projectRoot, pathConfig.principlesDocs);
 
-  await fs.mkdir(docsTargetDir, { recursive: true });
+  await fs.mkdir(join(projectRoot, dirname(pathConfig.folderRulesDoc)), { recursive: true });
   await fs.mkdir(principlesTargetDir, { recursive: true });
 
-  const folderRulesRelativePath = join("docs", "folder_management_rules.md");
-  const folderRulesSource = join(harnessRoot, folderRulesRelativePath);
-  const folderRulesTarget = join(projectRoot, folderRulesRelativePath);
+  const folderRulesSource = join(harnessRoot, DEFAULT_FOLDER_RULES_DOC);
+  const folderRulesTarget = join(projectRoot, pathConfig.folderRulesDoc);
 
   try {
     await fs.access(folderRulesTarget);
-    skippedFiles.push(folderRulesRelativePath);
+    skippedFiles.push(pathConfig.folderRulesDoc);
   } catch {
     try {
       await fs.access(folderRulesSource);
       await fs.copyFile(folderRulesSource, folderRulesTarget);
-      copiedFiles.push(folderRulesRelativePath);
+      copiedFiles.push(pathConfig.folderRulesDoc);
     } catch {
       // 配置元が存在しない場合はスキップ
     }
   }
 
-  const principlesSourceDir = join(harnessRoot, "docs", "principles");
+  const principlesSourceDir = join(harnessRoot, DEFAULT_PRINCIPLES_DOCS);
 
   try {
     const principleEntries = await fs.readdir(principlesSourceDir, { withFileTypes: true });
@@ -552,7 +576,7 @@ export async function deployDesignDocs(harnessRoot: string, projectRoot: string)
       .sort();
 
     for (const principleFile of principleFiles) {
-      const relativePath = join("docs", "principles", principleFile);
+      const relativePath = join(pathConfig.principlesDocs, principleFile);
       const sourcePath = join(principlesSourceDir, principleFile);
       const targetPath = join(projectRoot, relativePath);