phasegate 0.160.4 → 0.160.6

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.160.6] - 2026-05-14
+
+### Fixed
+
+- **WI-190..WI-196 — post-0.160.5 dogfood regressions** — aligns agent context refresh with reconcile rendering, adds retrofit planning-mode config plans, makes cascade update dry-runs non-mutating and explicit, fixes doctor `_shared` drift counts, removes pnpm-only scheduled CI templates, exposes `migrate work-items` help, and accepts positional `delegate-sonnet` prompts.
+
+## [0.160.5] - 2026-05-14
+
+### Fixed
+
+- **WI-189 — umbrella CLI UX cleanup** — aligns `validate --format json` with the global JSON contract, makes `scaffold-design` default to dry-run with explicit `--apply`, fixes bypass audit empty-range wording, and synchronizes public help for scaffold, quick-mode, and delegate commands.
+
 ## [0.160.4] - 2026-05-14
 
 ### Fixed

package/docs/templates/ci/agent-context-refresh.yml

@@ -1,4 +1,5 @@
 # Phasegate — Agent context refresh workflow
+# @work-item-id WI-194
 #
 # 使い方:
 #   このファイルを .github/workflows/agent-context-refresh.yml にコピーして使用する。
@@ -32,18 +33,21 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          cache: 'pnpm'
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
 
       - name: Install dependencies
-        run: pnpm install --frozen-lockfile
+        run: |
+          if [ -f pnpm-lock.yaml ]; then
+            pnpm install --frozen-lockfile
+          elif [ -f yarn.lock ]; then
+            yarn install --immutable || yarn install --frozen-lockfile
+          elif [ -f package-lock.json ] || [ -f npm-shrinkwrap.json ]; then
+            npm ci
+          else
+            npm install
+          fi
 
       - name: Refresh agent context
-        run: pnpm run harness ci:auto-refresh-agent-context --apply
+        run: npx phasegate ci:auto-refresh-agent-context --apply
 
       - name: Create pull request
         uses: peter-evans/create-pull-request@v6

package/docs/templates/ci/consistency-check.yml

@@ -1,4 +1,5 @@
 # Phasegate — 週次整合性チェックワークフロー
+# @work-item-id WI-194
 #
 # 使い方:
 #   このファイルを .github/workflows/consistency-check.yml にコピーして使用する。
@@ -31,15 +32,18 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: '20'
-          cache: 'pnpm'
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
 
       - name: Install dependencies
-        run: pnpm install --frozen-lockfile
+        run: |
+          if [ -f pnpm-lock.yaml ]; then
+            pnpm install --frozen-lockfile
+          elif [ -f yarn.lock ]; then
+            yarn install --immutable || yarn install --frozen-lockfile
+          elif [ -f package-lock.json ] || [ -f npm-shrinkwrap.json ]; then
+            npm ci
+          else
+            npm install
+          fi
 
       # L4-001: Drift Detection（設計⇔コード双方向乖離）
       - name: L4 Drift Detection

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.4",
+  "version": "0.160.6",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/scripts/delegate-sonnet.sh

@@ -4,11 +4,12 @@
 # Usage:
 #   bash scripts/delegate-sonnet.sh --prompt "プロンプト" --output "出力パス"
 #   bash scripts/delegate-sonnet.sh --prompt-file /tmp/prompt.md --output "出力パス"
+#   bash scripts/delegate-sonnet.sh "プロンプト" --output "出力パス"
 #
 # Options:
 #   --prompt        委任プロンプト（直接指定、2000文字以下推奨）
 #   --prompt-file   委任プロンプトファイル（長文の場合）
-#   --output        出力ファイルパス
+#   --output        出力ファイルパス（省略時: .phasegate/delegate-sonnet-output.md）
 #   --max-turns     最大ターン数（デフォルト: 30）
 #   --dry-run       プロンプトを表示するだけで実行しない
 
@@ -20,6 +21,7 @@ PROMPT_FILE=""
 OUTPUT_PATH=""
 MAX_TURNS=30
 DRY_RUN=false
