phasegate 0.71.0 → 0.73.0

package/CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.73.0] - 2026-04-22
+
+### Added
+
+- ISSUE-007 Wave 8 — `phasegate.config.json` の `project.paths` セクションを schema (`harness-config-v2.schema.json`) に追加。`project.paths.source` (array, minItems: 1) で phase-gate の監視ディレクトリを override できるようになった。`project.paths.docs.construction` / `project.paths.docs.inception` も optional で指定可能。
+- IT-CF-PP-001a..d を追加（`project.paths.source` の valid/invalid パターン）。
+
+### Fixed
+
+- ISSUE-007 Wave 8 dogfood で発覚した retrofit blocker を解消 — 従来は adapter (`harness-config-config-query-adapter.ts`) が `config.project?.paths?.source` を読む設計だったにも関わらず schema がそれを additionalProperties として reject していたため、`src/` 配下を使う一般 Node.js プロジェクトでは phase-gate が実質無効化されていた。
+
+### Retrofit ガイド追補
+
+- `docs/guide/retrofit-adoption.md` に「source path の指定」セクションを追加。`src/` 系プロジェクトでは `project.paths.source: ["src"]` の明示が必須である旨を記載。
+
+## [0.72.0] - 2026-04-22
+
+### Changed
+
+- ISSUE-007 Wave 7 — v0.71.0 で修正した挙動（`baseline.enabled` default=`true` / `baseline --dry-run --json` の `files` キー）に合わせて以下ドキュメントを更新:
+  - `docs/guide/retrofit-adoption.md` — baseline.json スキーマ例を実機形式に修正、default glob の範囲（TS/JS だけでなく md も含む）を明記、「init 後に config を手で書く」記述を削除
+  - `docs/guide/cli-reference.md` — `Scaffold Design` セクション追加（Wave 4 で導入した CLI が未記載だった）、baseline セクションに v0.71.0 の変更点を追補
+  - `README.md` — Command Reference に `scaffold-design` 追加、baseline 段落に v0.71.0 変更点と retrofit-adoption.md リンクを追加、Documentation セクションに retrofit-adoption.md を追加
+  - `README.ja.md` — 同上（baseline / `scaffold-design` 行を CLI テーブルに追加、retrofit-adoption.md リンクを含む段落に更新）
+
 ## [0.71.0] - 2026-04-22
 
 ### Changed (breaking-ish)

package/README.ja.md

@@ -219,7 +219,7 @@ npx phasegate ci:generate-template --type consistency-check --render > .github/w
 
 `quickMode.fullModeRequiredWhen` は **「Quick Mode で進めようとした変更を Full Mode に強制エスカレートする条件」** を宣言します（v0.63.0 / ISSUE-006 Story A で導入、v0.64.0 / Story B で pre-tool-use hook に統合）。3 トリガー（`mixedCategories` / `newDomainFile` / `apiContractChange`）はいずれも安全側のデフォルト `true`。プロジェクトが意図的にリスクを受け入れる場合のみ個別に `false` にできます。
 
-`baseline` は **Phase A-2 リトロフィット grandfather** をオン/オフします（v0.65.0 / ISSUE-007 Wave 1 で導入、v0.66.0 / Wave 2 で pre-tool-use hook に統合）。`.phasegate/baseline.json` に登録済みのファイルは、構造的に編集されるまで `phase-gate` 対象から除外されます。既存リポジトリへの導入時に `npx phasegate baseline` でスナップショットを生成してください。
+`baseline` は **Phase A-2 リトロフィット grandfather** をオン/オフします（v0.65.0 / ISSUE-007 Wave 1 で導入、v0.66.0 / Wave 2 で pre-tool-use hook に統合、v0.71.0 / Wave 6 で `baseline.enabled` の default を `true` に変更）。`.phasegate/baseline.json` に登録済みのファイルは、構造的に編集されるまで `phase-gate` 対象から除外されます。既存リポジトリへの導入時は `npx phasegate init` 後に `npx phasegate baseline` を実行するだけで grandfather が効きます（config への手動追記は不要）。手順の詳細は [Retrofit Adoption Guide](docs/guide/retrofit-adoption.md) を参照。
 
 ### project.preset -- レイヤー厳密度
 
@@ -417,7 +417,8 @@ npx phasegate <command> [options]
 | `check-phase-gate` | フェーズゲートチェック | `--level 1\|2\|3` |
 | `validate-metadata <files>` | メタデータ検証 | |
 | `check-change-category` | 変更ファイルを Quick Mode カテゴリに分類し、`quickMode.fullModeRequiredWhen` 評価結果（Full Mode 強制が必要か）を返す（v0.63.0 / ISSUE-006 Story A） | `--paths <csv>` `--format human\|json` `--fail-on-full-required` |
