phasegate 0.31.0 → 0.39.0

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

@@ -292,3 +292,102 @@ export async function initHarnessConfig(
   await fs.writeFile(configPath, JSON.stringify(template, null, 2) + '\n', 'utf-8');
   return { created: true, path: configPath };
 }
+
+export interface DeployDesignDocsResult {
+  copiedFiles: string[];
+  skippedFiles: string[];
+}
+
+/**
+ * 設計原則ドキュメントを対象プロジェクトの docs/ にデプロイする。
+ * - docs/folder_management_rules.md → <projectRoot>/docs/folder_management_rules.md
+ * - docs/principles/*.md → <projectRoot>/docs/principles/*.md
+ * 既存ファイルは上書きせずスキップする。
+ */
+export async function deployDesignDocs(
+  harnessRoot: string,
+  projectRoot: string,
+): Promise<DeployDesignDocsResult> {
+  const copiedFiles: string[] = [];
+  const skippedFiles: string[] = [];
+  const docsTargetDir = join(projectRoot, 'docs');
+  const principlesTargetDir = join(docsTargetDir, 'principles');
+
+  await fs.mkdir(docsTargetDir, { recursive: true });
+  await fs.mkdir(principlesTargetDir, { recursive: true });
+
+  const folderRulesRelativePath = join('docs', 'folder_management_rules.md');
+  const folderRulesSource = join(harnessRoot, folderRulesRelativePath);
+  const folderRulesTarget = join(projectRoot, folderRulesRelativePath);
+
+  try {
+    await fs.access(folderRulesTarget);
+    skippedFiles.push(folderRulesRelativePath);
+  } catch {
+    try {
+      await fs.access(folderRulesSource);
+      await fs.copyFile(folderRulesSource, folderRulesTarget);
+      copiedFiles.push(folderRulesRelativePath);
+    } catch {
+      // 配置元が存在しない場合はスキップ
+    }
+  }
+
+  const principlesSourceDir = join(harnessRoot, 'docs', 'principles');
+
+  try {
+    const principleEntries = await fs.readdir(principlesSourceDir, { withFileTypes: true });
+    const principleFiles = principleEntries
+      .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
+      .map((entry) => entry.name)
+      .sort();
+
+    for (const principleFile of principleFiles) {
+      const relativePath = join('docs', 'principles', principleFile);
+      const sourcePath = join(principlesSourceDir, principleFile);
+      const targetPath = join(projectRoot, relativePath);
+
+      try {
+        await fs.access(targetPath);
+        skippedFiles.push(relativePath);
+      } catch {
+        await fs.copyFile(sourcePath, targetPath);
+        copiedFiles.push(relativePath);
+      }
+    }
+  } catch {
+    // principles ディレクトリが存在しない場合はスキップ
+  }
+
+  return { copiedFiles, skippedFiles };
+}
+
+export interface DeployHuskyHookResult {
+  created: boolean;
+  path: string;
+}
+
+/**
+ * husky pre-commit フックを対象プロジェクトの .husky/ にデプロイする。
+ * 既存があればスキップする。実行権限 0o755 を付与する。
+ */
+export async function deployHuskyHook(
+  harnessRoot: string,
+  projectRoot: string,
+): Promise<DeployHuskyHookResult> {
+  const targetPath = join(projectRoot, '.husky', 'pre-commit');
+
+  try {
+    await fs.access(targetPath);
+    return { created: false, path: targetPath };
+  } catch {
+    // 配置先が存在しない場合は新規作成
+  }
+
+  const sourcePath = join(harnessRoot, 'templates', '.husky', 'pre-commit');
+  await fs.mkdir(join(projectRoot, '.husky'), { recursive: true });
+  await fs.copyFile(sourcePath, targetPath);
+  await fs.chmod(targetPath, 0o755);
+
+  return { created: true, path: targetPath };
+}

package/skills/environment-designer/SKILL.md

@@ -68,7 +68,7 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/implementation-planner/SKILL.md

@@ -26,7 +26,7 @@ UnitドキュメントとConstructionのドメインモデル設計を元に、*
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/it-test-designer/SKILL.md

@@ -18,7 +18,7 @@ review: opus
 ### 任意インプット（あれば参照）
 - **ドメインモデル** — `docs/product/construction/{unit}/domain_model.md`
 - **環境設計** — `docs/product/environment_contract.md`
-- **テスト規約** — `docs/principles/testing_rules.md`
+- **テスト規約** — `docs/principles/testing-rules.md`
 - **既存ITテスト** — 既存パターンの参考
 
 ---
@@ -68,7 +68,7 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
@@ -183,7 +183,7 @@ ITテスト設計のスコープ・テスト対象・不明点を整理し、人
 - **テストコードは生成しない**（設計文書のみ）— 実装は `story-implementor` スキル（codex-delegator経由、またはメインセッションで直接実行）が行う
 - 論理設計のすべてのユースケース・エンドポイントをカバーする
 - TDDプロセスの「正しくRED」になる状態を目指す設計を行う
-- テスト規約（`docs/principles/testing_rules.md`）がある場合は遵守する
+- テスト規約（`docs/principles/testing-rules.md`）がある場合は遵守する
 - AAAパターン（Arrange-Act-Assert）を前提としたケース設計を行う
 
 ---

package/skills/it-test-logic-designer/SKILL.md

@@ -38,7 +38,7 @@ TDD実装フェーズ
 ### 推奨インプット（あれば参照）
 - **カバレッジレポート** — `docs/product/construction/{unit}/coverage_report.md`
 - **既存ITテスト** — `backend/test/integration/**/*.test.ts`（パターン参考）
-- **テスト規約** — `docs/principles/testing_rules.md`
+- **テスト規約** — `docs/principles/testing-rules.md`
 - **ストーリー固有論理設計** — `docs/inception/{unit}/{story_id}/logical_design.md`
 
 ---