+POSITIONAL_ARGS=()
 
 while [[ $# -gt 0 ]]; do
   case $1 in
@@ -43,23 +45,35 @@ while [[ $# -gt 0 ]]; do
       DRY_RUN=true
       shift
       ;;
+    --)
+      shift
+      if [[ $# -gt 0 ]]; then
+        POSITIONAL_ARGS+=("$@")
+      fi
+      break
+      ;;
     *)
-      echo "Unknown option: $1" >&2
-      exit 1
+      if [[ "$1" == --* ]]; then
+        echo "Unknown option: $1" >&2
+        exit 1
+      fi
+      POSITIONAL_ARGS+=("$1")
+      shift
       ;;
   esac
 done
 
+if [[ -z "$PROMPT" && ${#POSITIONAL_ARGS[@]} -gt 0 ]]; then
+  PROMPT="${POSITIONAL_ARGS[*]}"
+fi
+
 # --- バリデーション ---
 if [[ -z "$PROMPT" && -z "$PROMPT_FILE" ]]; then
   echo "Error: --prompt or --prompt-file is required" >&2
   exit 1
 fi
 
-if [[ -z "$OUTPUT_PATH" ]]; then
-  echo "Error: --output is required" >&2
-  exit 1
-fi
+OUTPUT_PATH="${OUTPUT_PATH:-.phasegate/delegate-sonnet-output.md}"
 
 if [[ -n "$PROMPT_FILE" && ! -f "$PROMPT_FILE" ]]; then
   echo "Error: Prompt file not found: $PROMPT_FILE" >&2

package/scripts/harness/ci-governance/application/dto/scaffold-design-input.ts

@@ -1,8 +1,10 @@
 // @unit ci-governance
 // @layer application
+// @work-item-id WI-189
 
 export interface ScaffoldDesignInput {
   readonly unit: string;
   readonly phase: string;
+  readonly dryRun?: boolean;
   readonly force?: boolean;
 }

package/scripts/harness/ci-governance/application/dto/scaffold-design-output.ts

@@ -1,11 +1,13 @@
 // @unit ci-governance
 // @layer application
+// @work-item-id WI-189
 
 export interface ScaffoldDesignOutput {
   readonly targetPath: string;
   readonly templatePath: string;
   readonly unit: string;
   readonly phase: string;
+  readonly dryRun: boolean;
   readonly written: boolean;
   readonly alreadyExists: boolean;
   readonly overwritten: boolean;

package/scripts/harness/ci-governance/application/usecases/refresh-claude-md-usecase.ts

@@ -1,6 +1,7 @@
 /**
  * @layer application
  * @unit ci-governance
+ * @work-item-id WI-190
  */
 
 import type { AgentContextDocumentPort } from '../../domain/ports/agent-context-document-port.js';
@@ -12,12 +13,11 @@ const CLAUDE_MD_PATH = 'CLAUDE.md';
 const CLAUDE_MD_TEMPLATE_PATH = 'docs/templates/agent-context/CLAUDE.md.template.md';
 
 const PHASEGATE_COMMANDS = [
-  'phasegate init --with-ci',
-  'phasegate ci:auto-refresh-agent-context --dry-run',
-  'phasegate ci:auto-refresh-agent-context --apply',
-  'phasegate refresh-claude-md --apply',
-  'phasegate p2:check-agent-context',
+  'phasegate doctor',
   'phasegate phasegate:check-ready',
+  'phasegate validate --layer L2 --format human',
+  'phasegate setup:agent --dry-run',
+  'phasegate config:plan --intent l4-strict --dry-run',
 ];
 
 const PHASE_PRESETS = ['minimal', 'standard', 'full', 'custom'];
@@ -37,7 +37,7 @@ export class RefreshClaudeMdUseCase {
       ]);
       const nextContent = this.composer.compose(template, existing, {
         commands: PHASEGATE_COMMANDS,
-        skills,
+        skills: ['all bundled skills'],
         presets: PHASE_PRESETS,
       });
       const changed = existing !== nextContent;

package/scripts/harness/ci-governance/application/usecases/scaffold-design-usecase.ts

@@ -1,5 +1,6 @@
 // @unit ci-governance
 // @layer application
+// @work-item-id WI-189
 
 import { DesignPhase } from '../../domain/value-objects/design-phase.js';
 import type { TemplateRepositoryPort } from '../../domain/ports/template-repository-port.js';
@@ -21,18 +22,33 @@ export class ScaffoldDesignUseCase {
     }
     const phase = DesignPhase.create(input.phase);
     const unit = input.unit.trim();
+    const dryRun = input.dryRun === true;
     const force = input.force === true;
 
     const templatePath = this.templates.resolvePath(phase);
     const targetPath = this.writer.resolvePath(unit, phase);
     const alreadyExists = await this.writer.exists(unit, phase);
 
+    if (dryRun) {
+      return {
+        targetPath,
+        templatePath,
+        unit,
+        phase: phase.value,
+        dryRun: true,
+        written: false,
+        alreadyExists,
+        overwritten: false,
+      };
+    }
+
     if (alreadyExists && !force) {
       return {
         targetPath,
         templatePath,
         unit,
         phase: phase.value,
+        dryRun: false,
         written: false,
         alreadyExists: true,
         overwritten: false,
@@ -48,6 +64,7 @@ export class ScaffoldDesignUseCase {
       templatePath,
       unit,
       phase: phase.value,
+      dryRun: false,
       written: true,
       alreadyExists,
       overwritten: alreadyExists && force,

package/scripts/harness/ci-governance/domain/services/claude-md-composer.ts

@@ -11,7 +11,7 @@ export interface ClaudeMdTemplateValues {
 
 const USER_SECTION_START = '<!-- phasegate:user-section:start -->';
 const USER_SECTION_END = '<!-- phasegate:user-section:end -->';
-const DEFAULT_USER_SECTION = 'プロジェクト固有の指示をここに記載してください。';
+const DEFAULT_USER_SECTION = 'Project-specific agent instructions go here.';
 
 export class ClaudeMdComposer {
   compose(template: string, existing: string | null, values: ClaudeMdTemplateValues): string {

package/scripts/harness/ci-governance/infrastructure/adapters/yaml-template-renderer-adapter.ts

@@ -2,6 +2,7 @@
  * @layer infrastructure
  * @unit ci-governance
  * @work-item-id WI-182 / WI-183
+ * @work-item-id WI-194
  *
  * TemplateRendererPort実装（YAML書き出し）
  */

package/scripts/harness/ci-governance/presentation/handlers/scaffold-design-handler.ts

@@ -1,5 +1,6 @@
 // @unit ci-governance
 // @layer presentation
+// @work-item-id WI-189
 
 import { DesignPhase } from '../../domain/value-objects/design-phase.js';
 import type { ScaffoldDesignUseCase } from '../../application/usecases/scaffold-design-usecase.js';
@@ -7,6 +8,8 @@ import type { ScaffoldDesignUseCase } from '../../application/usecases/scaffold-
 export interface ScaffoldDesignHandlerArgs {
   readonly unit?: string;
   readonly phase?: string;
+  readonly dryRun?: boolean;
+  readonly apply?: boolean;
   readonly force?: boolean;
   readonly format?: 'human' | 'json';
 }
@@ -21,6 +24,12 @@ export class ScaffoldDesignHandler {
 
   async handle(args: ScaffoldDesignHandlerArgs): Promise<ScaffoldDesignHandlerResult> {
     const format = args.format ?? 'human';
+    const apply = args.apply === true;
+    const dryRun = args.dryRun === true || !apply;
+
+    if (args.dryRun === true && apply) {
+      return this.fail(format, '--dry-run と --apply は同時に指定できません', 2);
+    }
 
     if (!args.unit || args.unit.trim().length === 0) {
       return this.fail(format, '--unit <unit-id> は必須です', 2);
@@ -45,6 +54,7 @@ export class ScaffoldDesignHandler {
       result = await this.useCase.execute({
         unit: args.unit,
         phase: args.phase,
+        dryRun,
         force: args.force,
       });
     } catch (err) {
@@ -61,10 +71,22 @@ export class ScaffoldDesignHandler {
 
     if (result.alreadyExists && !result.written) {
       return {
-        exitCode: 2,
+        exitCode: result.dryRun ? 0 : 2,
+        output: [
+          result.dryRun ? `dry-run: 既に存在します: ${result.targetPath}` : `既に存在します: ${result.targetPath}`,
+          result.dryRun ? '書き込むには --apply を指定してください。' : '上書きするには --force を指定してください。',
+        ].join('\n'),
+      };
+    }
+
+    if (result.dryRun) {
+      return {
+        exitCode: 0,
         output: [
-          `既に存在します: ${result.targetPath}`,
-          '上書きするには --force を指定してください。',
+          `dry-run: 設計文書を生成予定: ${result.targetPath}`,
+          `テンプレ: ${result.templatePath}`,
+          `Unit: ${result.unit} / phase: ${result.phase}`,
+          '書き込むには --apply を指定してください。',
         ].join('\n'),
       };
     }

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

@@ -29,7 +29,7 @@ import type {
 
 export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';
 export type PresetId = 'minimal' | 'standard' | 'strict';
-export type PlanningModeValue = 'interactive' | 'embedded-qa';
+export type PlanningModeValue = 'interactive' | 'embedded-qa' | 'manual';
 export type { PhaseDependenciesPresetId };
 type DeepPartial<T> = {
   [K in keyof T]?: T[K] extends Array<infer TItem>

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

@@ -3,11 +3,11 @@
  * @unit config-foundation
  *
  * Planning Mode設定を表す値オブジェクト
- * defaultMode と perPhase の値は列挙値 "interactive" | "embedded-qa" のみ許容
+ * defaultMode と perPhase の値は列挙値 "interactive" | "embedded-qa" | "manual" のみ許容
  */
 import { ConfigValidationError } from '../errors/config-validation-error.js';
 
-const VALID_MODES = ['interactive', 'embedded-qa'] as const;
+const VALID_MODES = ['interactive', 'embedded-qa', 'manual'] as const;
 type PlanningMode = (typeof VALID_MODES)[number];
 
 export interface PlanningModeConfigProps {

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

@@ -384,7 +384,8 @@
           "type": "string",
           "enum": [
             "interactive",
-            "embedded-qa"
+            "embedded-qa",
+            "manual"
           ]
         },
         "perPhase": {
@@ -393,7 +394,8 @@
             "type": "string",
             "enum": [
               "interactive",
-              "embedded-qa"
+              "embedded-qa",
+              "manual"
             ]
           }
         }

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

@@ -394,7 +394,8 @@
           "type": "string",
           "enum": [
             "interactive",
-            "embedded-qa"
+            "embedded-qa",
+            "manual"
           ]
         },
         "perPhase": {
@@ -403,7 +404,8 @@
             "type": "string",
             "enum": [
               "interactive",
-              "embedded-qa"
+              "embedded-qa",
+              "manual"
             ]
           }
         }

package/scripts/harness/installation/application/checks/wi-workflow-drift-check.ts

@@ -2,6 +2,7 @@
 // @layer application
 // @work-item-id WI-143
 // @work-item-id WI-187
+// @work-item-id WI-193
 
 import { join, relative, sep } from "node:path";
 import { DiagnosticFinding } from "../../domain/diagnostic-finding.js";
@@ -61,5 +62,6 @@ function isWorkItemDescription(path: string): boolean {
 function isAdHocPlan(path: string): boolean {
   if (!path.startsWith("docs/inception/")) return false;
   if (/\/WI-\d{3}\//.test(path)) return false;
+  if (path.startsWith("docs/inception/_shared/") && path.endsWith(".md")) return true;
   return path.includes("/codding_plan/") || path.endsWith("_plan.md");
 }

package/scripts/harness/integrations/pre-commit.ts

@@ -3,6 +3,7 @@
  * @layer presentation
  * @work-item-id WI-141
  * @work-item-id WI-109
+ * @work-item-id WI-189
  *
  * Pre-commit CLI entry.
  * Runs L2 validators against staged TypeScript files AND design-document
@@ -533,6 +534,11 @@ function hasCompleteBypassTrailerSet(results: readonly BypassTrailerValidationRe
   return results.some((result) => result.hasAnyBypassTrailer && result.complete);
 }
 
+function toBypassAuditStdout(stdout: string, changedFiles: readonly string[]): string {
+  if (changedFiles.length > 0) return stdout;
+  return stdout.replace("No staged files to check. Skipping.", "No changed files in range to check. Skipping.");
+}
+
 export async function runBypassAudit(
   deps: PreCommitDeps,
   options: BypassAuditOptions = {},
@@ -554,7 +560,7 @@ export async function runBypassAudit(
 
   const sections = [
     `${BOLD}[phasegate]${RESET} Bypass audit (${baseRef}..${headRef})`,
-    result.stdout,
+    toBypassAuditStdout(result.stdout, changedFiles),
   ];
   let exitCode = result.exitCode;
   if (result.exitCode !== 0 && !hasCompleteBypassTrailerSet(bypassResults)) {

package/scripts/harness/main.ts

@@ -7,6 +7,10 @@
  * @work-item-id WI-175
  * @work-item-id WI-176
  * @work-item-id WI-184
+ * @work-item-id WI-189
+ * @work-item-id WI-191
+ * @work-item-id WI-195
+ * @work-item-id WI-196
  *
  * Phasegate CLI エントリポイント。
  * 各Unitの Composition Root からハンドラーを取得し、コマンドに応じてディスパッチする。
@@ -156,7 +160,8 @@ Setup:
                                 --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>)
-  scaffold-wi <unit> <type>    Create docs/inception/{unit}/WI-XXX/description.md
+  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
   install                      Install phasegate managed files (--dry-run|--apply, --force)
   uninstall                    Uninstall phasegate managed files (--dry-run|--apply, --force)
@@ -169,6 +174,7 @@ Commands:
   disable-feature <name>       Disable a harness feature
   list-features                List available features
   migrate                      Migrate phasegate.config.json (--schema v3, --config <path>)
+  migrate work-items           Migrate legacy inception work item directories (--dry-run|--apply)
   work-items:status            Report or apply derived WI frontmatter status (--dry-run|--apply, --id, --fail-on-stale, --json)
 
   render-errors                Render harness errors (--format human|agent|ci)
@@ -183,8 +189,9 @@ Commands:
 
   lint                         Run lint checks (--json, --target <path>)
 
-  validate                     Run validators (--layer L2|L3|L4|all; L0 prints runtime hook info, --unit, --format human|agent|ci)
+  validate                     Run validators (--layer L2|L3|L4|all; L0 prints runtime hook info, --unit, --format human|agent|ci|json, --json)
   ci-check                     CI check (--quick for quick mode, --fail-on-reject, --dry-run, --files)
+  check-change-category        Classify changed paths for quick mode (--paths <csv>, --format human|json)
 
   phasegate:check-ready         Check ready status (--json)
   phasegate:check-phase         Check phase gate (--unit <unitId>, --json)
@@ -208,10 +215,10 @@ 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>, --dry-run, --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, --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>, --force, --json)
+  scaffold-design              Scaffold a design doc (--unit <id>, --phase <logical|domain|uiux|unit-test|it-test>, --dry-run|--apply, --force, --json)
 
   skill:execute-tdd-cycle      Execute TDD cycle (--unit, --story, --desc, --phase RED|GREEN|REFACTOR, --passed)
   skill:check-coverage         Check coverage (--story <storyId>, --json)
@@ -409,7 +416,8 @@ function parseValidateFormat(args: readonly string[]): "human" | "agent" | "ci"
   const raw = parseFlag(args, "--format");
   if (raw === undefined) return undefined;
   if (raw === "human" || raw === "agent" || raw === "ci") return raw;
-  throw new Error(`Invalid --format value for validate: '${raw}'. Supported values: human, agent, ci.`);
+  if (raw === "json") return "ci";
+  throw new Error(`Invalid --format value for validate: '${raw}'. Supported values: human, agent, ci, json.`);
 }
 
 function levenshtein(a: string, b: string): number {
@@ -524,7 +532,7 @@ Options:
 Produce an agent-readable configuration change plan.
 
 Intents:
-  l4-strict, codex-hooks, ci-fail-on-warning, baseline-reset, quick-mode-strict
+  l4-strict, codex-hooks, ci-fail-on-warning, baseline-reset, quick-mode-strict, retrofit-bootstrap, planning-mode-relax
 
 Options:
   --dry-run
@@ -546,7 +554,8 @@ Run validators against the project. Without --layer, runs all enabled validator
 
 Options:
   --layer <L0|L2|L3|L4>           Run only the specified validator layer; L0 prints runtime hook info
-  --json                          Output machine-readable JSON
+  --format <human|agent|ci|json>  Output format; json is an alias for ci JSON
+  --json                          Output machine-readable JSON when --format is omitted
   --help, -h                      Show this help`,
   lint: `Usage: phasegate lint [options]
 
@@ -557,10 +566,11 @@ Options:
   --help, -h                      Show this help`,
   migrate: `Usage: phasegate migrate [options]
 
-Migrate phasegate.config.json from older schema versions. Backs up the original to phasegate.config.json.bak.
+Migrate phasegate.config.json from older schema versions, or migrate legacy inception work item directories.
 
 Options:
   --dry-run                       Preview changes without writing
+  --apply                         Apply migration when supported
   --help, -h                      Show this help`,
   "list-errors": `Usage: phasegate list-errors [options]
 
@@ -626,6 +636,28 @@ Options:
 Examples:
   phasegate check-change-category --paths src/foo.ts,src/bar.ts
   phasegate check-change-category --paths src/foo.ts --format json`,
+  "scaffold-wi": `Usage: phasegate scaffold-wi <unit|_cross> <story|issue|chore>
+
+Create docs/inception/{unit}/WI-XXX/description.md.
+
+Arguments:
+  <unit|_cross>              Unit id or _cross for cross-cutting work items.
+  <story|issue|chore>        Work item type.
+
+Options:
+  --help, -h                 Show this help`,
+  "scaffold-design": `Usage: phasegate scaffold-design --unit <id> --phase <phase> [options]
+
+Scaffold a product construction design document.
+
+Options:
+  --unit <id>                Unit id under docs/product/construction.
+  --phase <phase>            logical, domain, uiux, unit-test, or it-test.
+  --dry-run                  Preview target and template without writing (default).
+  --apply                    Write the scaffold.
+  --force                    Overwrite an existing target when applying.
+  --json                     Output machine-readable JSON.
+  --help, -h                 Show this help`,
   "ci:generate-template": `Usage: phasegate ci:generate-template [options]
 
 Generates a CI template configuration.
@@ -643,6 +675,15 @@ Options:
 Examples:
   phasegate ci:generate-template --type aidlc-gate
   phasegate ci:generate-template --preset strict --type pre-commit --render`,
+  "delegate-sonnet": `Usage: phasegate delegate-sonnet [...args]
+
+Delegate a task to Sonnet 4.6 by forwarding all args to scripts/delegate-sonnet.sh.
+
+Arguments:
+  [...args]                  Task text and options consumed by the delegate script.
+
+Options:
+  --help, -h                 Show this help`,
 };
 
 function printSubcommandHelp(command: string): void {
@@ -733,7 +774,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";
+type ConfigChangeIntent = "l4-strict" | "codex-hooks" | "ci-fail-on-warning" | "baseline-reset" | "quick-mode-strict" | "retrofit-bootstrap" | "planning-mode-relax";
 type SetupCompletenessStatus = "configured" | "planned" | "manual" | "not-applicable" | "unknown";
 
 interface SetupCompletenessEntry {
@@ -811,7 +852,9 @@ function parseConfigChangeIntent(value: string | undefined): ConfigChangeIntent
     value === "codex-hooks" ||
     value === "ci-fail-on-warning" ||
     value === "baseline-reset" ||
-    value === "quick-mode-strict"
+    value === "quick-mode-strict" ||
+    value === "retrofit-bootstrap" ||
+    value === "planning-mode-relax"
   ) {
     return value;
   }
@@ -1180,6 +1223,14 @@ function buildConfigPatchPreview(intent: ConfigChangeIntent, before: unknown | n
     ],
     "codex-hooks": [],
     "baseline-reset": [],
+    "retrofit-bootstrap": [
+      { pointer: "/planningMode/default", path: ["planningMode", "default"], value: "manual" },
+      { pointer: "/phaseDependencies/override", path: ["phaseDependencies", "override"], value: true },
+      { pointer: "/quickMode/relaxedGates", path: ["quickMode", "relaxedGates"], value: ["phase-gate"] },
+    ],
+    "planning-mode-relax": [
+      { pointer: "/planningMode/default", path: ["planningMode", "default"], value: "manual" },
+    ],
   };
   const changes = configIntents[intent];
   if (changes.length === 0) {
@@ -1267,6 +1318,22 @@ 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."],
     },
+    "retrofit-bootstrap": {
+      targets: ["phasegate.config.json: planningMode.default", "phasegate.config.json: phaseDependencies.override", "phasegate.config.json: quickMode.relaxedGates"],
+      managedTargets: ["phasegate.config.json"],
+      externalActions: [],
+      commands: ["phasegate baseline --dry-run", "phasegate config:plan --intent retrofit-bootstrap --json"],
+      validations: ["phasegate validate-metadata docs/inception/_shared/*.md", "phasegate check-phase-gate --level 2"],
+      risks: ["Manual planning mode accepts existing retrofit planning evidence; review the patch before applying it to avoid weakening greenfield projects."],
+    },
+    "planning-mode-relax": {
+      targets: ["phasegate.config.json: planningMode.default"],
+      managedTargets: ["phasegate.config.json"],
+      externalActions: [],
+      commands: ["phasegate config:plan --intent planning-mode-relax --json"],
+      validations: ["phasegate check-phase-gate --level 2", "phasegate phasegate:check-ready"],
+      risks: ["Manual planning mode reduces PhaseGate's QA enforcement for plan documents until strict planning is restored."],
+    },
   };
   const before = await readProjectJson(rootDir, "phasegate.config.json");
   return {
@@ -2191,7 +2258,7 @@ async function main(): Promise<void> {
         const layer = parseFlag(args, "--layer") as "L0" | "L2" | "L3" | "L4" | "all" | undefined;
         const unit = parseFlag(args, "--unit");
         const phase = parseFlag(args, "--phase");
-        const format = parseValidateFormat(args);
+        const format = parseValidateFormat(args) ?? (json ? "ci" : undefined);
         // WI-094 / ADR-017: --fail-on-warning / --no-fail-on-warning / 未指定→config値
         const failOnWarning = parseTriStateFlag(args, "--fail-on-warning", "--no-fail-on-warning");
         const noL4 = hasFlag(args, "--no-l4");
@@ -2206,7 +2273,7 @@ async function main(): Promise<void> {
           targetPaths,
         });
         console.log(result.output);
-        if (layer === "L2" || layer === "all") {
+        if ((layer === "L2" || layer === "all") && format !== "ci") {
           await printStoryReflectionValidationSummary(rootDir, unit);
         }
         process.exit(result.exitCode);
@@ -2492,11 +2559,15 @@ Examples:
         const mod = buildCiGovernance(rootDir, harnessRoot);
         const unit = parseFlag(args, "--unit") ?? "";
         const phase = parseFlag(args, "--phase") ?? "";
+        const dryRun = hasFlag(args, "--dry-run");
+        const apply = hasFlag(args, "--apply");
         const force = hasFlag(args, "--force");
         const format = json ? "json" : "human";
         const result = await mod.scaffoldDesignHandler.handle({
           unit,
           phase,
+          dryRun,
+          apply,
           force,
           format,
         });
@@ -2547,7 +2618,7 @@ Examples:
         const mod = createSkillQualityHandlers();
         const storyId = parseFlag(args, "--story") ?? "";
         const dryRun = hasFlag(args, "--dry-run");
-        const result = await mod.applyCascadeUpdateHandler.handle({ storyId, dryRun });
+        const result = await mod.applyCascadeUpdateHandler.handle({ storyId, dryRun, format: json ? "json" : "human" });
         console.log(result.message);
         process.exit(result.exitCode);
         break;
@@ -2740,6 +2811,10 @@ Examples:
       }
 
       case "delegate-sonnet": {
+        if (hasFlag(args, "--help") || hasFlag(args, "-h")) {
+          printSubcommandHelp("delegate-sonnet");
+          process.exit(0);
+        }
         const { spawn } = await import("node:child_process");
         const scriptPath = join(harnessRoot, "scripts/delegate-sonnet.sh");
         const forwardArgs = args.slice(1);

package/scripts/harness/phase-dependency-model/application/services/phase-info-resolver.ts

@@ -125,7 +125,7 @@ export class PhaseInfoResolver {
           blockers.push(`QAが未完了です: ${node.nodeKey()}`);
         }
         if (!actual.planningModeMatch) {
-          blockers.push(`Planning Mode要件を満たしていません: ${node.nodeKey()}`);
+          blockers.push(`Planning Mode evidence requirement is not satisfied: ${node.nodeKey()}`);
         }
       }
     }

package/scripts/harness/phase-dependency-model/domain/models/phase-structure.ts

@@ -270,7 +270,7 @@ export class PhaseStructure {
         }
 
         if (!planEvidence.planningModeMatch) {
-          blockers.push(`Planning Mode要件を満たしていません: ${node.nodeKey()}`);
+          blockers.push(`Planning Mode evidence requirement is not satisfied: ${node.nodeKey()}`);
         }
       }
 

package/scripts/harness/phase-dependency-model/domain/values/planning-mode.ts

@@ -3,7 +3,7 @@
  * @unit phase-dependency-model
  */
 
-export type PlanningModeValue = 'interactive' | 'embedded-qa';
+export type PlanningModeValue = 'interactive' | 'embedded-qa' | 'manual';
 
 export class InvalidPlanningModeError extends Error {
   constructor(value: string) {
@@ -21,7 +21,7 @@ export class PlanningMode {
   }
 
   static create(value: string): PlanningMode {
-    if (value !== 'interactive' && value !== 'embedded-qa') {
+    if (value !== 'interactive' && value !== 'embedded-qa' && value !== 'manual') {
       throw new InvalidPlanningModeError(value);
     }
 

package/scripts/harness/skill-quality/application/usecases/apply-cascade-update-usecase.ts

@@ -1,6 +1,7 @@
 /**
  * @layer application
  * @unit skill-quality
+ * @work-item-id WI-192
  */
 import { CascadeUpdateResult } from '../../domain/value-objects/cascade-update-result.js';
 import type { CascadeUpdateService } from '../../domain/services/cascade-update-service.js';
@@ -35,7 +36,7 @@ export class ApplyCascadeUpdateUseCase {
             const updatedContent = content.includes(target.storyIdTag)
               ? content
               : `${content}\n${target.storyIdTag}`;
-            if (!input.dryRun) {
+            if (!input.dryRun && updatedContent !== content) {
               await this.fileSystemPort.write(filePath, updatedContent);
             }
             updatedCount++;

package/scripts/harness/skill-quality/presentation/handlers/apply-cascade-update-handler.ts

@@ -1,12 +1,14 @@
 /**
  * @layer presentation
  * @unit skill-quality
+ * @work-item-id WI-192
  */
 import type { ApplyCascadeUpdateUseCase } from '../../application/usecases/apply-cascade-update-usecase.js';
 
 export interface ApplyCascadeUpdateArgs {
   storyId: string;
   dryRun?: boolean;
+  format?: 'human' | 'json';
 }
 
 export class ApplyCascadeUpdateHandler {
@@ -15,8 +17,15 @@ export class ApplyCascadeUpdateHandler {
   async handle(args: ApplyCascadeUpdateArgs): Promise<{ exitCode: number; message: string }> {
     try {
       const output = await this.useCase.execute({ storyId: args.storyId, dryRun: args.dryRun });
+      if (args.format === 'json') {
+        return {
+          exitCode: output.errors.length > 0 ? 1 : 0,
+          message: JSON.stringify({ dryRun: args.dryRun === true, ...output }, null, 2),
+        };
+      }
       const tagsLine = output.appliedStoryIds.join(', ');
-      let msg = `Updated ${output.updatedCount} files with tags: ${tagsLine}`;
+      const verb = args.dryRun ? 'Would update' : 'Updated';
+      let msg = `${verb} ${output.updatedCount} files with tags: ${tagsLine}`;
 
       if (output.errors.length > 0) {
         const errLines = output.errors.map((e) => `  - ${e}`).join('\n');