phasegate 0.160.16 → 0.160.17

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

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:
 

package/docs/guide/installation.md

@@ -65,7 +65,7 @@ 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 -->
 
 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,8 @@
     "deadCodeGC": false
   },
   "paths": {
-    "designDocs": "docs/product/construction",
-    "inceptionDocs": "docs/inception"
+    "designDocs": ".phasegate-local/product/construction",
+    "inceptionDocs": ".phasegate-local/inception"
   },
   "reporting": {
     "format": "json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.16",
+  "version": "0.160.17",
   "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/installation/application/usecases/run-install.ts

@@ -11,6 +11,7 @@
 // @work-item-id WI-208
 // @work-item-id WI-209
 // @work-item-id WI-210
+// @work-item-id WI-213
 
 import { mkdir, readFile, writeFile, copyFile, chmod, access, lstat, readlink, symlink, readdir, rm } from "node:fs/promises";
 import { dirname, join } from "node:path";
@@ -624,6 +625,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 +640,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 +653,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: ".phasegate-local/docs/folder_management_rules.md",
+        strategy: "copy" as const,
+        templatePath: "docs/folder_management_rules.md",
+      },
+      {
+        path: ".phasegate-local/docs/principles/architecture-philosophy.md",
+        strategy: "copy" as const,
+        templatePath: "docs/principles/architecture-philosophy.md",
+      },
+      {
+        path: ".phasegate-local/docs/principles/model-routing.md",
+        strategy: "copy" as const,
+        templatePath: "docs/principles/model-routing.md",
+      },
+      {
+        path: ".phasegate-local/docs/principles/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);