@@ -71,7 +71,7 @@ TDD実装フェーズ
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/mock-designer/SKILL.md

@@ -64,7 +64,7 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/scenario-test-designer/SKILL.md

@@ -17,7 +17,7 @@ review: opus
 
 ### 任意インプット（あれば参照）
 - **UIモック** — `/mock/*.html`（画面フローの参考）
-- **テスト規約** — `docs/principles/testing_rules.md`
+- **テスト規約** — `docs/principles/testing-rules.md`
 - **既存シナリオテスト** — 既存パターンの参考
 
 ---
@@ -95,7 +95,7 @@ story-implementor ← TDD実装
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
@@ -200,7 +200,7 @@ story-implementor ← TDD実装
 - **テストコードは生成しない**（設計文書のみ）— 実装は `story-implementor` スキル（codex-delegator経由、またはメインセッションで直接実行）が行う
 - 受け入れ基準を漏れなくカバーする
 - TDDプロセスの「正しくRED」になる状態を目指す設計を行う
-- テスト規約（`docs/principles/testing_rules.md`）がある場合は遵守する
+- テスト規約（`docs/principles/testing-rules.md`）がある場合は遵守する
 - Playwrightの使用を前提とする（プロジェクト固有の要件がある場合は調整）
 
 ---

package/skills/scenario-test-logic-designer/SKILL.md

@@ -37,7 +37,7 @@ TDD実装フェーズ
 - **カバレッジレポート** — `docs/product/construction/{unit}/coverage_report.md`
 - **既存シナリオテスト** — `e2e/tests/**/*.spec.ts`（パターン参考）
 - **UIUX設計** — `docs/inception/{unit}/{story_id}/uiux_design.md`
-- **テスト規約** — `docs/principles/testing_rules.md`
+- **テスト規約** — `docs/principles/testing-rules.md`
 
 ---
 
@@ -62,7 +62,7 @@ TDD実装フェーズ
 ## 3フェーズ実行ルール
 
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/story-mapper/SKILL.md

@@ -65,7 +65,7 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/story-writer/SKILL.md

@@ -24,7 +24,7 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/unit-designer/SKILL.md

@@ -64,7 +64,7 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/skills/unit-test-designer/SKILL.md

@@ -16,7 +16,7 @@ review: opus
 
 ### 任意インプット（あれば参照）
 - **論理設計** — `docs/product/construction/{unit}/logical_design.md`
-- **テスト規約** — `docs/principles/testing_rules.md`
+- **テスト規約** — `docs/principles/testing-rules.md`
 - **既存ユニットテスト** — 既存パターンの参考
 
 ---
@@ -77,7 +77,7 @@ story-implementor ← TDD実装
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
@@ -182,7 +182,7 @@ story-implementor ← TDD実装
 - **テストコードは生成しない**（設計文書のみ）— 実装は `story-implementor` スキル（codex-delegator経由、またはメインセッションで直接実行）が行う
 - ドメインモデルの不変条件を漏れなくカバーする
 - TDDプロセスの「正しくRED」になる状態を目指す設計を行う
-- テスト規約（`docs/principles/testing_rules.md`）がある場合は遵守する
+- テスト規約（`docs/principles/testing-rules.md`）がある場合は遵守する
 - Vitest/Jest等のテストフレームワークを前提とする
 
 ---

package/skills/unit-test-logic-designer/SKILL.md

@@ -36,7 +36,7 @@ TDD実装フェーズ
 ### 推奨インプット（あれば参照）
 - **カバレッジレポート** — `docs/product/construction/{unit}/coverage_report.md`
 - **既存ユニットテスト** — `backend/test/unit/**/*.test.ts`（パターン参考）
-- **テスト規約** — `docs/principles/testing_rules.md`
+- **テスト規約** — `docs/principles/testing-rules.md`
 
 ---
 
@@ -60,7 +60,7 @@ TDD実装フェーズ
 ## 3フェーズ実行ルール
 
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
 **Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**

package/templates/.claude/settings.json

@@ -15,7 +15,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx tsx scripts/harness/agent-integration/presentation/pre-tool-use-hook.ts"
+            "command": "npx phasegate hook pre-tool-use"
           }
         ]
       }
@@ -38,7 +38,7 @@
           },
           {
             "type": "command",
-            "command": "npx tsx scripts/harness/agent-integration/presentation/post-tool-use-hook.ts"
+            "command": "npx phasegate hook post-tool-use"
           }
         ]
       }
@@ -49,7 +49,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx tsx scripts/harness/agent-integration/presentation/stop-hook.ts"
+            "command": "npx phasegate hook stop"
           }
         ]
       }

package/templates/.husky/pre-commit

@@ -1,2 +1,2 @@
 npx lint-staged
-npx tsx scripts/harness/integrations/pre-commit.ts
+npx phasegate pre-commit

package/templates/phasegate.config.json

@@ -1,30 +0,0 @@
-{
-  "version": "1.0",
-  "preset": "standard",
-  "project": {
-    "name": "my-project",
-    "architecture": "clean-architecture",
-    "paths": {
-      "source": [
-        "backend/src",
-        "frontend/src"
-      ],
-      "docs": {
-        "units": "docs/product/units",
-        "inception": "docs/inception",
-        "construction": "docs/product/construction"
-      }
-    },
-    "naming": {
-      "fileCase": "kebab-case",
-      "classCase": "PascalCase",
-      "unitToPath": "kebab-to-snake"
-    }
-  },
-  "layers": {
-    "L1_editor": { "enabled": true },
-    "L2_precommit": { "enabled": true },
-    "L3_ci": { "enabled": true },
-    "L4_scheduled": { "enabled": false }
-  }
-}