phasegate 0.160.13 → 0.160.15

package/README.md

@@ -105,11 +105,11 @@ npx phasegate doctor
 For personal evaluation inside a team-owned repository, use local-only install:
 
 ```bash
-npx phasegate install --personal --dry-run
-npx phasegate install --personal --apply
+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/*`, or `.gitignore`. It creates `.phasegate-local/config.json`, adds a managed local-only block to `.git/info/exclude`, records personal artifacts in `.phasegate/manifest.json`, and reports Codex user-level hook setup as a manual action instead of writing `.codex/hooks.json`. <!-- @work-item-id WI-207 -->
+`--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 -->
 
 For agent-driven setup planning, use:
 

package/docs/guide/getting-started.md

@@ -12,7 +12,7 @@ Start with one question: what kind of repository are you setting up?
 |---|---|---|
 | New project with agent hooks | `npx phasegate init --name <project> --agent both --with-husky --with-ci` | `phasegate.config.json`, skills, hooks, agent context files, Husky, and CI targets exist |
 | Existing repository | `npx phasegate install --dry-run` then `npx phasegate install --apply` | Existing hooks/scripts are preserved and `.phasegate/manifest.json` records managed targets |
-| Personal evaluation in a team repository | `npx phasegate install --personal --dry-run` then `npx phasegate install --personal --apply` | Team-owned files stay untouched; `.phasegate-local/config.json` and `.git/info/exclude` local-only entries are recorded |
+| Personal evaluation in a team repository | `npx phasegate install --personal --agent claude --dry-run` then `npx phasegate install --personal --agent claude --apply` | Team-owned files stay untouched; `.phasegate-local/` stores config and ignored real `.claude/*` / `.codex/*` runtime artifacts expose hooks and skills to selected agents |
 | CI-only rollout | `npx phasegate setup:agent --intent ci-only --with-ci --dry-run --json` | The plan explains CI changes without requiring local hooks |
 | Codex-only project | `npx phasegate init --agent codex --with-husky` | `.codex/hooks.json`, `AGENTS.md`, `.codex/skills`, and pre-commit backstop are present |
 | Strict validation rollout | `npx phasegate setup:agent --intent strict --dry-run --json` | The plan lists strict checks, L4 risk, rollback, and validation commands |

package/docs/guide/installation.md

@@ -61,11 +61,11 @@ npx phasegate doctor
 For personal evaluation inside a team-owned repository:
 
 ```bash
-npx phasegate install --personal --dry-run
-npx phasegate install --personal --apply
+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/*`, and `.gitignore` are not touched. PhaseGate writes only local artifacts: `.phasegate-local/config.json`, `.phasegate/manifest.json`, and a managed block in `.git/info/exclude`. Codex user-level hook setup is reported as a manual action instead of writing project-local `.codex/hooks.json`. <!-- @work-item-id WI-207 -->
+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 -->
 
 For agent-readable planning before writing files:
 

package/docs/guide/setup-artifacts.md

@@ -5,16 +5,18 @@ PhaseGate setup is more than `phasegate.config.json`. A healthy installation is
 <!-- @work-item-id WI-152 -->
 <!-- @work-item-id WI-157 -->
 <!-- @work-item-id WI-169 -->
+<!-- @work-item-id WI-208 -->
+<!-- @work-item-id WI-209 -->
 
 ## Artifact Classes
 
 | Class | Examples | Owner | Lifecycle |
 |---|---|---|---|
-| Managed target | `.claude/settings.json`, `.codex/hooks.json`, `CLAUDE.md`, `AGENTS.md`, `.husky/pre-commit`, `.husky/commit-msg`, `.husky/pre-push`, `.github/workflows/phasegate-aidlc-gate.yml`, `.claude/skills`, `.codex/skills`, `package.json` PhaseGate scripts/devDependency | PhaseGate managed block or symlink plus user content | Created or merged by `install`, refreshed by `reconcile`, removed or reversed by `uninstall` |
-| Configuration | `phasegate.config.json`, `package.json` | User owned, PhaseGate assisted | Created by `init`; `install` may merge scripts/devDependency into `package.json` |
+| Managed target | `phasegate.config.json`, `.claude/settings.json`, `.codex/hooks.json`, `CLAUDE.md`, `AGENTS.md`, `.husky/pre-commit`, `.husky/commit-msg`, `.husky/pre-push`, `.github/workflows/phasegate-aidlc-gate.yml`, `.claude/skills`, `.codex/skills`, `package.json` PhaseGate scripts/devDependency | PhaseGate managed block, real runtime artifact, or symlink plus user content | Created or merged by `install`, refreshed by `reconcile`, removed or reversed by `uninstall` |
+| Configuration | `phasegate.config.json`, `package.json` | User owned, PhaseGate assisted | Created by `init` or project install when absent; `install` may merge scripts/devDependency into `package.json` |
 | Generated artifact | `.phasegate/manifest.json`, `.phasegate/backups/*`, `.phasegate/uninstalled-*.json`, `.phasegate/baseline.json` | PhaseGate | Written by lifecycle commands and validators; safe to regenerate only through the owning command |
 | Runtime state/report | `.phasegate/hook-skip-events.jsonl`, explicit `doctor --report-out <path>` output, `reports/regression/*`, resolved `reporting.outputDir` reports | PhaseGate command output | Produced while hooks, doctor, and validation commands run |
-| Personal install artifact | `.phasegate-local/config.json`, `.git/info/exclude` PhaseGate block | One developer on one machine | Created by `phasegate install --personal`; team `.gitignore` and team-owned files are not modified |
+| Personal install artifact | `.phasegate-local/phasegate.config.json`, ignored real `.claude/settings.json` + `.claude/skills/`, ignored real `.codex/hooks.json` + `.codex/skills/`, `.git/info/exclude` PhaseGate block | One developer on one machine | Created by `phasegate install --personal --agent <agent>`; team `.gitignore`, team-owned files, GitHub CLI config, repo secrets, and CI settings are not modified |
 | Legacy artifact | `.harness-hooks.yml`, old Fuse hook files, `.harness/session-state.json`, `.harness/context-priority.json`, `.harness/reports` fallback | Compatibility only | Not required for current install lifecycle unless a project intentionally keeps an archived integration |
 | User-level setting | Codex CLI `hooks` feature flag | User machine | Must be enabled manually with `codex features enable hooks`; project commands do not modify it |
 
@@ -27,6 +29,7 @@ PhaseGate setup is more than `phasegate.config.json`. A healthy installation is
 - Husky scripts when requested: `.husky/pre-commit`, `.husky/commit-msg`, `.husky/pre-push`
 - CI workflow when requested: `.github/workflows/phasegate-aidlc-gate.yml`
 - Agent skill links: `.claude/skills`, `.codex/skills`
+- Project config: `phasegate.config.json` when absent, so installed agent hooks have a discoverable runtime config
 - Package metadata: PhaseGate scripts and `devDependencies.phasegate` in `package.json`
 - Manifest: `.phasegate/manifest.json`
 
@@ -34,6 +37,12 @@ PhaseGate setup is more than `phasegate.config.json`. A healthy installation is
 
 `init --with-ci` still deploys the legacy-compatible template set, including `.github/workflows/aidlc-gate.yml`, `.github/workflows/consistency-check.yml`, and `.github/workflows/agent-context-refresh.yml`. Structured `install` uses `.github/workflows/phasegate-aidlc-gate.yml` so it can coexist with existing project CI without taking over a generic workflow filename.
 
+## Personal Install Artifacts
+
+`phasegate install --personal --agent claude --apply` is a local-only bootstrap for evaluating PhaseGate in a team-owned repository. PhaseGate config is stored under `.phasegate-local/`, while selected agent runtime paths are real project-local files/directories: `.claude/settings.json` and `.claude/skills/` for Claude Code, `.codex/hooks.json` and `.codex/skills/` for Codex. These paths are hidden by `.git/info/exclude`; PhaseGate does not edit team `.gitignore`.
+
+If `.claude/*` or `.codex/*` already exists and is not a PhaseGate-managed personal artifact, personal install reports manual review and preserves the existing path. <!-- @work-item-id WI-209 -->
+
 ## Doctor Findings
 
 `phasegate doctor` evaluates setup health from the managed targets and related project state. Findings include `repairMode`, optional `repairHint`, and optional `suggestedSkill`.

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

@@ -1,7 +1,77 @@
 {
-  "version": "1.0",
   "project": {
-    "name": "personal-phasegate"
+    "name": "personal-phasegate",
+    "preset": "standard"
   },
-  "personal": true
+  "layers": {
+    "L1": {
+      "enabled": true
+    },
+    "L2": {
+      "enabled": true
+    },
+    "L3": {
+      "enabled": true
+    },
+    "L4": {
+      "enabled": false
+    }
+  },
+  "quickMode": {
+    "allowedCategories": [
+      "bugfix",
+      "docs",
+      "test",
+      "config"
+    ],
+    "maintainedLayers": [
+      "L1",
+      "L2"
+    ],
+    "relaxedGates": [
+      "phase-gate",
+      "2-phase-execution"
+    ],
+    "fullModeRequiredWhen": {
+      "mixedCategories": true,
+      "newDomainFile": true,
+      "apiContractChange": true
+    }
+  },
+  "phaseDependencies": {
+    "preset": "default",
+    "override": false,
+    "customRules": []
+  },
+  "planningMode": {
+    "default": "interactive",
+    "perPhase": {}
+  },
+  "harnesses": {
+    "agentLessonCollection": false,
+    "cascadeUpdate": false,
+    "bundleSizeLimit": 0,
+    "deadCodeGC": false
+  },
+  "paths": {
+    "designDocs": "docs/product/construction",
+    "inceptionDocs": "docs/inception"
+  },
+  "reporting": {
+    "format": "json",
+    "outputDir": "reports"
+  },
+  "protectedFiles": {
+    "exclude": [
+      "tsconfig.json",
+      "package.json"
+    ]
+  },
+  "baseline": {
+    "enabled": true,
+    "path": ".phasegate/baseline.json"
+  },
+  "architecture": {
+    "preset": "clean"
+  }
 }

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

@@ -0,0 +1,29 @@
+{
+  "project": {
+    "name": "phasegate-project",
+    "preset": "standard"
+  },
+  "architecture": {
+    "preset": "clean"
+  },
+  "layers": {},
+  "quickMode": {},
+  "phaseDependencies": {
+    "preset": "default",
+    "override": false,
+    "customRules": []
+  },
+  "planningMode": {
+    "default": "interactive",
+    "perPhase": {}
+  },
+  "harnesses": {},
+  "paths": {
+    "designDocs": "docs/product/construction",
+    "inceptionDocs": "docs/inception"
+  },
+  "reporting": {
+    "format": "json",
+    "outputDir": "reports"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.13",
+  "version": "0.160.15",
   "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/presentation/phasegate-status-context.ts

@@ -1,6 +1,7 @@
 /**
  * @layer presentation
  * @unit agent-integration
+ * @work-item-id WI-208
  *
  * Phasegate 状態を context 文字列として組み立てる共有ヘルパー。
  * SessionStart / UserPromptSubmit hook が共通で使用する。
@@ -54,18 +55,27 @@ const DEFAULT_PROTECTED_PATTERNS = [
 export async function findConfigPath(startDir: string): Promise<string | null> {
   let dir = startDir;
   while (true) {
-    const candidate = path.join(dir, 'phasegate.config.json');
-    try {
-      await fs.access(candidate);
-      return candidate;
-    } catch {
-      const parent = path.dirname(dir);
-      if (parent === dir) return null;
-      dir = parent;
+    const candidates = [
+      path.join(dir, 'phasegate.config.json'),
+      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+    ];
+    for (const candidate of candidates) {
+      try {
+        await fs.access(candidate);
+        return candidate;
+      } catch {}
     }
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
   }
 }
 
+export function projectRootForConfig(configPath: string): string {
+  const configDir = path.dirname(configPath);
+  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+}
+
 async function loadConfig(configPath: string): Promise<PhasegateConfig> {
   try {
     const raw = await fs.readFile(configPath, 'utf8');
@@ -122,7 +132,7 @@ export async function collectPhasegateStatus(cwd: string): Promise<PhasegateStat
   const configPath = await findConfigPath(cwd);
   const configFound = configPath !== null;
   const config: PhasegateConfig = configFound ? await loadConfig(configPath) : {};
-  const projectRoot = configFound ? path.dirname(configPath) : cwd;
+  const projectRoot = configFound ? projectRootForConfig(configPath) : cwd;
 
   const protectedPatterns = computeProtectedPatterns(config);
   const blockedUnits = await findBlockedUnits(projectRoot, config);

package/scripts/harness/agent-integration/presentation/post-tool-use-hook.ts

@@ -1,6 +1,7 @@
 /**
  * @layer presentation
  * @unit agent-integration
+ * @work-item-id WI-208
  *
  * PostToolUse Hook Adapter
  * Claude Code の PostToolUse Hook エントリポイント
@@ -30,19 +31,28 @@ async function readStdin(): Promise<string> {
 async function findConfigPath(): Promise<string> {
   let dir = process.cwd();
   while (true) {
-    const candidate = path.join(dir, 'phasegate.config.json');
-    try {
-      await fs.access(candidate);
-      return candidate;
-    } catch {
-      const parent = path.dirname(dir);
-      if (parent === dir) break;
-      dir = parent;
+    const candidates = [
+      path.join(dir, 'phasegate.config.json'),
+      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+    ];
+    for (const candidate of candidates) {
+      try {
+        await fs.access(candidate);
+        return candidate;
+      } catch {}
     }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
   }
   return path.join(process.cwd(), 'phasegate.config.json');
 }
 
+function projectRootForConfig(configPath: string): string {
+  const configDir = path.dirname(configPath);
+  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+}
+
 async function main(): Promise<void> {
   let raw: string;
   try {
@@ -82,7 +92,7 @@ async function main(): Promise<void> {
 
     if (output.skipReason) {
       await recordHookSkipEvent({
-        projectRoot: path.dirname(configPath),
+        projectRoot: projectRootForConfig(configPath),
         hookType: 'post-tool-use',
         reason: output.skipReason,
         targetPaths: [],

package/scripts/harness/agent-integration/presentation/pre-tool-use-hook.ts

@@ -3,6 +3,7 @@
  * @unit agent-integration
  * @work-item-id WI-202 / WI-204
  * @work-item-id WI-206
+ * @work-item-id WI-208
  *
  * PreToolUse Hook Adapter
  * Claude Code の PreToolUse Hook エントリポイント
@@ -57,19 +58,28 @@ async function readStdin(): Promise<string> {
 async function findConfigPath(startDir: string): Promise<string> {
   let dir = startDir;
   while (true) {
-    const candidate = path.join(dir, 'phasegate.config.json');
-    try {
-      await fs.access(candidate);
-      return candidate;
-    } catch {
-      const parent = path.dirname(dir);
-      if (parent === dir) break;
-      dir = parent;
+    const candidates = [
+      path.join(dir, 'phasegate.config.json'),
+      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+    ];
+    for (const candidate of candidates) {
+      try {
+        await fs.access(candidate);
+        return candidate;
+      } catch {}
     }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
   }
   return path.join(startDir, 'phasegate.config.json');
 }
 
+function projectRootForConfig(configPath: string): string {
+  const configDir = path.dirname(configPath);
+  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+}
+
 function isProjectExternalAbsolutePath(filePath: string): boolean {
   return path.isAbsolute(filePath);
 }
@@ -139,24 +149,25 @@ async function main(): Promise<void> {
     const configPath = await findConfigPath(cwd);
     const projectTargetFilePaths = targetFilePaths.filter((filePath) => !isProjectExternalAbsolutePath(filePath));
     const projectTargetChanges = targetChanges.filter((change) => !isProjectExternalAbsolutePath(change.filePath));
+    const projectRoot = projectRootForConfig(configPath);
     const configQueryPort = new HarnessConfigConfigQueryAdapter(configPath);
     const phaseGateQueryPort = new PhaseGateQueryAdapter();
     const storyReflectionQueryPort = new FileSystemStoryReflectionQueryAdapter({
-      rootDir: path.dirname(configPath),
+      rootDir: projectRoot,
       configPath,
     });
     const fullModeRequirementQueryPort = new QuickModeFullModeRequirementAdapter({
       classifyUseCaseFactory: () => createQuickModeCompositionRoot().classifyUseCase,
     });
     const baselineGrandfatherQueryPort = new CiGovernanceBaselineGrandfatherAdapter({
-      baseDir: path.dirname(configPath),
+      baseDir: projectRoot,
       configQueryPort,
     });
     const errorGuidanceQueryPort = new HarnessErrorGuidanceAdapter({
-      rootDir: path.dirname(configPath),
+      rootDir: projectRoot,
     });
     const fullModeSessionQueryPort = new FileSystemFullModeSessionQueryAdapter({
-      rootDir: path.dirname(configPath),
+      rootDir: projectRoot,
       configQueryPort,
     });
     const useCase = new HandlePreToolUseUseCase({

package/scripts/harness/agent-integration/presentation/stop-hook.ts

@@ -2,6 +2,7 @@
  * @layer presentation
  * @unit agent-integration
  * @work-item-id WI-203
+ * @work-item-id WI-208
  *
  * Stop Hook Adapter
  * Claude Code の Stop Hook エントリポイント
@@ -45,19 +46,28 @@ async function readStdin(): Promise<string> {
 async function findConfigPath(): Promise<string> {
   let dir = process.cwd();
   while (true) {
-    const candidate = path.join(dir, 'phasegate.config.json');
-    try {
-      await fs.access(candidate);
-      return candidate;
-    } catch {
-      const parent = path.dirname(dir);
-      if (parent === dir) break;
-      dir = parent;
+    const candidates = [
+      path.join(dir, 'phasegate.config.json'),
+      path.join(dir, '.phasegate-local', 'phasegate.config.json'),
+    ];
+    for (const candidate of candidates) {
+      try {
+        await fs.access(candidate);
+        return candidate;
+      } catch {}
     }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
   }
   return path.join(process.cwd(), 'phasegate.config.json');
 }
 
+function projectRootForConfig(configPath: string): string {
+  const configDir = path.dirname(configPath);
+  return path.basename(configDir) === '.phasegate-local' ? path.dirname(configDir) : configDir;
+}
+
 async function main(): Promise<void> {
   let raw: string;
   try {
@@ -99,7 +109,7 @@ async function main(): Promise<void> {
 
     if (output.skipReason === 'REENTRY_DETECTED') {
       await recordHookSkipEvent({
-        projectRoot: path.dirname(configPath),
+        projectRoot: projectRootForConfig(configPath),
         hookType: 'stop',
         reason: output.skipReason,
         targetPaths: [],

package/scripts/harness/agent-integration/presentation/user-prompt-submit-hook.ts

@@ -1,12 +1,13 @@
 // @unit agent-integration
 // @layer presentation
+// @work-item-id WI-208
 
-import * as path from 'node:path';
 import {
   buildUserPromptSubmitContext,
   collectPhasegateStatus,
   collectRecentViolations,
   findConfigPath,
+  projectRootForConfig,
 } from './phasegate-status-context.js';
 
 async function readStdin(): Promise<string> {
@@ -29,7 +30,7 @@ async function main(): Promise<void> {
   // 違反検知の起点は config が見つかったディレクトリ (= project root)。
   // config が無ければ cwd をそのまま使う。
   const configPath = await findConfigPath(cwd);
-  const projectRoot = configPath !== null ? path.dirname(configPath) : cwd;
+  const projectRoot = configPath !== null ? projectRootForConfig(configPath) : cwd;
   const violations = await collectRecentViolations(projectRoot, status);
   const additionalContext = buildUserPromptSubmitContext(status, violations);
 

package/scripts/harness/config-foundation/infrastructure/repositories/file-system-config-repository.ts

@@ -7,6 +7,7 @@ import path from 'node:path';
 import type { ConfigRepositoryPort } from '../../domain/ports/config-repository-port.js';
 
 const DEFAULT_CONFIG_FILE_NAME = 'phasegate.config.json';
+const PERSONAL_CONFIG_PATH = path.join('.phasegate-local', DEFAULT_CONFIG_FILE_NAME);
 
 export class ConfigNotFoundError extends Error {
   readonly configPath: string;
@@ -45,10 +46,15 @@ async function findNearestConfig(startDirectory: string): Promise<string | null>
   let currentDirectory = path.resolve(startDirectory);
 
   while (true) {
-    const candidate = path.join(currentDirectory, DEFAULT_CONFIG_FILE_NAME);
-
-    if (await exists(candidate)) {
-      return candidate;
+    const candidates = [
+      path.join(currentDirectory, DEFAULT_CONFIG_FILE_NAME),
+      path.join(currentDirectory, PERSONAL_CONFIG_PATH),
+    ];
+
+    for (const candidate of candidates) {
+      if (await exists(candidate)) {
+        return candidate;
+      }
     }
 
     const parentDirectory = path.dirname(currentDirectory);

package/scripts/harness/installation/application/checks/check-utils.ts

@@ -1,6 +1,7 @@
 // @unit installation
 // @layer application
 // @work-item-id WI-145
+// @work-item-id WI-209
 
 import { join } from "node:path";
 import type { CheckId } from "../../domain/check-id.js";
@@ -63,3 +64,7 @@ export function skillTargetLooksValid(target: string | null): boolean {
   const normalized = target.replaceAll("\\", "/").replace(/\/+$/, "");
   return normalized === "skills" || normalized === "../skills" || normalized.endsWith("/skills");
 }
+
+export function skillDirectoryLooksValid(files: readonly string[]): boolean {
+  return files.some((file) => file.endsWith("/SKILL.md") || file.endsWith("\\SKILL.md") || file.endsWith(".harness-version"));
+}

package/scripts/harness/installation/application/checks/claude-skills-symlink-check.ts

@@ -1,11 +1,12 @@
 // @unit installation
 // @layer application
 // @work-item-id WI-145
+// @work-item-id WI-209
 
 import type { FileInspectorPort } from "../ports/file-inspector-port.js";
 import type { HeuristicCheck } from "../../domain/ports/heuristic-check.js";
 import type { DiagnosticFinding } from "../../domain/diagnostic-finding.js";
-import { createFinding, projectPath, skillTargetLooksValid } from "./check-utils.js";
+import { createFinding, projectPath, skillDirectoryLooksValid, skillTargetLooksValid } from "./check-utils.js";
 
 export class ClaudeSkillsSymlinkCheck implements HeuristicCheck {
   readonly checkId = "claude-skills-symlink" as const;
@@ -14,11 +15,13 @@ export class ClaudeSkillsSymlinkCheck implements HeuristicCheck {
   async run(projectRoot: string, inspector: FileInspectorPort): Promise<DiagnosticFinding | null> {
     const link = await inspector.readSymlink(projectPath(projectRoot, this.target));
     if (skillTargetLooksValid(link)) return null;
+    const files = await inspector.listFiles(projectPath(projectRoot, this.target));
+    if (skillDirectoryLooksValid(files)) return null;
     return createFinding({
       checkId: this.checkId,
       severity: "red",
       target: this.target,
-      message: ".claude/skills が phasegate skills を指していません",
+      message: ".claude/skills に phasegate skills がありません",
       repairMode: link === null ? "mechanical" : "manual",
     });
   }

package/scripts/harness/installation/application/checks/codex-skills-symlink-check.ts

@@ -1,11 +1,12 @@
 // @unit installation
 // @layer application
 // @work-item-id WI-145
+// @work-item-id WI-209
 
 import type { FileInspectorPort } from "../ports/file-inspector-port.js";
 import type { HeuristicCheck } from "../../domain/ports/heuristic-check.js";
 import type { DiagnosticFinding } from "../../domain/diagnostic-finding.js";
-import { createFinding, projectPath, skillTargetLooksValid } from "./check-utils.js";
+import { createFinding, projectPath, skillDirectoryLooksValid, skillTargetLooksValid } from "./check-utils.js";
 
 export class CodexSkillsSymlinkCheck implements HeuristicCheck {
   readonly checkId = "codex-skills-symlink" as const;
@@ -14,11 +15,13 @@ export class CodexSkillsSymlinkCheck implements HeuristicCheck {
   async run(projectRoot: string, inspector: FileInspectorPort): Promise<DiagnosticFinding | null> {
     const link = await inspector.readSymlink(projectPath(projectRoot, this.target));
     if (skillTargetLooksValid(link)) return null;
+    const files = await inspector.listFiles(projectPath(projectRoot, this.target));
+    if (skillDirectoryLooksValid(files)) return null;
     return createFinding({
       checkId: this.checkId,
       severity: "red",
       target: this.target,
-      message: ".codex/skills が phasegate skills を指していません",
+      message: ".codex/skills に phasegate skills がありません",
       repairMode: link === null ? "mechanical" : "manual",
     });
   }

package/scripts/harness/installation/application/usecases/run-doctor-diagnostics.ts

@@ -2,6 +2,7 @@
 // @layer application
 // @work-item-id WI-145
 // @work-item-id WI-178
+// @work-item-id WI-208
 
 import { DiagnosticReport } from "../../domain/diagnostic-report.js";
 import type { CheckId } from "../../domain/check-id.js";
@@ -26,12 +27,20 @@ export interface RunDoctorDiagnosticsInput {
 export interface RunDoctorDiagnosticsOutput {
   readonly report: DiagnosticReport;
   readonly agent: DoctorAgentScope;
+  readonly installationMode: "project" | "personal";
   readonly scopedOutFindings: readonly ScopedOutDiagnosticFinding[];
   readonly exitCode: number;
 }
 
 const CLAUDE_ONLY_CHECKS = new Set<CheckId>(["claude-hook-missing", "claude-skills-symlink"]);
 const CODEX_ONLY_CHECKS = new Set<CheckId>(["codex-hook-missing", "codex-skills-symlink"]);
+const PERSONAL_SCOPED_OUT_CHECKS = new Set<CheckId>([
+  "husky-pre-commit-missing",
+  "husky-commit-msg-missing",
+  "husky-pre-push-missing",
+  "ci-workflow-missing",
+  "package-json-devdep-missing",
+]);
 
 export class RunDoctorDiagnosticsUseCase {
   constructor(
@@ -42,15 +51,20 @@ export class RunDoctorDiagnosticsUseCase {
 
   async execute(input: RunDoctorDiagnosticsInput): Promise<RunDoctorDiagnosticsOutput> {
     const agent = input.agent ?? "both";
-    await this.manifestRepository.load(input.projectRoot).catch(() => null);
+    const manifest = await this.manifestRepository.load(input.projectRoot).catch(() => null);
+    const installationMode = manifest?.findEntry(".phasegate-local/phasegate.config.json") !== null && manifest !== null ? "personal" : "project";
     const rawFindings = (await Promise.all(
       this.checks.map((check) => check.run(input.projectRoot, this.inspector)),
     )).filter((finding) => finding !== null);
-    const { findings, scopedOutFindings } = this.applyAgentScope(rawFindings, agent);
+    const { findings, scopedOutFindings } = this.applyPersonalScope(
+      this.applyAgentScope(rawFindings, agent),
+      installationMode,
+    );
     const report = DiagnosticReport.create(findings);
     return {
       report,
       agent,
+      installationMode,
       scopedOutFindings,
       exitCode: this.decideExitCode(report, input.strict),
     };
@@ -77,6 +91,26 @@ export class RunDoctorDiagnosticsUseCase {
     return { findings: applicable, scopedOutFindings: scopedOut };
   }
 
+  private applyPersonalScope(
+    scoped: { readonly findings: readonly DiagnosticFinding[]; readonly scopedOutFindings: readonly ScopedOutDiagnosticFinding[] },
+    installationMode: "project" | "personal",
+  ): { readonly findings: readonly DiagnosticFinding[]; readonly scopedOutFindings: readonly ScopedOutDiagnosticFinding[] } {
+    if (installationMode !== "personal") return scoped;
+    const applicable: DiagnosticFinding[] = [];
+    const scopedOut: ScopedOutDiagnosticFinding[] = [...scoped.scopedOutFindings];
+    for (const finding of scoped.findings) {
+      if (PERSONAL_SCOPED_OUT_CHECKS.has(finding.checkId)) {
+        scopedOut.push({
+          finding,
+          scopeReason: `${finding.checkId} is a team/project install target and is intentionally out of scope for personal install.`,
+        });
+      } else {
+        applicable.push(finding);
+      }
+    }
+    return { findings: applicable, scopedOutFindings: scopedOut };
+  }
+
   private decideExitCode(report: DiagnosticReport, strict: boolean): number {
     if (report.hasRedFlag()) return 1;
     if (strict && report.hasWarning()) return 1;