-| `baseline` | `.phasegate/baseline.json` スナップショットを生成（Phase A-2 grandfather）。登録済みファイルは構造的に編集されるまで `phase-gate` 対象から除外される（v0.65.0 / ISSUE-007 Wave 1） | `--dry-run` `--force` `--paths <glob,glob,...>` `--json` |
+| `baseline` | `.phasegate/baseline.json` スナップショットを生成（Phase A-2 grandfather）。登録済みファイルは構造的に編集されるまで `phase-gate` 対象から除外される（v0.65.0 / ISSUE-007 Wave 1、v0.71.0 で `baseline.enabled` default=`true`・dry-run 出力キー `files` に統一） | `--dry-run` `--force` `--paths <glob,glob,...>` `--json` |
+| `scaffold-design --unit <id> --phase <logical\|domain\|uiux\|unit-test\|it-test>` | `templates/*.template.md` を読み取り `{{unit}}` を `--unit` 値に置換して `docs/product/construction/{unit}/*.md` に出力。phase-gate エラーに挿入される `scaffold: ...` 行の実体（v0.69.0 / ISSUE-007 Wave 4） | `--force` `--json` |
 
 ### phasegate コマンド
 

package/README.md

@@ -212,7 +212,7 @@ Skills cover the full **AIDLC (AI-Driven Development Life Cycle)**, enforcing ph
 
 `quickMode.fullModeRequiredWhen` declares which conditions force a Quick Mode change to escalate to the full `/story-implementor` flow. All three triggers default to `true` so retrofits stay safe; flip individual flags to `false` only when a project intentionally accepts the risk.
 
-`baseline` opts in to the **Phase A-2 retrofit grandfather**: pre-existing files captured in `.phasegate/baseline.json` are exempted from `phase-gate` until they are structurally modified. Generate the snapshot with `npx phasegate baseline` before introducing the harness to an existing repository.
+`baseline` opts in to the **Phase A-2 retrofit grandfather**: pre-existing files captured in `.phasegate/baseline.json` are exempted from `phase-gate` until they are structurally modified. Generate the snapshot with `npx phasegate baseline` before introducing the harness to an existing repository. Since v0.71.0 the `baseline.enabled` flag defaults to `true`, so simply running `npx phasegate baseline` after `init` is enough — no manual config edit needed. For a step-by-step retrofit walkthrough see [Retrofit Adoption Guide](docs/guide/retrofit-adoption.md).
 
 ---
 
@@ -313,7 +313,8 @@ npx phasegate <command> [options]
 | `phasegate:status` | Display overall harness health summary |
 | `phasegate:check-phase --unit <id>` | Check current phase for a Unit |
 | `check-change-category --paths <csv>` | Classify changed files into Quick Mode categories and report whether Full Mode is required (`--format json`, `--fail-on-full-required`) |
-| `baseline` | Create `.phasegate/baseline.json` snapshot for Phase A-2 retrofit grandfather (`--dry-run`, `--force`, `--paths <glob,glob,...>`, `--json`) |
+| `baseline` | Create `.phasegate/baseline.json` snapshot for Phase A-2 retrofit grandfather (`--dry-run`, `--force`, `--paths <glob,glob,...>`, `--json`). `baseline.enabled` defaults to `true` since v0.71.0. |
+| `scaffold-design --unit <id> --phase <logical\|domain\|uiux\|unit-test\|it-test>` | Generate minimum viable design doc from `templates/*.template.md` into `docs/product/construction/{unit}/*.md` (`--force`, `--json`). Materializes the `scaffold: ...` line emitted by phase-gate errors. |
 | `list-errors --layer <L0-L4>` | List error definitions with fix examples |
 | `hook <pre-tool-use\|post-tool-use\|stop>` | Run a Claude Code hook (reads JSON from stdin) |
 | `pre-commit` | Run L2 pre-commit validators on staged files |
@@ -335,6 +336,7 @@ Detailed guides are available under `docs/guide/`:
 - [Hooks Integration](docs/guide/hooks-integration.md) -- Claude Code Hooks setup and behavior
 - [Codex Integration](docs/guide/codex-integration.md) -- Codex CLI setup, coverage matrix, and native `apply_patch` limitation
 - [Quick Mode vs Full Mode](docs/guide/quick-vs-full-mode.md) -- When to use `/story-implementor` vs `/quick-implementor`, with decision flow and case studies
