phasegate 0.335.0 → 0.340.0

package/scripts/harness/installation/presentation/formatters/diagnostic-report-formatter.ts

@@ -6,7 +6,15 @@
 // @work-item-id WI-180
 // @work-item-id WI-208
 // @work-item-id WI-330
+// @work-item-id WI-384
+// @work-item-id WI-385
 
+import {
+  ANTIGRAVITY_CLI_ONLY_NOTICE,
+  CODEX_HOOK_TRUST_UNVERIFIABLE_NOTICE,
+  GROK_HOOK_TRUST_UNVERIFIABLE_NOTICE,
+  type OperatorNotice,
+} from "../../application/operator-notice.js";
 import type {
   DoctorAgentScope,
   ScopedOutDiagnosticFinding,
@@ -27,6 +35,7 @@ export interface DiagnosticReportFormatterInput {
 
 export class DiagnosticReportFormatter {
   formatJson(input: DiagnosticReportFormatterInput): string {
+    const operatorNotices = noticesFor(input.agent);
     return JSON.stringify(
       {
         schemaVersion: "1.0",
@@ -59,6 +68,7 @@ export class DiagnosticReportFormatter {
             scopeReason,
           };
         }),
+        operatorNotices,
         exitCode: input.exitCode,
       },
       null,
@@ -74,6 +84,9 @@ export class DiagnosticReportFormatter {
       `Config: ${input.configStatus}`,
       "",
     ];
+    for (const notice of noticesFor(input.agent)) {
+      lines.push(`Notice [${notice.code}]: ${notice.message}`, "");
+    }
     for (const finding of input.report.findings) {
       lines.push(`[${finding.severity}] ${finding.checkId}: ${finding.message}`);
       lines.push(`  target: ${finding.target}`);
@@ -107,9 +120,23 @@ function scopeDescription(agent: DoctorAgentScope, installationMode: "project" |
       return "Personal Claude Code sandbox; team/project Husky, CI, package, and Codex-only findings are not repair targets.";
     if (agent === "codex")
       return "Personal Codex sandbox; team/project Husky, CI, package, and Claude-only findings are not repair targets.";
+    if (agent === "grok") return "Personal Grok-compatible hook diagnostics; external trust remains operator-verified.";
+    if (agent === "antigravity") return "Personal Antigravity CLI hook diagnostics; IDE/desktop uses the L2 backstop.";
+    if (agent === "all") return "Personal diagnostics for all supported runtime targets.";
     return "Personal sandbox diagnostics; team/project Husky, CI, and package findings are not repair targets.";
   }
   if (agent === "claude") return "Claude Code and shared setup targets; Codex-only findings are not applicable.";
   if (agent === "codex") return "Codex and shared setup targets; Claude-only findings are not applicable.";
+  if (agent === "grok") return "Grok-compatible Claude hook diagnostics; other runtime findings are not applicable.";
+  if (agent === "antigravity") return "Antigravity CLI hook diagnostics; other runtime findings are not applicable.";
+  if (agent === "all") return "Full setup diagnostics for Claude, Codex, Grok, Antigravity, and shared targets.";
   return "Full setup diagnostics for Claude, Codex, and shared targets.";
 }
+
+function noticesFor(agent: DoctorAgentScope): readonly OperatorNotice[] {
+  return [
+    ...(agent === "codex" || agent === "both" || agent === "all" ? [CODEX_HOOK_TRUST_UNVERIFIABLE_NOTICE] : []),
+    ...(agent === "grok" || agent === "all" ? [GROK_HOOK_TRUST_UNVERIFIABLE_NOTICE] : []),
+    ...(agent === "antigravity" || agent === "all" ? [ANTIGRAVITY_CLI_ONLY_NOTICE] : []),
+  ];
+}

package/scripts/harness/main.ts

@@ -25,6 +25,8 @@
  * @work-item-id WI-300
  * @work-item-id WI-306
  * @work-item-id WI-308
+ * @work-item-id WI-384
+ * @work-item-id WI-385
  *
  * Phasegate CLI エントリポイント。
  * 各Unitの Composition Root からハンドラーを取得し、コマンドに応じてディスパッチする。
@@ -63,6 +65,7 @@ import {
   SkillDeployerManifestBuilder,
 } from "./installation/application/wrappers/skill-deployer-manifest-builder.js";
 import { createInstallationModule } from "./installation/composition-root.js";
+import { type AgentTarget, isAgentTarget } from "./installation/domain/agent-target.js";
 import { NodeCryptoHashAdapter } from "./installation/infrastructure/adapters/node-crypto-hash-adapter.js";
 import { CheckStoryReflectionUseCase } from "./phase-dependency-model/application/usecases/check-story-reflection-usecase.js";
 import { createPhaseDependencyModelModule } from "./phase-dependency-model/composition-root.js";
@@ -207,14 +210,14 @@ Usage: phasegate <command> [options]
 Setup:
   init                         Initialize project: deploy skills + design docs + phasegate.config.json
                                (--name <project-name>, --preset <full|standard|minimal|custom>,
-                                --skills <core|all>, --agent <claude|codex|both>, --workflow <standard|strict>,
+                                --skills <core|all>, --agent <claude|codex|both|grok|antigravity|all>, --workflow <standard|strict>,
                                 --language <language>, --with-husky, --with-ci, --yes)
   update-skills                Alias for reconcile (kept for compatibility)
-  doctor                       Diagnose silent installation failures (--json, --strict, --personal, --agent <claude|codex|both>, --report-out <path>)
+  doctor                       Diagnose silent installation failures (--json, --strict, --personal, --agent <claude|codex|both|grok|antigravity|all>, --report-out <path>)
   scaffold-wi <unit|_cross> <story|issue|fix|refactor|chore>
                                Create docs/inception/{unit}/WI-XXX/description.md
   emit-agent-rules             Print AGENTS.md / CLAUDE.md WI workflow rules block
-  install                      Install phasegate managed files (--dry-run|--apply, --force, --personal, --agent <claude|codex|both>)
+  install                      Install phasegate managed files (--dry-run|--apply, --force, --personal, --agent <claude|codex|both|grok|antigravity|all>)
   uninstall                    Uninstall phasegate managed files (--dry-run|--apply, --force)
   reconcile                    Reconcile phasegate managed files (--dry-run|--apply, --force)
   setup:agent                  Diagnose repo setup and produce/apply an agent-readable setup plan
@@ -271,7 +274,7 @@ Gate semantics:
   ci:auto-refresh-agent-context Refresh AGENTS.md / CLAUDE.md (--dry-run, --apply, --json)
   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)
+  setup:agent                  Plan agent-driven setup (--intent <minimal|recommended|strict|ci-only|agent-hooks|retrofit>, --agent <claude|codex|both|grok|antigravity|all>, --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)
@@ -705,7 +708,7 @@ Options:
   --name <project-name>           Project name (default: "my-project")
   --preset <full|standard|minimal|custom>   Phase dependency preset (default: "standard")
   --skills <core|all>             Skill set to deploy (default: "all")
-  --agent <claude|codex|both>     Agent integration target (default: "claude")
+  --agent <claude|codex|both|grok|antigravity|all>     Agent integration target (default: "claude")
   --workflow <standard|strict>    Workflow enforcement defaults (default: "standard")
   --language <language>           Project language declaration (default: "typescript")
   --with-husky                    Install Husky pre-commit hooks
@@ -731,7 +734,7 @@ Options:
   --dry-run                       Preview target actions without writing (default)
   --apply                         Write merge results and manifest
   --force                         Force ai-assisted/manual targets after backing up existing files
-  --agent <claude|codex|both>     Agent context and hook targets (default: both)
+  --agent <claude|codex|both|grok|antigravity|all>     Agent context and hook targets (default: both)
   --skills <core|all>             Rendered agent context skill mode (default: all)
   --workflow <standard|strict>    Rendered agent context workflow mode (default: standard)
   --with-husky                    Include Husky hook targets (opt-in; omitted by default)
@@ -740,13 +743,24 @@ Options:
                                   With --agent claude, initializes .phasegate-local config/settings/skills and ignored .claude shims.
   --json                          Output machine-readable JSON
   --help, -h                      Show this help`,
+  doctor: `Usage: phasegate doctor [options]
+
+Diagnose silent installation failures for the selected runtime scope.
+
+Options:
+  --json                          Output machine-readable JSON
+  --strict                        Treat warnings as failures
+  --personal                      Diagnose a personal installation
+  --agent <claude|codex|both|grok|antigravity|all>     Diagnostic scope (default: both)
+  --report-out <path>             Write the JSON report to a file
+  --help, -h                      Show this help`,
   "setup:agent": `Usage: phasegate setup:agent [options]
 
 Diagnose repository setup and produce an agent-readable setup plan.
 
 Options:
   --intent <minimal|recommended|strict|ci-only|agent-hooks|retrofit>
-  --agent <claude|codex|both>
+  --agent <claude|codex|both|grok|antigravity|all>
   --workflow <standard|strict>
   --with-husky
   --with-ci
@@ -1075,7 +1089,7 @@ function parseCoverageThreshold(raw: string | undefined): number {
 }
 
 type InitPhasePreset = "full" | "standard" | "minimal" | "custom";
-type AgentTarget = "claude" | "codex" | "both";
+const AGENT_TARGET_USAGE = "claude|codex|both|grok|antigravity|all";
 type SetupIntent = "minimal" | "recommended" | "strict" | "ci-only" | "agent-hooks" | "retrofit";
 type ConfigChangeIntent =
   | "l4-strict"
@@ -1097,7 +1111,7 @@ interface SetupCompletenessEntry {
 }
 
 interface AgentReadinessEntry {
-  readonly agent: "claude" | "codex" | "shared";
+  readonly agent: "claude" | "codex" | "grok" | "antigravity" | "shared";
   readonly status: SetupCompletenessStatus;
   readonly evidence: readonly string[];
   readonly nextAction: string | null;
@@ -1134,14 +1148,9 @@ function parseInitPhasePreset(value: string | undefined): InitPhasePreset | unde
   return undefined;
 }
 
-function parseAgentTarget(value: string | undefined, fallback: AgentTarget = "both"): AgentTarget {
-  if (value === "claude" || value === "codex" || value === "both") return value;
-  return fallback;
-}
-
 function parseRequiredAgentTarget(value: string | undefined, fallback: AgentTarget = "both"): AgentTarget | null {
   if (value === undefined) return fallback;
-  if (value === "claude" || value === "codex" || value === "both") return value;
+  if (isAgentTarget(value)) return value;
   return null;
 }
 
@@ -1234,6 +1243,7 @@ function buildSetupCompleteness(input: {
     readonly phasegateConfig: boolean;
     readonly claudeSettings: boolean;
     readonly codexHooks: boolean;
+    readonly antigravityHooks: boolean;
     readonly agentsMd: boolean;
     readonly claudeMd: boolean;
     readonly huskyPreCommit: boolean;
@@ -1241,12 +1251,19 @@ function buildSetupCompleteness(input: {
     readonly skillsVersion: boolean;
   };
 }): readonly SetupCompletenessEntry[] {
-  const includeClaude = input.agent === "claude" || input.agent === "both";
-  const includeCodex = input.agent === "codex" || input.agent === "both";
+  const includeClaude = input.agent === "claude" || input.agent === "both" || input.agent === "all";
+  const includeCodex = input.agent === "codex" || input.agent === "both" || input.agent === "all";
+  const includeGrok = input.agent === "grok" || input.agent === "all";
+  const includeAntigravity = input.agent === "antigravity" || input.agent === "all";
+  const includeClaudeHook = includeClaude || includeGrok;
+  const includeAgentsContext = includeCodex || includeGrok || includeAntigravity;
   const doctorCommand = doctorValidationCommand(input.agent);
   const agentHooksConfigured =
-    (!includeClaude || input.checks.claudeSettings) && (!includeCodex || input.checks.codexHooks);
-  const agentContextConfigured = (!includeClaude || input.checks.claudeMd) && (!includeCodex || input.checks.agentsMd);
+    (!includeClaudeHook || input.checks.claudeSettings) &&
+    (!includeCodex || input.checks.codexHooks) &&
+    (!includeAntigravity || input.checks.antigravityHooks);
+  const agentContextConfigured =
+    (!includeClaude || input.checks.claudeMd) && (!includeAgentsContext || input.checks.agentsMd);
   const entries: SetupCompletenessEntry[] = [
     setupCompletenessEntry({
       area: "local-config",
@@ -1258,16 +1275,22 @@ function buildSetupCompleteness(input: {
     }),
     setupCompletenessEntry({
       area: "agent-hooks",
-      included: includeClaude || includeCodex,
+      included: includeClaudeHook || includeCodex || includeAntigravity,
       configured: agentHooksConfigured,
       configuredEvidence: "Selected agent hook settings are present.",
       plannedEvidence: "setup:agent will create or refresh selected agent hook settings.",
       nextAction: "Run setup:agent --apply for selected agents.",
-      risk: includeCodex ? "Codex user-level hook feature enablement remains a manual external check." : undefined,
+      risk: includeCodex
+        ? "Codex user-level hook feature enablement remains a manual external check."
+        : includeGrok
+          ? "Grok project-hook trust remains a manual external check."
+          : includeAntigravity
+            ? "Antigravity hard blocking is CLI-only; IDE/desktop relies on L2 pre-commit."
+            : undefined,
     }),
     setupCompletenessEntry({
       area: "agent-context",
-      included: includeClaude || includeCodex,
+      included: includeClaude || includeAgentsContext,
       configured: agentContextConfigured,
       configuredEvidence: "Selected AGENTS.md / CLAUDE.md managed context files are present.",
       plannedEvidence: "setup:agent will create or refresh selected managed agent context sections.",
@@ -1371,6 +1394,7 @@ function buildAgentReadiness(input: {
     readonly phasegateConfig: boolean;
     readonly claudeSettings: boolean;
     readonly codexHooks: boolean;
+    readonly antigravityHooks: boolean;
     readonly agentsMd: boolean;
     readonly claudeMd: boolean;
     readonly huskyPreCommit: boolean;
@@ -1378,8 +1402,10 @@ function buildAgentReadiness(input: {
     readonly skillsVersion: boolean;
   };
 }): readonly AgentReadinessEntry[] {
-  const includeClaude = input.agent === "claude" || input.agent === "both";
-  const includeCodex = input.agent === "codex" || input.agent === "both";
+  const includeClaude = input.agent === "claude" || input.agent === "both" || input.agent === "all";
+  const includeCodex = input.agent === "codex" || input.agent === "both" || input.agent === "all";
+  const includeGrok = input.agent === "grok" || input.agent === "all";
+  const includeAntigravity = input.agent === "antigravity" || input.agent === "all";
   const doctorCommand = doctorValidationCommand(input.agent);
   const sharedConfigured =
     input.checks.packageJson &&
@@ -1423,6 +1449,24 @@ function buildAgentReadiness(input: {
       nextAction: "Run setup:agent --agent codex --apply, then enable hooks at user level if needed.",
       risk: "Codex user-level hook feature enablement remains a manual external check.",
     }),
+    setupReadinessEntry({
+      agent: "grok",
+      included: includeGrok,
+      configured: input.checks.claudeSettings && input.checks.agentsMd,
+      configuredEvidence: [".claude/settings.json and AGENTS.md are present for Grok compatibility."],
+      plannedEvidence: ["setup:agent will deploy the Claude-compatible hook and AGENTS.md without .grok duplication."],
+      nextAction: "Run setup:agent --agent grok --apply, then verify grok inspect and /hooks trust.",
+      risk: "Grok project-hook trust cannot be verified by Phasegate.",
+    }),
+    setupReadinessEntry({
+      agent: "antigravity",
+      included: includeAntigravity,
+      configured: input.checks.antigravityHooks && input.checks.agentsMd,
+      configuredEvidence: [".agents/hooks.json and AGENTS.md are present for Antigravity CLI."],
+      plannedEvidence: ["setup:agent will deploy the Antigravity named hook map and AGENTS.md."],
+      nextAction: "Run setup:agent --agent antigravity --apply, then inspect /hooks in agy.",
+      risk: "IDE/desktop hook execution is not guaranteed; keep the L2 pre-commit backstop.",
+    }),
     setupReadinessEntry({
       agent: "shared",
       included: true,
@@ -1452,14 +1496,17 @@ async function buildAgentSetupPlan(
     phasegateConfig: await projectFileExists(rootDir, "phasegate.config.json"),
     claudeSettings: await projectFileExists(rootDir, ".claude/settings.json"),
     codexHooks: await projectFileExists(rootDir, ".codex/hooks.json"),
+    antigravityHooks: await projectFileExists(rootDir, ".agents/hooks.json"),
     agentsMd: await projectFileExists(rootDir, "AGENTS.md"),
     claudeMd: await projectFileExists(rootDir, "CLAUDE.md"),
     huskyPreCommit: await projectFileExists(rootDir, ".husky/pre-commit"),
     ciWorkflow: await projectFileExists(rootDir, ".github/workflows/phasegate-aidlc-gate.yml"),
     skillsVersion: await projectFileExists(rootDir, "skills/.harness-version"),
   };
-  const includeClaude = input.agent === "claude" || input.agent === "both";
-  const includeCodex = input.agent === "codex" || input.agent === "both";
+  const includeClaude = input.agent === "claude" || input.agent === "both" || input.agent === "all";
+  const includeCodex = input.agent === "codex" || input.agent === "both" || input.agent === "all";
+  const includeGrok = input.agent === "grok" || input.agent === "all";
+  const includeAntigravity = input.agent === "antigravity" || input.agent === "all";
   const changes = [
     !checks.packageJson
       ? "Add phasegate devDependency and phasegate scripts to package.json."
@@ -1469,6 +1516,8 @@ async function buildAgentSetupPlan(
       : "Keep existing phasegate.config.json; review config:plan before changing policy.",
     includeClaude ? "Create or refresh .claude/settings.json and CLAUDE.md managed section." : null,
     includeCodex ? "Create or refresh .codex/hooks.json and AGENTS.md managed section." : null,
+    includeGrok ? "Create or refresh the Claude-compatible hook and AGENTS.md without a .grok hook duplicate." : null,
+    includeAntigravity ? "Create or refresh .agents/hooks.json named hook and AGENTS.md managed section." : null,
     input.withHusky
       ? "Create or refresh Husky pre-commit, commit-msg, and pre-push backstops."
       : "Leave Husky hooks unmanaged in this setup run.",
@@ -2100,8 +2149,8 @@ async function main(): Promise<void> {
         }
         const skillSet: SkillSet = skillSetRaw;
         const agentRaw = parseFlag(args, "--agent") ?? "claude";
-        if (agentRaw !== "claude" && agentRaw !== "codex" && agentRaw !== "both") {
-          console.error(`Invalid --agent value: "${agentRaw}". Use "claude", "codex", or "both".`);
+        if (!isAgentTarget(agentRaw)) {
+          console.error(`Invalid --agent value: "${agentRaw}". Use <${AGENT_TARGET_USAGE}>.`);
           process.exit(2);
         }
         const agent = agentRaw;
@@ -2116,8 +2165,8 @@ async function main(): Promise<void> {
           console.error("Invalid --language value: value must not be empty.");
           process.exit(2);
         }
-        const deployClaude = agent === "claude" || agent === "both";
-        const deployCodex = agent === "codex" || agent === "both";
+        const deployClaude = agent === "claude" || agent === "both" || agent === "grok" || agent === "all";
+        const deployCodex = agent === "codex" || agent === "both" || agent === "all";
         const result = await deploySkills(harnessRoot, rootDir, skillSet);
         const packageResult = await ensurePhasegatePackageDependency(rootDir, result.version);
         const skillLinkResult = await deployAgentSkillLinks(rootDir, {
@@ -2312,11 +2361,15 @@ async function main(): Promise<void> {
           console.log("  3. Edit .claude/scripts/hook-config.json to set target directories");
         }
         if (deployCodex) {
-          console.log(`  ${deployClaude ? "4" : "3"}. Enable Codex hooks: codex features enable hooks`);
+          console.log(
+            `  ${deployClaude ? "4" : "3"}. Use Codex CLI >= 0.124.0, then open /hooks and trust the current hook definition hash`,
+          );
           console.log(
             `  ${deployClaude ? "5" : "4"}. (Recommended) Install pre-commit backstop: rerun with --with-husky or set up husky manually`,
           );
-          console.log(`     See docs/guide/codex-integration.md for the native apply_patch limitation.`);
+          console.log(
+            `     See docs/guide/codex-integration.md for native apply_patch coverage and trust troubleshooting.`,
+          );
         }
         if (skillSet !== "core") {
           console.log("");
@@ -2363,7 +2416,7 @@ async function main(): Promise<void> {
         }
         const agent = parseRequiredAgentTarget(parseFlag(args, "--agent"), "both");
         if (agent === null) {
-          console.error(`Invalid --agent value: "${parseFlag(args, "--agent")}". Use "claude", "codex", or "both".`);
+          console.error(`Invalid --agent value: "${parseFlag(args, "--agent")}". Use <${AGENT_TARGET_USAGE}>.`);
           process.exit(2);
         }
         const mod = createInstallationModule();
@@ -2434,7 +2487,11 @@ async function main(): Promise<void> {
         }
         const apply = hasFlag(args, "--apply");
         const dryRun = hasFlag(args, "--dry-run") || !apply;
-        const agent = parseAgentTarget(parseFlag(args, "--agent"), "both");
+        const agent = parseRequiredAgentTarget(parseFlag(args, "--agent"), "both");
+        if (agent === null) {
+          console.error(`Invalid --agent value: "${parseFlag(args, "--agent")}". Use <${AGENT_TARGET_USAGE}>.`);
+          process.exit(2);
+        }
         const skillSetRaw = parseFlag(args, "--skills") ?? "all";
         if (skillSetRaw !== "core" && skillSetRaw !== "all") {
           console.error(`Invalid --skills value: "${skillSetRaw}". Use "core" or "all".`);
@@ -2445,8 +2502,8 @@ async function main(): Promise<void> {
           console.error(`Invalid --workflow value: "${workflowRaw}". Use "standard" or "strict".`);
           process.exit(2);
         }
-        const includeClaude = agent === "claude" || agent === "both";
-        const includeCodex = agent === "codex" || agent === "both";
+        const includeClaude = agent === "claude" || agent === "both" || agent === "grok" || agent === "all";
+        const includeCodex = agent === "codex" || agent === "both" || agent === "all";
         const personal = hasFlag(args, "--personal");
         const mod = createInstallationModule();
         const phasegateVersion = await getHarnessVersion(harnessRoot);
@@ -2490,7 +2547,11 @@ async function main(): Promise<void> {
           process.exit(2);
         }
         const intent = parseSetupIntent(parseFlag(args, "--intent"));
-        const agent = parseAgentTarget(parseFlag(args, "--agent"), "both");
+        const agent = parseRequiredAgentTarget(parseFlag(args, "--agent"), "both");
+        if (agent === null) {
+          console.error(`Invalid --agent value: "${parseFlag(args, "--agent")}". Use <${AGENT_TARGET_USAGE}>.`);
+          process.exit(2);
+        }
         const workflow = parseWorkflowMode(
           parseFlag(args, "--workflow") ?? (intent === "strict" ? "strict" : "standard"),
         );
@@ -2526,8 +2587,8 @@ async function main(): Promise<void> {
             dryRun: false,
             apply: true,
             force: hasFlag(args, "--force"),
-            includeClaude: agent === "claude" || agent === "both",
-            includeCodex: agent === "codex" || agent === "both",
+            includeClaude: agent === "claude" || agent === "both" || agent === "grok" || agent === "all",
+            includeCodex: agent === "codex" || agent === "both" || agent === "all",
             includeHusky: withHusky,
             includeCi: withCi,
             skillSet: "all",

package/scripts/harness/quick-mode/application/dto/change-category-classification-contract.ts

@@ -11,6 +11,6 @@ export interface ChangeCategoryClassificationContract {
   readonly dominantCategory: string | null;
   readonly perFile: readonly ChangeCategoryPerFile[];
   readonly fullModeRequired: boolean;
-  readonly rejectionRule?: 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
+  readonly rejectionRule?: 'CATEGORY_NOT_ALLOWED' | 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
   readonly rejectionReason?: string;
 }

package/scripts/harness/quick-mode/application/dto/quick-mode-eligibility-contract.ts

@@ -8,6 +8,6 @@
 export interface QuickModeEligibilityContract {
   readonly eligible: boolean;
   readonly reason: string;
-  readonly rejectionRule?: 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
+  readonly rejectionRule?: 'CATEGORY_NOT_ALLOWED' | 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
   readonly rejectedFiles?: readonly { filePath: string; changeKind: string }[];
 }

package/scripts/harness/quick-mode/application/usecases/classify-change-category-usecase.ts

@@ -2,6 +2,7 @@
  * @layer application
  * @unit quick-mode
  * @story H10-05
+ * @work-item-id WI-384
  *
  * paths から変更カテゴリを分類し fullModeRequired 判定と理由を返す UseCase
  */
@@ -20,6 +21,7 @@ export interface ClassifyChangeCategoryUseCaseInput {
   readonly paths: readonly string[];
   readonly targetChanges?: readonly {
     readonly filePath: string;
+    readonly changeKind?: ChangeKind;
     readonly beforeContent?: string | null;
     readonly afterContent?: string | null;
   }[];
@@ -94,7 +96,7 @@ export class ClassifyChangeCategoryUseCase {
           // 変更前の内容が無く変更後の内容がある場合は新規作成 (CREATE) とみなす。
           // 以前は無条件で MODIFY 固定だったため、新規 domain/ ファイルが
           // NEW_DOMAIN 判定を回避して quick mode をすり抜けていた。
-          changeKind: beforeContent === null && afterContent !== null ? "CREATE" : "MODIFY",
+          changeKind: targetChange?.changeKind ?? (beforeContent === null && afterContent !== null ? "CREATE" : "MODIFY"),
           beforeContent,
           afterContent,
         });

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

@@ -5,6 +5,7 @@
  * @work-item-id WI-349
  * @work-item-id WI-352
  * @work-item-id WI-372
+ * @work-item-id WI-390
  *
  * ChangedFile[]をChangeClassificationに変換し、3拒否ルールを評価してQuickModeEligibilityを返すドメインサービス
  */
@@ -92,6 +93,15 @@ function categorizeFileByBuiltInRules(file: ChangedFile): ChangeCategory {
     return ChangeCategory.fromString("test");
   }
 
+  // Markdown は配置場所にかかわらず文書として扱う。config / API / test の
+  // 明示ルールは優先しつつ、domain ディレクトリや CREATE フォールバックより
+  // 前に評価して README.md / *.mdx の新規作成を feature/domain に誤分類しない。
+  // 信頼境界となる root agent instructions は protected-file 側で別途保護する。
+  // @work-item-id WI-390
+  if (filePath.endsWith(".md") || filePath.endsWith(".mdx")) {
+    return ChangeCategory.fromString("docs");
+  }
+
   // domain: domain/ 配下
   if (filePath.includes("/domain/") || filePath.startsWith("domain/")) {
     return ChangeCategory.fromString("domain");
@@ -202,7 +212,7 @@ export class QuickModeJudgmentEngine {
   judge(changedFiles: readonly ChangedFile[], config: QuickModeConfig): QuickModeEligibility {
     const classification = this.classify(changedFiles, config);
 
-    // 1. MIXED_CHANGES評価: allowedCategories 外のカテゴリが含まれる場合
+    // 1. カテゴリ評価: 不許可カテゴリを含む単一カテゴリ変更と、複数カテゴリ変更を区別する。
     if (config.isFullModeRequiredFor("mixedCategories")) {
       const notAllowedFiles: ChangedFile[] = [];
       const notAllowedDescriptions: string[] = [];
@@ -216,8 +226,9 @@ export class QuickModeJudgmentEngine {
       });
 
       if (notAllowedFiles.length > 0) {
+        const rejectionRule = classification.categorizedFiles.size >= 2 ? "MIXED_CHANGES" : "CATEGORY_NOT_ALLOWED";
         return QuickModeEligibility.rejected(
-          "MIXED_CHANGES",
+          rejectionRule,
           notAllowedFiles,
           `allowedCategories外のファイルが含まれています: ${notAllowedDescriptions.join(", ")}`,
         );

package/scripts/harness/quick-mode/domain/types/rejection-rule.ts

@@ -5,4 +5,4 @@
  * Quick Mode拒否ルール識別子
  */
 
-export type RejectionRule = 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';
+export type RejectionRule = 'CATEGORY_NOT_ALLOWED' | 'MIXED_CHANGES' | 'NEW_DOMAIN' | 'API_CONTRACT';

package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts

@@ -1,7 +1,10 @@
 // @layer infrastructure
-import { execSync } from 'node:child_process';
+// @unit regression-suite
+// @work-item-id WI-384
+import { execFileSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
+import { execPath } from 'node:process';
 import { KRequirementTest } from '../../domain/value-objects/k-requirement-test.js';
 import { GngConditionTest } from '../../domain/value-objects/gng-condition-test.js';
 import { AgentIndependenceTest } from '../../domain/value-objects/agent-independence-test.js';
@@ -65,8 +68,15 @@ export class VitestTestRunnerAdapter implements TestRunnerPort {
 
       const testPattern = hasUnitTests ? unitTestDir : unitIntegrationDir;
       try {
-        execSync(
-          `npx tsx node_modules/vitest/vitest.mjs run --config scripts/harness/__tests__/vitest.config.ts "${testPattern}"`,
+        execFileSync(
+          execPath,
+          [
+            'node_modules/vitest/vitest.mjs',
+            'run',
+            '--config',
+            'scripts/harness/__tests__/vitest.config.ts',
+            testPattern,
+          ],
           { cwd: this.rootDir, stdio: 'pipe', timeout: 60_000 },
         );
         unitResults.set(unit, true);

package/templates/.agents/hooks.json

@@ -0,0 +1,16 @@
+{
+  "phasegate-gate": {
+    "PreToolUse": [
+      {
+        "matcher": "^(write_to_file|replace_file_content|multi_replace_file_content|run_command)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx phasegate hook pre-tool-use",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/.claude/scripts/analyze-errors-hook.sh

@@ -96,10 +96,10 @@ if command -v npx >/dev/null 2>&1; then
     fi
 fi
 
-# Biome lint check
+# PhaseGate lint check (uses the target project's PhaseGate/Biome configuration)
 LINT_OUTPUT=""
 if command -v npx >/dev/null 2>&1; then
-    LINT_RAW=$(npx @biomejs/biome lint "$LOCAL_PATH" 2>&1)
+    LINT_RAW=$(npx phasegate lint --json --skip-eslint-removal-check 2>&1)
     if [ $? -ne 0 ] && [ -n "$LINT_RAW" ]; then
         LINT_OUTPUT=$(echo "$LINT_RAW" | head -5)
     fi

package/templates/.claude/settings.json

@@ -2,7 +2,7 @@
   "hooks": {
     "PreToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": "Bash|apply_patch",
         "hooks": [
           {
             "type": "command",
@@ -10,7 +10,8 @@
           },
           {
             "type": "command",
-            "command": "npx phasegate hook pre-tool-use"
+            "command": "npx phasegate hook pre-tool-use",
+            "timeout": 30
           }
         ]
       },
@@ -19,7 +20,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx phasegate hook pre-tool-use"
+            "command": "npx phasegate hook pre-tool-use",
+            "timeout": 30
           }
         ]
       }

package/templates/.codex/hooks.json

@@ -25,7 +25,7 @@
     ],
     "PreToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": "Bash|apply_patch",
         "hooks": [
           {
             "type": "command",
@@ -37,7 +37,7 @@
     ],
     "PostToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": "Bash|apply_patch",
         "hooks": [
           {
             "type": "command",