phasegate 0.160.9 → 0.160.11

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.160.11] - 2026-05-17
+
+### Fixed
+
+- **WI-202 / WI-204 — Quick Mode strict recovery** — aligns strict init Quick Mode categories with quick-implementor scope, adds `config:plan --intent quick-mode-relax` for managed `allowedCategories` recovery, updates config edit block guidance to the matching recovery intent, and excludes CWD-external runtime paths from project-local hook policy.
+
+## [0.160.10] - 2026-05-16
+
+### Fixed
+
+- **WI-203 — Stop hook Complete Check execution** — resolves built-in `phasegate:*` hook commands through the packaged CLI entrypoint instead of unmanaged downstream wrapper files, distinguishes Complete Check validation failures from command wiring failures in strict Stop hook output, and documents that `scripts/harness/cli/complete-check.ts` is not required by standard install/reconcile.
+
 ## [0.160.9] - 2026-05-15
 
 ### Fixed

package/docs/guide/cli-reference.md

@@ -28,7 +28,7 @@ Command names in this document are split into three surfaces:
 | `uninstall --dry-run` / `--apply` | Remove PhaseGate-managed files and managed blocks using `.phasegate/manifest.json`; `--force` handles managed conflict cases. |
 | `reconcile --dry-run` / `--apply` | Update PhaseGate-managed files to current package templates and refresh manifest hashes; `--force` allows managed-file replacement with backup. |
 | `setup:agent` | Agent-readable setup planner and optional apply path. Options: `--intent <minimal\|recommended\|strict\|ci-only\|agent-hooks\|retrofit>`, `--agent <claude\|codex\|both>`, `--workflow <standard\|strict>`, `--with-husky`, `--with-ci`, `--dry-run`, `--apply`, `--json`. <!-- @work-item-id WI-172 --> |
-| `config:plan` | Agent-readable configuration change planner. Options: `--intent <l4-strict\|codex-hooks\|ci-fail-on-warning\|baseline-reset\|quick-mode-strict\|retrofit-bootstrap\|planning-mode-relax>`, `--dry-run`, `--apply`, `--json`. <!-- @work-item-id WI-173 --> <!-- @work-item-id WI-201 --> |
+| `config:plan` | Agent-readable configuration change planner. Options: `--intent <l4-strict\|codex-hooks\|ci-fail-on-warning\|baseline-reset\|quick-mode-strict\|quick-mode-relax\|retrofit-bootstrap\|planning-mode-relax>`, `--dry-run`, `--apply`, `--json`. <!-- @work-item-id WI-173 --> <!-- @work-item-id WI-201 --> <!-- @work-item-id WI-204 --> |
 | `update-skills` | Compatibility alias for `reconcile`; use `reconcile` for new automation. |
 | `scaffold-wi <unit> <type>` | Create `docs/inception/{unit}/WI-XXX/description.md` using the next free WI number. |
 | `emit-agent-rules` | Print the AGENTS.md / CLAUDE.md WI workflow rules block. |

package/docs/guide/configuration.md

@@ -13,9 +13,10 @@ For agent-assisted changes, preview the intent before editing the config:
 ```bash
 npx phasegate config:plan --intent l4-strict --dry-run --json
 npx phasegate config:plan --intent quick-mode-strict --dry-run --json
+npx phasegate config:plan --intent quick-mode-relax --dry-run --json
 ```
 
-The plan identifies target fields, managed artifacts, commands, validation, risks, and rollback so an agent can explain the change before applying it. <!-- @work-item-id WI-173 -->
+The plan identifies target fields, managed artifacts, commands, validation, risks, and rollback so an agent can explain the change before applying it. Use `quick-mode-relax` to restore the supported Quick Mode category set after an over-narrowed strict configuration. <!-- @work-item-id WI-173 --> <!-- @work-item-id WI-204 -->
 
 ### Full Reference
 