+- [Retrofit Adoption Guide](docs/guide/retrofit-adoption.md) -- Onboard an existing project without getting blocked: `init` → `baseline` → `scaffold-design` in 4 steps
 
 Additional resources:
 

package/docs/guide/cli-reference.md

@@ -87,8 +87,50 @@ npx phasegate baseline --paths "scripts/harness/**/*.ts,src/**/*.ts"
 編集した瞬間に grandfather が外れ、通常の `phase-gate` 対象に戻る。新規ファイルは
 最初から `phase-gate` の対象。
 
-`baseline.enabled = false` (デフォルトは `true`) を `phasegate.config.json` に書くと
-仕組み全体を無効化できる。スナップショットの保存先は `baseline.path` で変更可能。
+`baseline.enabled` は v0.71.0 以降 default が `true`（ISSUE-007 Wave 6）。
+オフにしたい場合のみ `phasegate.config.json` に `baseline.enabled: false` を明示。
+スナップショットの保存先は `baseline.path` で変更可能。
+
+`baseline --dry-run --json` の出力キーは v0.71.0 で保存ファイルと整合する `files`
+に統一（旧 `entries` は廃止）。
+
+---
+
+## Scaffold Design (Retrofit Template Generator)
+
+| Command | Options | Description |
+|---|---|---|
+| `scaffold-design` | `--unit <id>` `--phase <logical\|domain\|uiux\|unit-test\|it-test>` `--force` `--json` | `templates/*.template.md` を読み取り `{{unit}}` を `--unit` 値で置換して `docs/product/construction/{unit}/*.md` を生成する。既存ファイルは `--force` なしでは保護（exit 2）。|
+
+### `scaffold-design` の使い方
+
+ISSUE-007 Wave 4 で導入（v0.69.0）。phase-gate が発火した際にエラーメッセージへ
+挿入される `scaffold: npx phasegate scaffold-design ...` 行の実体。AIDLC フル
+スキルを起動せずに設計文書の雛形だけ先に置きたい時に使う。
+
+```bash
+# 論理設計テンプレを harness-api 用に生成
+npx phasegate scaffold-design --unit harness-api --phase logical
+
+# 既存ファイルを意図的に上書き
+npx phasegate scaffold-design --unit harness-api --phase logical --force
+
+# CI / スクリプト向け JSON 出力
+npx phasegate scaffold-design --unit harness-api --phase logical --json
+```
+
+生成先と対応テンプレ:
+
+| `--phase` | 生成先 | テンプレ |
+|---|---|---|
+| `logical` | `docs/product/construction/{unit}/logical_design.md` | `templates/logical_design.template.md` |
+| `domain` | `docs/product/construction/{unit}/domain_model.md` | `templates/domain_model.template.md` |
+| `uiux` | `docs/product/construction/{unit}/uiux_design.md` | `templates/uiux_design.template.md` |
+| `unit-test` | `docs/product/construction/{unit}/unit_test_design.md` | `templates/unit_test_design.template.md` |
+| `it-test` | `docs/product/construction/{unit}/it_test_design.md` | `templates/it_test_design.template.md` |
+
+exit code は `0` = 生成成功 / 上書き成功、`2` = 既存ファイルあり（`--force` 無）
+または引数不正。
 
 ---
 

package/docs/guide/retrofit-adoption.md

@@ -19,7 +19,7 @@ phasegate は本来「新規プロジェクトをゼロから AIDLC で組む」
 
 - Node.js >= 18.0.0
 - 既存プロジェクトのソースコードが git で管理されている
-- phasegate >= v0.69.0（scaffold-design CLI 含む）
+- phasegate >= v0.71.0（`baseline.enabled` default=true / dry-run 出力キー整合済み）
 
 ```bash
 npm install --save-dev phasegate
@@ -46,21 +46,58 @@ npx phasegate init --name <project-name>
 
 - `.claude/skills/` に 28 スキルを配置
 - `phasegate.config.json` を生成
-- `phasegate.config.json` の `baseline` セクションは既定で `enabled: true`
+- `phasegate.config.json` に `baseline` セクションが未記載でも、v0.71.0 以降は
+  **`baseline.enabled` の default が `true`** のため grandfather は既定で有効
 
-`phasegate.config.json` の該当部分（デフォルト）:
+grandfather をオフにしたい場合のみ `phasegate.config.json` に明示:
 
 ```json
 {
   "baseline": {
-    "enabled": true,
+    "enabled": false,
     "path": ".phasegate/baseline.json"
   }
 }
 ```
 
-`baseline.enabled` を `false` にすると grandfather が無効化され、既存ファイルも全て
-gate 対象になる（後付け導入では推奨しない）。
+`path` も省略時は `.phasegate/baseline.json` が使われる。retrofit 用途では
+この既定値のまま触らないのが最短。
+
+### source path の指定（v0.73.0 以降、`src/` 系 retrofit に必須）
+
+pre-tool-use hook の phase-gate は `project.paths.source` に記載されたディレクトリ
+配下のファイルのみを監視対象にする。既定値は `["scripts/harness"]` で、これは
+phasegate 本体のレイアウトに合わせたもの。**一般的な Node.js プロジェクト
+(`src/` 配下) では必ず上書きすること**。
+
+```json
+{
+  "project": {
+    "name": "your-project",
+    "preset": "standard",
+    "paths": {
+      "source": ["src"]
+    }
+  }
+}
+```
+
+monorepo など複数ディレクトリを持つ場合は配列で列挙:
+
+```json
+{
+  "project": {
+    "paths": {
+      "source": ["apps/web/src", "apps/api/src", "packages/shared/src"]
+    }
+  }
+}
+```
+
+この設定を忘れると、phase-gate は `scripts/harness/` 配下しか見ないため、
+retrofit 対象の新規コード作成が block されず、結果として **phasegate が
+無効化された運用** になってしまう（ISSUE-007 Wave 8 で schema 上 overridable
+になるまで、この設定は config validator で拒否されていた）。
 
 ---
 
@@ -70,14 +107,18 @@ gate 対象になる（後付け導入では推奨しない）。
 npx phasegate baseline
 ```
 
-実行すると、現時点の全 TS/JS ソースファイルの相対パスと sha1 ハッシュを
-`.phasegate/baseline.json` に保存する。
+実行すると、デフォルト glob (`scripts/**/*.ts` / `src/**/*.{ts,tsx,js,jsx}` /
+`docs/product/construction/**/*.md` / `docs/inception/**/*.md`) にマッチする
+ファイルの相対パスと sha1 ハッシュを `.phasegate/baseline.json` に保存する
+（`**/__tests__/**` / `*.test.ts` / `*.spec.ts` / `node_modules/**` / `dist/**`
+は既定で除外）。
 
 ```jsonc
 {
-  "version": 1,
-  "createdAt": "2026-04-22T10:00:00Z",
-  "entries": [
+  "version": "1.0",
+  "createdAt": "2026-04-22T10:00:00.000Z",
+  "algorithm": "sha1",
+  "files": [
     { "path": "src/foo.ts", "sha1": "abc123..." },
     { "path": "src/bar.ts", "sha1": "def456..." }
   ]
@@ -90,7 +131,32 @@ npx phasegate baseline
 npx phasegate baseline --dry-run --json
 ```
 
-### 特定ディレクトリだけ登録
+出力 (抜粋):
+
+```json
+{
+  "savedPath": "/path/to/.phasegate/baseline.json",
+  "entryCount": 12,
+  "dryRun": true,
+  "overwriteBlocked": false,
+  "files": [
+    { "path": "src/foo.ts", "sha1": "abc123..." }
+  ]
+}
+```
+
+v0.71.0 で CLI 出力の key は保存ファイルと同じ `files` に統一された（以前の
+`entries` は deprecated）。
+
+### 再生成（`.phasegate/baseline.json` を上書き）
+
+`baseline` は既存スナップショットがあると既定で上書きを拒否する（exit 2）:
+
+```bash
+npx phasegate baseline --force   # 明示的に上書き
+```
+
+### 特定 glob だけ登録
 
 ```bash
 npx phasegate baseline --paths "src/**/*.ts,scripts/**/*.ts"
@@ -212,8 +278,13 @@ Unit の設計文書が揃い、phasegate フル管理に昇格させたい場
 
 ### Q. `baseline` 作成後も gate が発火する
 
-**確認**: `phasegate.config.json` の `baseline.enabled` が `true` か。
-`baseline.path` と実ファイルの配置が一致しているか。
+**確認**:
+- v0.71.0 未満を使っていないか（v0.70.0 以前は `baseline.enabled` の default が
+  `false` で、`phasegate.config.json` に明示指定が必要だった）
+- `phasegate.config.json` で `baseline.enabled: false` を**明示**していないか
+- `baseline.path` と実ファイルの配置が一致しているか
+- 発火したファイルが baseline に登録されているか（`.phasegate/baseline.json` で
+  確認）。default glob から外れたパスは未登録の可能性が高い
 
 ### Q. scaffold した直後に L1 lint が失敗する
 

package/package.json

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

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

@@ -32,6 +32,35 @@
             "standard",
             "strict"
           ]
+        },
+        "paths": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "source": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "docs": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "construction": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "inception": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          }
         }
       }
     },