@@ -548,12 +549,14 @@ Controls how phasegate's agent-side hooks integrate with Claude Code. Currently
 
 | Sub-field          | Type      | Default | Description                                                                                                          |
 |--------------------|-----------|---------|----------------------------------------------------------------------------------------------------------------------|
-| `stopHook.enforce` | `boolean` | `false` | When `true`, a non-zero exit from `phasegate:complete-check` causes the Stop hook to emit `{"decision":"block","reason":"Complete Check failed (exitCode=N)"}` on stdout and exit with code 2, blocking Claude Code's turn. When `false` (default), the hook exits with the inner CLI's exit code, which Claude Code surfaces only as a transcript warning. |
+| `stopHook.enforce` | `boolean` | `false` | When `true`, a non-zero exit from `phasegate:complete-check` causes the Stop hook to emit `{"decision":"block","reason":"Complete Check failed (exitCode=N)"}` on stdout and exit with code 2, blocking Claude Code's turn. If command invocation itself fails, the reason is `Complete Check execution failed (exitCode=N)`. When `false` (default), the hook exits with the inner CLI's exit code, which Claude Code surfaces only as a transcript warning. |
 
 Use `enforce: true` when your team treats Complete Check failures as hard gates (e.g., disallow ending a session with failing tests or lint). Leave it as default `false` for an opt-in / advisory experience.
 
 Reentry-detection cases (`REENTRY_DETECTED`) always exit with code 0 regardless of this setting; strict mode applies only to actual Complete Check failures.
 
+The built-in Stop hook invokes the packaged PhaseGate CLI command directly; projects initialized or reconciled by PhaseGate do not need a local `scripts/harness/cli/complete-check.ts` wrapper for this setting. <!-- @work-item-id WI-203 -->
+
 ---
 
 ### Quick Mode

package/docs/guide/hooks-integration.md

@@ -93,8 +93,9 @@ Use /quick-implementor skill for version changes in package.json.
 
 ### Stop (before session end)
 - Runs `phasegate:complete-check` (L2-L4 full validation)
+- The built-in Stop hook runs the packaged PhaseGate CLI command; downstream projects do not need to provide `scripts/harness/cli/complete-check.ts`.
 - By default, the hook exits with the inner CLI's exit code, which Claude Code shows as a transcript warning but does not turn-block on.
-- Set `agentIntegration.stopHook.enforce: true` in `phasegate.config.json` to enable **strict mode**: on Complete Check failure, the hook emits `{"decision":"block","reason":"Complete Check failed (exitCode=N)"}` on stdout and exits with code 2, hard-blocking Claude Code's turn end. Reentry-detection still exits 0 regardless of this setting. See `docs/guide/configuration.md` `agentIntegration` section for details.
+- Set `agentIntegration.stopHook.enforce: true` in `phasegate.config.json` to enable **strict mode**: on Complete Check failure, the hook emits `{"decision":"block","reason":"Complete Check failed (exitCode=N)"}` on stdout and exits with code 2, hard-blocking Claude Code's turn end. If the command cannot be invoked at all, strict mode reports `Complete Check execution failed (exitCode=N)` instead. Reentry-detection still exits 0 regardless of this setting. See `docs/guide/configuration.md` `agentIntegration` section for details. <!-- @work-item-id WI-203 -->
 
 ## Git hook metadata validation
 

package/docs/guide/recipes.md

@@ -58,8 +58,9 @@ Only enable fail-on-warning after reviewing the drift, consistency, dead-code, p
 
 ```bash
 npx phasegate config:plan --intent quick-mode-strict --dry-run --json
+npx phasegate config:plan --intent quick-mode-relax --dry-run --json
 npx phasegate check-change-category --paths <changed-files> --format json
 npx phasegate ci-check --quick --dry-run
 ```
 
-Use `config:plan` before changing `phasegate.config.json`. It separates repo-managed artifacts from user-level settings, previews the local config before/after for config-backed intents, and lists the checks needed after the change. <!-- @work-item-id WI-175 -->
+Use `config:plan` before changing `phasegate.config.json`. It separates repo-managed artifacts from user-level settings, previews the local config before/after for config-backed intents, and lists the checks needed after the change. `quick-mode-relax` is the managed recovery path when strict category narrowing blocks docs/test/config changes. <!-- @work-item-id WI-175 --> <!-- @work-item-id WI-204 -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.9",
+  "version": "0.160.11",
   "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/dto/handle-pre-tool-use-dto.ts

@@ -6,6 +6,7 @@
 export interface HandlePreToolUseInput {
   toolName: string;
   targetFilePaths: string[];
+  callerSkill?: string;
   targetChanges?: {
     filePath: string;
     beforeContent?: string | null;

package/scripts/harness/agent-integration/application/usecases/handle-pre-tool-use-usecase.ts

@@ -160,6 +160,7 @@ export class HandlePreToolUseUseCase {
               fullModeResult,
               guidance,
               unitIdForGuidance,
+              input.callerSkill,
             );
           }
         } else {
@@ -236,11 +237,12 @@ export class HandlePreToolUseUseCase {
     },
     guidance: ErrorGuidance | null,
     unitId: string | undefined,
+    callerSkill?: string,
   ): HandlePreToolUseOutput {
     const fp = blockedFilePath ?? "不明なファイル";
     if (result.dominantCategory === "config" && /(?:^|\/)phasegate\.config\.json$/.test(fp)) {
-      const dryRunCommand = "phasegate config:plan --intent retrofit-bootstrap --dry-run --json";
-      const applyCommand = "phasegate config:plan --intent retrofit-bootstrap --apply --json";
+      const dryRunCommand = "phasegate config:plan --intent quick-mode-relax --dry-run --json";
+      const applyCommand = "phasegate config:plan --intent quick-mode-relax --apply --json";
       const lines = [
         `Full mode 必須変更が検出されました: ${fp}`,
         "カテゴリ: config",
@@ -263,6 +265,33 @@ export class HandlePreToolUseUseCase {
         nextAction: `${dryRunCommand} && ${applyCommand}`,
       };
     }
+    if (
+      callerSkill === "quick-implementor" &&
+      result.dominantCategory !== undefined &&
+      ["bugfix", "docs", "test", "config"].includes(result.dominantCategory)
+    ) {
+      const dryRunCommand = "phasegate config:plan --intent quick-mode-relax --dry-run --json";
+      const applyCommand = "phasegate config:plan --intent quick-mode-relax --apply --json";
+      const lines: string[] = [`Full mode 必須変更が検出されました: ${fp}`];
+      lines.push(`カテゴリ: ${result.dominantCategory}`);
+      if (result.rejectionRule) {
+        lines.push(`判定ルール: ${result.rejectionRule}`);
+      }
+      if (result.rejectionReason) {
+        lines.push(`理由: ${result.rejectionReason}`);
+      }
+      lines.push(`次のアクション: Quick Mode の許可カテゴリを確認してください。緩和する場合は ${dryRunCommand} で差分を確認し、承認後に ${applyCommand} を実行してください。`);
+
+      return {
+        shouldBlock: true,
+        blockedFilePath,
+        blockReason: "FULL_MODE_REQUIRED",
+        error: { message: lines.join("\n") },
+        fullModeRejectionRule: result.rejectionRule,
+        fullModeDominantCategory: result.dominantCategory,
+        nextAction: `${dryRunCommand} && ${applyCommand}`,
+      };
+    }
     const lines: string[] = [`Full mode 必須変更が検出されました: ${fp}`];
     if (result.dominantCategory) {
       lines.push(`カテゴリ: ${result.dominantCategory}`);
@@ -402,7 +431,7 @@ export class HandlePreToolUseUseCase {
     {
       pattern: /(?:^|\/)phasegate\.config\.json$/,
       message: (fp) =>
-        `保護ファイルへの書き込みがブロックされました: ${fp}\n設定変更は CLI 経由で計画・適用してください: phasegate config:plan --intent retrofit-bootstrap --dry-run --json / phasegate config:plan --intent retrofit-bootstrap --apply --json`,
+        `保護ファイルへの書き込みがブロックされました: ${fp}\nQuick Mode 設定の復旧は CLI 経由で計画・適用してください: phasegate config:plan --intent quick-mode-relax --dry-run --json / phasegate config:plan --intent quick-mode-relax --apply --json`,
     },
     {
       pattern: /(?:^|\/)harness\.config\.json$/,

package/scripts/harness/agent-integration/infrastructure/adapters/child-process-cli-executor-adapter.ts

@@ -1,22 +1,36 @@
 /**
  * @layer infrastructure
  * @unit agent-integration
+ * @work-item-id WI-203
  *
  * ChildProcessCliExecutorAdapter
  * CliExecutorPort の実装。子プロセスで CLI コマンドを実行する
  */
 
 import { spawn } from 'node:child_process';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import type { CliExecutorPort, CliExecutionResult } from '../../application/ports/cli-executor-port.js';
 import { TimeoutError } from '../../application/ports/cli-executor-port.js';
 
+function getHarnessMainPath(): string {
+  return resolve(dirname(fileURLToPath(import.meta.url)), '../../../main.ts');
+}
+
 /**
  * CommandName を実行可能なコマンドに変換する
- * 例: 'phasegate:lint' → ['npx', 'tsx', 'scripts/harness/cli/lint.ts']
+ * 例: 'phasegate:lint' → ['npx', 'tsx', '<package>/scripts/harness/main.ts', 'phasegate:lint']
  * テスト時は直接スクリプトパスで execute を呼ぶことも可能
  */
 function resolveCommand(commandName: string): { cmd: string; args: string[] } {
-  // コマンド名をファイルパスに変換
+  if (commandName.startsWith('phasegate:')) {
+    return {
+      cmd: 'npx',
+      args: ['tsx', getHarnessMainPath(), commandName],
+    };
+  }
+
+  // Legacy extension commands may still be provided as project-local wrappers.
   const slug = commandName.replace('phasegate:', '');
   return {
     cmd: 'npx',

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

@@ -22,6 +22,7 @@ import * as fs from 'node:fs/promises';
 interface PreToolUseHookInput {
   cwd?: string;
   tool_name?: string;
+  caller_skill?: string;
   tool_input?: {
     path?: string;
     file_path?: string;
@@ -50,8 +51,8 @@ async function readStdin(): Promise<string> {
   return Buffer.concat(chunks).toString('utf8');
 }
 
-async function findConfigPath(): Promise<string> {
-  let dir = process.cwd();
+async function findConfigPath(startDir: string): Promise<string> {
+  let dir = startDir;
   while (true) {
     const candidate = path.join(dir, 'phasegate.config.json');
     try {
@@ -63,7 +64,11 @@ async function findConfigPath(): Promise<string> {
       dir = parent;
     }
   }
-  return path.join(process.cwd(), 'phasegate.config.json');
+  return path.join(startDir, 'phasegate.config.json');
+}
+
+function isProjectExternalAbsolutePath(filePath: string): boolean {
+  return path.isAbsolute(filePath);
 }
 
 async function main(): Promise<void> {
@@ -89,7 +94,7 @@ async function main(): Promise<void> {
     process.exit(2);
   }
 
-  const cwd = input.cwd ?? process.cwd();
+  const cwd = path.resolve(input.cwd ?? process.cwd());
   const toRelative = (p: string): string => {
     if (path.isAbsolute(p)) {
       const rel = path.relative(cwd, p);
@@ -128,7 +133,9 @@ async function main(): Promise<void> {
   }
 
   try {
-    const configPath = await findConfigPath();
+    const configPath = await findConfigPath(cwd);
+    const projectTargetFilePaths = targetFilePaths.filter((filePath) => !isProjectExternalAbsolutePath(filePath));
+    const projectTargetChanges = targetChanges.filter((change) => !isProjectExternalAbsolutePath(change.filePath));
     const configQueryPort = new HarnessConfigConfigQueryAdapter(configPath);
     const phaseGateQueryPort = new PhaseGateQueryAdapter();
     const storyReflectionQueryPort = new FileSystemStoryReflectionQueryAdapter({
@@ -154,7 +161,13 @@ async function main(): Promise<void> {
       errorGuidanceQueryPort,
     });
 
-    const output = await useCase.execute({ toolName: effectiveToolName, targetFilePaths, targetChanges });
+    const callerSkill = input.caller_skill ?? process.env.PHASEGATE_CALLER_SKILL;
+    const output = await useCase.execute({
+      toolName: effectiveToolName,
+      targetFilePaths: projectTargetFilePaths,
+      callerSkill,
+      targetChanges: projectTargetChanges,
+    });
 
     if (output.shouldBlock) {
       const msg = output.error?.message

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

@@ -1,6 +1,7 @@
 /**
  * @layer presentation
  * @unit agent-integration
+ * @work-item-id WI-203
  *
  * Stop Hook Adapter
  * Claude Code の Stop Hook エントリポイント
@@ -19,6 +20,20 @@ interface StopHookInput {
   session_id?: string;
 }
 
+function isCompleteCheckExecutionWiringFailure(stderr: string): boolean {
+  return (
+    /scripts\/harness\/cli\/complete-check\.ts/.test(stderr) ||
+    /ERR_MODULE_NOT_FOUND|Cannot find module/i.test(stderr)
+  );
+}
+
+function formatCompleteCheckFailureReason(exitCode: number, stderr: string): string {
+  if (isCompleteCheckExecutionWiringFailure(stderr)) {
+    return `Complete Check execution failed (exitCode=${exitCode})`;
+  }
+  return `Complete Check failed (exitCode=${exitCode})`;
+}
+
 async function readStdin(): Promise<string> {
   const chunks: Buffer[] = [];
   for await (const chunk of process.stdin) {
@@ -97,10 +112,10 @@ async function main(): Promise<void> {
       if (output.cliResult.exitCode !== 0) {
         // WI-087 finding #4: enforce=true なら exit 2 + decision JSON で turn block
         if (output.shouldEnforceFailure === true) {
-          const reason = `Complete Check failed (exitCode=${output.cliResult.exitCode})`;
+          const reason = formatCompleteCheckFailureReason(output.cliResult.exitCode, output.cliResult.stderr);
           process.stdout.write(`${JSON.stringify({ decision: 'block', reason })}\n`);
           process.stderr.write(
-            `Complete Check失敗 (exitCode=${output.cliResult.exitCode}) — strict mode により turn を block します\n`,
+            `${reason} — strict mode により turn を block します\n`,
           );
           process.exit(2);
         }

package/scripts/harness/main.ts

@@ -219,7 +219,7 @@ Gate semantics:
   refresh-claude-md            Refresh CLAUDE.md standard sections (--dry-run, --apply, --json)
   p2:check-agent-context       Check AGENTS.md / CLAUDE.md freshness (--threshold-days <n>, --json)
   setup:agent                  Plan agent-driven setup (--intent <minimal|recommended|strict|ci-only|agent-hooks|retrofit>, --agent <claude|codex|both>, --dry-run|--apply, --json)
-  config:plan                  Plan safe config changes (--intent <l4-strict|codex-hooks|ci-fail-on-warning|baseline-reset|quick-mode-strict|retrofit-bootstrap|planning-mode-relax>, --dry-run|--apply, --json)
+  config:plan                  Plan safe config changes (--intent <l4-strict|codex-hooks|ci-fail-on-warning|baseline-reset|quick-mode-strict|quick-mode-relax|retrofit-bootstrap|planning-mode-relax>, --dry-run|--apply, --json)
   ci:check-repetition          Check error repetition (--code <errorCode>, --reset, --json)
   baseline                     Create retrofit baseline snapshot (--dry-run, --force, --paths <glob,glob,...>, --json)
   scaffold-design              Scaffold a design doc (--unit <id>, --phase <logical|domain|uiux|unit-test|it-test>, --dry-run|--apply, --force, --json)
@@ -536,7 +536,7 @@ Options:
 Produce an agent-readable configuration change plan.
 
 Intents:
-  l4-strict, codex-hooks, ci-fail-on-warning, baseline-reset, quick-mode-strict, retrofit-bootstrap, planning-mode-relax
+  l4-strict, codex-hooks, ci-fail-on-warning, baseline-reset, quick-mode-strict, quick-mode-relax, retrofit-bootstrap, planning-mode-relax
 
 Options:
   --dry-run
@@ -779,7 +779,7 @@ function parseCoverageThreshold(raw: string | undefined): number {
 type InitPhasePreset = "full" | "standard" | "minimal" | "custom";
 type AgentTarget = "claude" | "codex" | "both";
 type SetupIntent = "minimal" | "recommended" | "strict" | "ci-only" | "agent-hooks" | "retrofit";
-type ConfigChangeIntent = "l4-strict" | "codex-hooks" | "ci-fail-on-warning" | "baseline-reset" | "quick-mode-strict" | "retrofit-bootstrap" | "planning-mode-relax";
+type ConfigChangeIntent = "l4-strict" | "codex-hooks" | "ci-fail-on-warning" | "baseline-reset" | "quick-mode-strict" | "quick-mode-relax" | "retrofit-bootstrap" | "planning-mode-relax";
 type SetupCompletenessStatus = "configured" | "planned" | "manual" | "not-applicable" | "unknown";
 
 interface SetupCompletenessEntry {
@@ -864,6 +864,7 @@ function parseConfigChangeIntent(value: string | undefined): ConfigChangeIntent
     value === "ci-fail-on-warning" ||
     value === "baseline-reset" ||
     value === "quick-mode-strict" ||
+    value === "quick-mode-relax" ||
     value === "retrofit-bootstrap" ||
     value === "planning-mode-relax"
   ) {
@@ -1229,9 +1230,12 @@ function buildConfigPatchPreview(intent: ConfigChangeIntent, before: unknown | n
       { pointer: "/layers/L4/failOnWarning", path: ["layers", "L4", "failOnWarning"], value: true },
     ],
     "quick-mode-strict": [
-      { pointer: "/quickMode/allowedCategories", path: ["quickMode", "allowedCategories"], value: ["chore"] },
+      { pointer: "/quickMode/allowedCategories", path: ["quickMode", "allowedCategories"], value: ["bugfix"] },
       { pointer: "/quickMode/relaxedGates", path: ["quickMode", "relaxedGates"], value: [] },
     ],
+    "quick-mode-relax": [
+      { pointer: "/quickMode/allowedCategories", path: ["quickMode", "allowedCategories"], value: ["bugfix", "docs", "test", "config"] },
+    ],
     "codex-hooks": [],
     "baseline-reset": [],
     "retrofit-bootstrap": [
@@ -1363,6 +1367,14 @@ async function buildConfigChangePlan(rootDir: string, intent: ConfigChangeIntent
       validations: ["phasegate ci-check --quick --dry-run", "phasegate phasegate:check-ready"],
       risks: ["More changes will require Full Mode validation before commit."],
     },
+    "quick-mode-relax": {
+      targets: ["phasegate.config.json: quickMode.allowedCategories"],
+      managedTargets: ["phasegate.config.json"],
+      externalActions: [],
+      commands: ["phasegate config:plan --intent quick-mode-relax --json", "phasegate config:plan --intent quick-mode-relax --apply --json", "phasegate check-change-category --paths <changed-files> --format json"],
+      validations: ["phasegate ci-check --quick --dry-run", "phasegate phasegate:check-ready"],
+      risks: ["Small bugfix/docs/test/config changes can proceed through Quick Mode again; protected files remain governed by hook and managed command policies."],
+    },
     "retrofit-bootstrap": {
       targets: ["phasegate.config.json: planningMode.default", "phasegate.config.json: phaseDependencies.override", "phasegate.config.json: quickMode.relaxedGates"],
       managedTargets: ["phasegate.config.json"],
@@ -1722,7 +1734,7 @@ async function main(): Promise<void> {
         if (configResult.created) {
           console.log(`✓ phasegate.config.json created`);
           if (workflow === "strict") {
-            console.log(`✓ strict workflow configured (quickMode.relaxedGates: [], allowedCategories: ["chore"])`);
+            console.log(`✓ strict workflow configured (quickMode.relaxedGates: [], allowedCategories: ["bugfix","docs","test","config"])`);
           }
         } else {
           console.log(`  phasegate.config.json already exists, skipped`);

package/scripts/harness/quick-mode/domain/services/quick-mode-judgment-engine.ts

@@ -26,6 +26,16 @@ const RISK_PRIORITY: Record<string, number> = {
 function categorizeFile(file: ChangedFile): ChangeCategory {
   const { filePath, changeKind } = file;
 
+  // Config files must stay config even when Edit payload snippets look like
+  // comment/whitespace-only diffs. Config recovery guidance depends on this.
+  if (
+    filePath.endsWith('.config.json') ||
+    filePath.endsWith('.config.ts') ||
+    filePath.endsWith('phasegate.config.json')
+  ) {
+    return ChangeCategory.fromString('config');
+  }
+
   if (isCommentOnlyDiff(file)) {
     return ChangeCategory.fromString('docs');
   }
@@ -54,15 +64,6 @@ function categorizeFile(file: ChangedFile): ChangeCategory {
     return ChangeCategory.fromString('docs');
   }
 
-  // config: *.config.json / *.config.ts / phasegate.config.json
-  if (
-    filePath.endsWith('.config.json') ||
-    filePath.endsWith('.config.ts') ||
-    filePath.endsWith('phasegate.config.json')
-  ) {
-    return ChangeCategory.fromString('config');
-  }
-
   // feature: domain/ 以外の CREATE
   if (changeKind === 'CREATE') {
     return ChangeCategory.fromString('feature');

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

@@ -481,7 +481,7 @@ export async function initHarnessConfig(
     layers: {},
     quickMode: strictWorkflow
       ? {
-          allowedCategories: ["chore"],
+          allowedCategories: ["bugfix", "docs", "test", "config"],
           relaxedGates: [],
         }
       : {},

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

@@ -13,7 +13,7 @@ phasegate を導入した直後の config は単純な default で、実プロ
 
 ## 設計原則
 
-1. **silent 書き換え禁止** — 提案は diff として提示し、`AskUserQuestion` で承認を取ってから Edit
+1. **silent 書き換え禁止** — 提案は diff として提示し、`AskUserQuestion` で承認を取ってから適用する。`config:plan` で表現できる変更は managed command を優先し、直接 `Edit` は hook が許可する範囲に限定する
 2. **検出結果を優先** — 機械的に決定可能な部分 (workspace 構造、formatter、bash 互換性) は AI 推論ではなく検出結果を採用
 3. **AI 推論は判断要素のみ** — architecture preset 選定、relaxedGates 推奨値などは AI が判断するが根拠を必ず示す
 4. **schema は enum 違反確認時のみ Read** — 日常診断は本 SKILL 内の判定基準で十分。schema 全文 Read は値域不明時に限定する
@@ -200,7 +200,14 @@ options:
   - label: "適用しない (情報のみ受け取る)"
 ```
 
-ユーザーが適用対象を確定したら `Edit` で `phasegate.config.json` を変更。
+ユーザーが適用対象を確定したら、対応する managed intent がある場合は `config:plan` で適用する。
+
+```bash
+npx phasegate config:plan --intent quick-mode-relax --dry-run --json
+npx phasegate config:plan --intent quick-mode-relax --apply --json
+```
+
+managed intent がない個別提案のみ、hook が `config` category を許可していることを確認したうえで `Edit` で `phasegate.config.json` を変更する。
 
 **変更後の検証**: