phasegate 0.135.0 → 0.136.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.136.0] - 2026-05-09
+
+### Added
+
+- **WI-031 — CI template の二系統統一 + `phasegate init --with-ci`** — `ci:generate-template --render` が bundled template を正本として stdout に出力するようにし、`phasegate init --with-ci` で `.github/workflows/aidlc-gate.yml` と `.github/workflows/consistency-check.yml` を opt-in 配置できるようにした。
+  - `docs/templates/ci/{aidlc-gate,consistency-check}.yml` と `docs/templates/hooks/pre-commit` を render の正本に統一。
+  - `consistency-check` の cron と GitHub Issue 自動作成 logic が CLI render と bundled template で一致。
+  - 既存 workflow は上書きせず skipped として扱い、新規 config 作成時は `ci.enabled: true` を保存。
+  - `docs/templates/**` を npm package 同梱対象に追加。
+
+### Fixed
+
+- **WI-031 / WI-097 — inception 配下の WI ID 重複を解消** — `_cross/WI-031` と `agent-integration/WI-031` が別内容で同一 ID を持っていたため、H11-04 由来の agent-integration 側を `WI-097` に再採番した。
+  - `legacy_id: H11-04` は維持し、agent-integration の product docs に `@work-item-id WI-097` を追記。
+  - 再発防止の follow-up として `WI-106`（inception 全体での WI ID 重複防止）を起票。
+
 ## [0.135.0] - 2026-05-09
 
 ### Added

package/README.ja.md

@@ -70,7 +70,7 @@ Node.js >= 18, npm >= 9, TypeScript 5.x
 npm install --save-dev phasegate
 
 # 2. プロジェクトを初期化
-npx phasegate init --name my-project --with-husky
+npx phasegate init --name my-project --with-husky --with-ci
 
 # 3. AI agent を起動して /product-architect から始める
 claude
@@ -87,6 +87,7 @@ claude
 - `docs/principles/*.md` — アーキテクチャ哲学・テスト規約（immutable）
 - `docs/folder_management_rules.md` — ドキュメント配置ルール（**正本**）
 - `--with-husky` を付けると `.husky/pre-commit` ・ `.husky/commit-msg` も配置
+- `--with-ci` を付けると `.github/workflows/aidlc-gate.yml` ・ `.github/workflows/consistency-check.yml` も配置
 
 **`init` が生成しないもの**（後で skill が作る）:
 
@@ -282,7 +283,7 @@ npx phasegate <command> [options]
 
 | コマンド | 説明 |
 |---|---|
-| `init --name <name>` | 初期化（skills/config/hooks 配置）。`--agent claude\|codex\|both`、`--with-husky`、`--preset <full\|standard\|minimal\|custom>` |
+| `init --name <name>` | 初期化（skills/config/hooks 配置）。`--agent claude\|codex\|both`、`--with-husky`、`--with-ci`、`--preset <full\|standard\|minimal\|custom>` |
 | `update-skills` | スキルを最新版に再デプロイ |
 | `lint` | L1 Biome AST チェック |
 | `validate --layer <L1\|L2\|L3\|L4\|all>` | 指定レイヤーのバリデータ実行（`--format human\|agent\|ci`） |
@@ -295,7 +296,7 @@ npx phasegate <command> [options]
 | `phasegate:detect-drift` | 設計-コード乖離レポート |
 | `migrate work-items --dry-run` / `--apply` | 既存リポジトリの旧 `ISSUE-XXX` / `H{NN}-{NN}` directory を WI 統一レイアウト（`_cross/{WI-XXX}/` / `{unit}/{WI-XXX}/`）へ移行。frontmatter（`type` / `severity` / `legacy_id` / `affects`）を自動注入。冪等。`--json` で CI/スクリプト連携可。詳細: [Work Item Migration](docs/guide/cli-reference.md#work-item-migration) |
 | `migrate --schema v3` | `phasegate.config.json` を v3 schema へ昇格（`architecture` キー追加） |
-| `ci:generate-template --type <aidlc-gate\|pre-commit\|consistency-check>` | CI/CD テンプレート生成（`--render` でファイル出力） |
+| `ci:generate-template --type <aidlc-gate\|pre-commit\|consistency-check>` | CI/CD テンプレート生成（`--render` で bundled template を stdout 出力） |
 | `list-errors --layer <L0-L4>` | エラー定義一覧 |
 | `hook <pre-tool-use\|post-tool-use\|stop>` | agent hook を起動（stdin から JSON） |
 | `pre-commit` | L2 pre-commit バリデータをステージファイルに適用 |
@@ -451,7 +452,6 @@ reports/
 
 | Work Item | 内容 |
 |---|---|
-| **[WI-031](docs/inception/_cross/WI-031/description.md)** | CI template の二系統統一 + `phasegate init --with-ci` |
 | **[WI-032](docs/inception/_cross/WI-032/description.md)** | AGENTS.md / CLAUDE.md auto-refresh パイプライン |
 | **[WI-033](docs/inception/_cross/WI-033/description.md)** | `doc-freshness` / `pointer-validation` を L4 validator に昇格 |
 

package/README.md

@@ -71,7 +71,7 @@ Node.js >= 18, npm >= 9, TypeScript 5.x
 npm install --save-dev phasegate
 
 # 2. Initialize the project
-npx phasegate init --name my-project --with-husky
+npx phasegate init --name my-project --with-husky --with-ci
 
 # 3. Start your AI agent and begin with product design
 claude
@@ -86,6 +86,7 @@ claude
 - `.claude/settings.json` and/or `.codex/hooks.json` hook configuration
 - `docs/principles/*.md` and `docs/folder_management_rules.md`
 - `.husky/pre-commit` and `.husky/commit-msg` when `--with-husky` is passed
+- `.github/workflows/aidlc-gate.yml` and `.github/workflows/consistency-check.yml` when `--with-ci` is passed
 
 `init` intentionally does **not** create `docs/inception/` work item directories or `docs/product/` design documents. Those are produced later by skills such as `/product-architect`, `/domain-designer`, and `/logical-designer`. That is the core contract: no design, no code.
 
@@ -463,10 +464,11 @@ npx phasegate <command> [options]
 
 | Command | Description |
 |---|---|
-| `init --name <name>` | Initialize project, deploy skills, generate config |
+| `init --name <name>` | Initialize project, deploy skills, generate config. Use `--with-ci` to deploy GitHub Actions workflows. |
 | `lint` | Run L1 Biome AST checks |
 | `validate --layer <L2-L4\|all>` | Run validators for specified layer (`--layer L0` prints runtime hook guidance) |
 | `ci-check` | Full CI check (L2-L4) |
+| `ci:generate-template --type <aidlc-gate\|consistency-check\|pre-commit> --render` | Render the bundled CI/hook template to stdout |
 | `update-skills` | Update skills to latest version |
 | `phasegate:status` | Display overall harness health summary |
 | `phasegate:check-phase --unit <id>` | Check current phase for a Unit |
@@ -512,7 +514,6 @@ The main path is ready for project use, but a few documented behaviors still req
 
 | Work Item | Title | Why it matters |
 |---|---|---|
-| **[WI-031](docs/inception/_cross/WI-031/description.md)** | CI template unification + `phasegate init --with-ci` | Today the bundled YAML and the `ci:generate-template` output diverge (different cron schedule, only the bundled one creates GitHub Issues). `phasegate init` does not deploy the workflow, so L4 only runs after the user manually copies the file. WI-031 unifies the two paths and adds an opt-in deploy flag. |
 | **[WI-032](docs/inception/_cross/WI-032/description.md)** | AGENTS.md / CLAUDE.md auto-refresh pipeline | `ci:migrate-agents-md` exists as a one-shot CLI but there is no scheduled job, and CLAUDE.md is fully hand-maintained. WI-032 adds an `auto-refresh-agent-context` workflow plus a template-driven CLAUDE.md regenerator that preserves user-owned sections. |
 | **[WI-033](docs/inception/_cross/WI-033/description.md)** | Promote `doc-freshness` / `pointer-validation` to L4 validators | Both capabilities exist as `p2:check-freshness` / `p2:validate-pointers` CLI commands but are not registered as L4 validators, so `validate --layer L4` skips them. WI-033 plumbs them through `validator-system` so they run via the standard L4 path and presets. |
 

package/docs/templates/ci/aidlc-gate.yml

@@ -0,0 +1,97 @@
+# Phasegate — PR検証ワークフロー
+#
+# 使い方:
+#   このファイルを .github/workflows/aidlc-gate.yml にコピーして使用する。
+#
+# 実行タイミング: Pull Request（open / synchronize / reopen）
+# 実行内容:
+#   1. harness:lint  — L1 Biome AST ルール検証
+#   2. harness:ci-check — L3 CI バリデータ（security / performance / coverage / nyquist）
+#   3. 失敗時: PR にエラーサマリーをコメント
+
+name: AIDLC Quality Gate
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  harness-gate:
+    name: Harness Quality Gate
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write   # PRコメント書き込みに必要
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        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
+
+      # L1: Biome AST ルール
+      - name: L1 Lint (Biome AST)
+        id: lint
+        run: |
+          set +e
+          RESULT=$(pnpm run harness lint --json 2>&1)
+          EXIT_CODE=$?
+          echo "result<<EOF" >> $GITHUB_OUTPUT
+          echo "$RESULT" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+          echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
+          exit $EXIT_CODE
+
+      # L3: CI バリデータ（security / performance / coverage / nyquist）
+      - name: L3 CI Check
+        id: ci_check
+        if: always()
+        run: |
+          set +e
+          RESULT=$(pnpm run harness harness:ci-check --json 2>&1)
+          EXIT_CODE=$?
+          echo "result<<EOF" >> $GITHUB_OUTPUT
+          echo "$RESULT" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+          echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
+          exit $EXIT_CODE
+
+      # 失敗時のみ PR にコメント
+      - name: Post failure comment
+        if: failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const lintResult   = `${{ steps.lint.outputs.result }}`;
+            const ciResult     = `${{ steps.ci_check.outputs.result }}`;
+            const lintFailed   = '${{ steps.lint.outputs.exit_code }}' !== '0';
+            const ciFailed     = '${{ steps.ci_check.outputs.exit_code }}' !== '0';
+
+            let body = '## ❌ AIDLC Quality Gate — 失敗\n\n';
+
+            if (lintFailed) {
+              body += '### L1 Lint エラー\n```json\n' + lintResult + '\n```\n\n';
+            }
+            if (ciFailed) {
+              body += '### L3 CI Check エラー\n```json\n' + ciResult + '\n```\n\n';
+            }
+
+            body += '---\n> 修正方法は各 `HarnessError.suggestion` および `HarnessError.fix_example` を参照してください。';
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body,
+            });

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

@@ -0,0 +1,117 @@
+# Phasegate — 週次整合性チェックワークフロー
+#
+# 使い方:
+#   このファイルを .github/workflows/consistency-check.yml にコピーして使用する。
+#
+# 実行タイミング: 毎週月曜 09:00 UTC（手動トリガーも可）
+# 実行内容:
+#   1. harness:detect-drift   — L4 設計⇔コード乖離検出（drift-detect）
+#   2. harness:complete-check — L4 全バリデータ（drift-detect / consistency-check / dead-code）
+#   3. 乖離検出時: GitHub Issue を自動作成
+
+name: AIDLC Consistency Check (Weekly)
+
+on:
+  schedule:
+    - cron: '0 9 * * 1'   # 毎週月曜 09:00 UTC
+  workflow_dispatch:       # 手動トリガー
+
+jobs:
+  consistency-check:
+    name: L4 Consistency & Drift Check
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write   # Issue 自動作成に必要
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        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
+
+      # L4-001: Drift Detection（設計⇔コード双方向乖離）
+      - name: L4 Drift Detection
+        id: drift
+        run: |
+          set +e
+          RESULT=$(pnpm run harness harness:detect-drift --json 2>&1)
+          EXIT_CODE=$?
+          echo "result<<EOF" >> $GITHUB_OUTPUT
+          echo "$RESULT" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+          echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
+          exit 0   # Issue作成のため常に続行
+
+      # L4: 全バリデータ（drift-detect + consistency-check + dead-code）
+      - name: L4 Complete Check
+        id: complete
+        run: |
+          set +e
+          RESULT=$(pnpm run harness harness:complete-check --json 2>&1)
+          EXIT_CODE=$?
+          echo "result<<EOF" >> $GITHUB_OUTPUT
+          echo "$RESULT" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+          echo "exit_code=$EXIT_CODE" >> $GITHUB_OUTPUT
+          exit 0   # Issue作成のため常に続行
+
+      # 乖離が検出された場合のみ Issue を作成
+      - name: Create issue on drift detected
+        if: |
+          steps.drift.outputs.exit_code != '0' ||
+          steps.complete.outputs.exit_code != '0'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const driftResult    = `${{ steps.drift.outputs.result }}`;
+            const completeResult = `${{ steps.complete.outputs.result }}`;
+            const driftFailed    = '${{ steps.drift.outputs.exit_code }}' !== '0';
+            const completeFailed = '${{ steps.complete.outputs.exit_code }}' !== '0';
+
+            const today = new Date().toISOString().slice(0, 10);
+            let body = `## 🔍 AIDLC 整合性チェック結果 — ${today}\n\n`;
+            body += '> 週次スケジュール実行により設計⇔コードの乖離が検出されました。\n\n';
+
+            if (driftFailed) {
+              body += '### L4-001 Drift Detection\n```json\n' + driftResult + '\n```\n\n';
+            }
+            if (completeFailed) {
+              body += '### L4 Complete Check\n```json\n' + completeResult + '\n```\n\n';
+            }
+
+            body += '---\n';
+            body += '### 対処方法\n';
+            body += '1. 乖離の内容を確認し、設計文書またはコードのどちらを修正すべきか判断\n';
+            body += '2. `cascade-updater` スキルで設計文書を更新、または実装を修正\n';
+            body += '3. `pnpm run harness harness:detect-drift` で再検証して乖離が解消されたことを確認\n';
+
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: `[AIDLC] 設計⇔コード乖離検出 (${today})`,
+              body,
+              labels: ['aidlc', 'drift-detected', 'automated'],
+            });
+
+      - name: Summary
+        run: |
+          DRIFT_CODE="${{ steps.drift.outputs.exit_code }}"
+          COMPLETE_CODE="${{ steps.complete.outputs.exit_code }}"
+          if [ "$DRIFT_CODE" = "0" ] && [ "$COMPLETE_CODE" = "0" ]; then
+            echo "✅ 設計⇔コード整合性: 問題なし"
+          else
+            echo "❌ 乖離を検出しました。GitHub Issue を確認してください。"
+            exit 1
+          fi

package/docs/templates/hooks/commit-msg

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+# PhaseGate commit-msg hook template.
+#
+# Usage:
+#   1. Copy this file to .husky/commit-msg
+#   2. chmod +x .husky/commit-msg
+#
+# The hook validates commit-message trailers that require access to the final
+# commit message, such as `Work-Item: WI-XXX` for WI document changes.
+
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx phasegate commit-msg "$1"

package/docs/templates/hooks/pre-commit

@@ -0,0 +1,62 @@
+#!/usr/bin/env sh
+# GSDLC Quality Harness — Pre-commit Hook テンプレート
+#
+# 使い方:
+#   1. このファイルを .husky/pre-commit にコピーする
+#   2. chmod +x .husky/pre-commit
+#   3. pnpm add --save-dev husky && npx husky install
+#
+# 実行内容:
+#   L1: Biome AST ルール（require-unit-comment, no-layer-violation など 8ルール）
+#   L2: Pre-commit バリデータ（phase-gate / metadata / test-quality）
+#
+# ⚠️  Quick Mode の場合は HARNESS_QUICK_MODE=1 を設定してコミットする:
+#   HARNESS_QUICK_MODE=1 git commit -m "fix: ..."
+
+. "$(dirname -- "$0")/_/husky.sh"
+
+HARNESS_CMD="npx tsx scripts/harness/main.ts"
+
+echo "🔍 AIDLC Quality Gate (Pre-commit)"
+echo "──────────────────────────────────"
+
+# -----------------------------------------------------------------------
+# L1: Biome AST ルール
+# -----------------------------------------------------------------------
+echo "▶ L1 Lint (Biome AST)..."
+$HARNESS_CMD lint
+L1_EXIT=$?
+
+if [ $L1_EXIT -ne 0 ]; then
+  echo ""
+  echo "❌ L1 Lint が失敗しました。"
+  echo "   修正してから再度コミットしてください。"
+  echo "   詳細: pnpm run harness lint"
+  exit 1
+fi
+echo "✅ L1 Lint: passed"
+
+# -----------------------------------------------------------------------
+# L2: Pre-commit バリデータ
+# -----------------------------------------------------------------------
+# Quick Mode では phase-gate をスキップ
+if [ "${HARNESS_QUICK_MODE:-0}" = "1" ]; then
+  echo "▶ L2 Validators (Quick Mode: phase-gate スキップ)..."
+  $HARNESS_CMD check-phase-gate --skip-phase-gate
+else
+  echo "▶ L2 Validators (phase-gate / metadata / test-quality)..."
+  $HARNESS_CMD check-phase-gate
+fi
+L2_EXIT=$?
+
+if [ $L2_EXIT -ne 0 ]; then
+  echo ""
+  echo "❌ L2 Validators が失敗しました。"
+  echo "   修正してから再度コミットしてください。"
+  echo "   詳細: pnpm run harness check-phase-gate"
+  exit 1
+fi
+echo "✅ L2 Validators: passed"
+
+echo "──────────────────────────────────"
+echo "✅ AIDLC Quality Gate: passed"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.135.0",
+  "version": "0.136.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",
@@ -38,6 +38,7 @@
     "docs/contracts/**",
     "docs/principles/**",
     "docs/guide/**",
+    "docs/templates/**",
     "docs/folder_management_rules.md",
     "LICENSE",
     "CHANGELOG.md"

package/scripts/harness/ci-governance/composition-root.ts

@@ -70,7 +70,7 @@ export function buildCiGovernance(
   const presetConfigAdapter = new PresetConfigAdapter();
   const errorRepetitionRepository = new ErrorRepetitionJsonRepository(baseDir);
   const escalationExecutorPort = new EscalationLogExecutorAdapter();
-  const templateRendererPort = new YamlTemplateRendererAdapter();
+  const templateRendererPort = new YamlTemplateRendererAdapter(harnessRoot);
   const fileExistencePort = new FileSystemExistenceAdapter(baseDir);
   const commandExistencePort = new HarnessApiCommandExistenceAdapter();
   const adrExistencePort = new AdrFoundationExistenceAdapter();

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

@@ -5,6 +5,8 @@
  * TemplateRendererPort実装（YAML書き出し）
  */
 
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
 import type { TemplateRendererPort, TemplateRenderOutput } from '../../domain/ports/template-renderer-port.js';
 import type { CiTemplate } from '../../domain/aggregates/ci-template.js';
 
@@ -14,40 +16,21 @@ const OUTPUT_PATH_MAP: Record<string, string> = {
   'pre-commit': '.husky/pre-commit',
 };
 
+const TEMPLATE_PATH_MAP: Record<string, string> = {
+  'aidlc-gate': 'docs/templates/ci/aidlc-gate.yml',
+  'consistency-check': 'docs/templates/ci/consistency-check.yml',
+  'pre-commit': 'docs/templates/hooks/pre-commit',
+};
+
 export class YamlTemplateRendererAdapter implements TemplateRendererPort {
+  constructor(private readonly harnessRoot: string = process.cwd()) {}
+
   async render(ciTemplate: CiTemplate): Promise<TemplateRenderOutput> {
     const outputPath = OUTPUT_PATH_MAP[ciTemplate.templateType] ?? '';
-    const content = this.generateContent(ciTemplate);
+    const templatePath = TEMPLATE_PATH_MAP[ciTemplate.templateType];
+    const content = templatePath === undefined
+      ? `# ${ciTemplate.templateType} template (not configured)`
+      : await readFile(join(this.harnessRoot, templatePath), 'utf-8');
     return { outputPath, content };
   }
-
-  private generateContent(ciTemplate: CiTemplate): string {
-    const { templateType, config } = ciTemplate;
-
-    if (!config) {
-      return `# ${templateType} template (not configured)`;
-    }
-
-    if (templateType === 'pre-commit') {
-      return [
-        '#!/bin/sh',
-        '. "$(dirname "$0")/_/husky.sh"',
-        '',
-        `npx phasegate lint --validators ${config.targetValidatorIds.join(',')}`,
-      ].join('\n');
-    }
-
-    return [
-      `name: ${templateType}`,
-      `on:`,
-      `  ${config.triggerCondition === 'pull_request' ? 'pull_request' : 'schedule'}:`,
-      config.triggerCondition === 'schedule' ? '    - cron: "0 2 * * *"' : '',
-      `jobs:`,
-      `  validate:`,
-      `    runs-on: ubuntu-latest`,
-      `    steps:`,
-      `      - uses: actions/checkout@v4`,
-      `      - run: npx phasegate lint --validators ${config.targetValidatorIds.join(',')}`,
-    ].filter((l) => l !== '').join('\n');
-  }
 }

package/scripts/harness/ci-governance/presentation/handlers/generate-ci-template-handler.ts

@@ -31,7 +31,25 @@ export class GenerateCiTemplateHandler {
   ) {}
 
   async handle(args: GenerateCiTemplateHandlerArgs): Promise<GenerateCiTemplateHandlerResult> {
-    const { presetId, templateType, format = 'human' } = args;
+    const { presetId, templateType, render = false, format = 'human' } = args;
+
+    if (render) {
+      const result = await this.renderUseCase.execute({
+        presetId,
+        templateType: templateType as TemplateType,
+      });
+      const hasErrors = result.errors.length > 0;
+      const output = format === 'json'
+        ? JSON.stringify(result, null, 2)
+        : hasErrors
+          ? result.errors.map((err) => `[${err.code}] ${err.message}`).join('\n')
+          : result.content;
+
+      return {
+        exitCode: hasErrors ? 1 : 0,
+        output,
+      };
+    }
 
     const result = await this.generateUseCase.execute({
       presetId,

package/scripts/harness/main.ts

@@ -41,6 +41,7 @@ import type { SkillSet } from "./setup/skill-deployer.js";
 import {
   deployAgentSkillLinks,
   deployCodexHooks,
+  deployCiWorkflows,
   deployDesignDocs,
   deployHookScripts,
   deployHuskyCommitMsgHook,
@@ -89,7 +90,7 @@ 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>, --with-husky, --yes)
+                                --skills <core|all>, --agent <claude|codex|both>, --with-husky, --with-ci, --yes)
   update-skills                Re-deploy skills from current harness version
 
 Commands:
@@ -251,6 +252,7 @@ Options:
   --skills <core|all>             Skill set to deploy (default: "all")
   --agent <claude|codex|both>     Agent integration target (default: "claude")
   --with-husky                    Install Husky pre-commit hooks
+  --with-ci                       Install GitHub Actions workflows
   --yes                           Skip confirmation prompts
   --help, -h                      Show this help`,
   "update-skills": `Usage: phasegate update-skills [options]
@@ -636,7 +638,7 @@ async function main(): Promise<void> {
     switch (command) {
       // ── harness setup ──
       case "init": {
-        const KNOWN_INIT_FLAGS = ["--name", "--preset", "--skills", "--agent", "--with-husky", "--yes"];
+        const KNOWN_INIT_FLAGS = ["--name", "--preset", "--skills", "--agent", "--with-husky", "--with-ci", "--yes"];
         const flagError = validateKnownFlags(args, KNOWN_INIT_FLAGS);
         if (flagError) {
           console.error(flagError);
@@ -674,7 +676,8 @@ async function main(): Promise<void> {
           claude: deployClaude,
           codex: deployCodex,
         });
-        const configResult = await initHarnessConfig(rootDir, projectName, phasePreset);
+        const withCi = hasFlag(args, "--with-ci");
+        const configResult = await initHarnessConfig(rootDir, projectName, phasePreset, { ciEnabled: withCi });
         const hooksResult = deployClaude
           ? await deployHookScripts(harnessRoot, rootDir)
           : {
@@ -689,6 +692,7 @@ async function main(): Promise<void> {
         const withHusky = hasFlag(args, "--with-husky");
         const huskyResult = withHusky ? await deployHuskyHook(harnessRoot, rootDir) : null;
         const huskyCommitMsgResult = withHusky ? await deployHuskyCommitMsgHook(harnessRoot, rootDir) : null;
+        const ciWorkflowResult = withCi ? await deployCiWorkflows(harnessRoot, rootDir) : null;
         console.log(
           `✓ Skills deployed to ${result.targetDir} (${result.deployedSkills.length} skills, set: ${skillSet})`,
         );
@@ -753,6 +757,14 @@ async function main(): Promise<void> {
             console.log(`  .husky/commit-msg already exists, skipped`);
           }
         }
+        if (ciWorkflowResult !== null) {
+          if (ciWorkflowResult.copiedFiles.length > 0) {
+            console.log(`✓ CI workflows deployed (${ciWorkflowResult.copiedFiles.length} files)`);
+          }
+          for (const skipped of ciWorkflowResult.skippedFiles) {
+            console.log(`  ${skipped} already exists, skipped`);
+          }
+        }
         console.log(`✓ Harness v${result.version} initialized (agent: ${agent})`);
         console.log("");
         console.log("Next steps:");
@@ -1199,7 +1211,7 @@ Examples:
   phasegate ci:generate-template --preset strict --type pre-commit --render`);
           process.exit(0);
         }
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const presetId = parseFlag(args, "--preset") ?? "default";
         const templateType = parseFlag(args, "--type") ?? "aidlc-gate";
         const render = hasFlag(args, "--render");
@@ -1211,7 +1223,7 @@ Examples:
       }
 
       case "ci:migrate-agents-md": {
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const dryRun = hasFlag(args, "--dry-run");
         const validateOnly = hasFlag(args, "--validate-only");
         const format = json ? "json" : "human";
@@ -1222,7 +1234,7 @@ Examples:
       }
 
       case "ci:check-repetition": {
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const errorCode = parseFlag(args, "--code") ?? "";
         const reset = hasFlag(args, "--reset");
         const format = json ? "json" : "human";
@@ -1233,7 +1245,7 @@ Examples:
       }
 
       case "baseline": {
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const dryRun = hasFlag(args, "--dry-run");
         const force = hasFlag(args, "--force");
         const pathsFlag = parseFlag(args, "--paths");

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

@@ -420,10 +420,15 @@ export async function deployHookScripts(harnessRoot: string, projectRoot: string
   };
 }
 
+export interface InitHarnessConfigOptions {
+  ciEnabled?: boolean;
+}
+
 export async function initHarnessConfig(
   projectRoot: string,
   projectName: string,
   phasePreset?: "full" | "standard" | "minimal" | "custom",
+  options: InitHarnessConfigOptions = {},
 ): Promise<{ created: boolean; path: string }> {
   const configPath = join(projectRoot, HARNESS_CONFIG_FILE);
   try {
@@ -461,6 +466,7 @@ export async function initHarnessConfig(
       format: "json",
       outputDir: "reports",
     },
+    ...(options.ciEnabled ? { ci: { enabled: true } } : {}),
   };
 
   await fs.writeFile(configPath, JSON.stringify(template, null, 2) + "\n", "utf-8");
@@ -532,6 +538,46 @@ export interface DeployHuskyHookResult {
   path: string;
 }
 
+export interface DeployCiWorkflowsResult {
+  copiedFiles: string[];
+  skippedFiles: string[];
+}
+
+export async function deployCiWorkflows(harnessRoot: string, projectRoot: string): Promise<DeployCiWorkflowsResult> {
+  const copiedFiles: string[] = [];
+  const skippedFiles: string[] = [];
+  const workflows = [
+    {
+      relativeSource: join("docs", "templates", "ci", "aidlc-gate.yml"),
+      relativeTarget: join(".github", "workflows", "aidlc-gate.yml"),
+    },
+    {
+      relativeSource: join("docs", "templates", "ci", "consistency-check.yml"),
+      relativeTarget: join(".github", "workflows", "consistency-check.yml"),
+    },
+  ];
+
+  await fs.mkdir(join(projectRoot, ".github", "workflows"), { recursive: true });
+
+  for (const workflow of workflows) {
+    const sourcePath = join(harnessRoot, workflow.relativeSource);
+    const targetPath = join(projectRoot, workflow.relativeTarget);
+
+    try {
+      await fs.access(targetPath);
+      skippedFiles.push(workflow.relativeTarget);
+      continue;
+    } catch {
+      // ファイルが存在しない場合のみコピーする
+    }
+
+    await fs.copyFile(sourcePath, targetPath);
+    copiedFiles.push(workflow.relativeTarget);
+  }
+
+  return { copiedFiles, skippedFiles };
+}
+
 export async function deployHuskyHook(harnessRoot: string, projectRoot: string): Promise<DeployHuskyHookResult> {
   const targetPath = join(projectRoot, ".husky", "pre-commit");
 
@@ -540,7 +586,7 @@ export async function deployHuskyHook(harnessRoot: string, projectRoot: string):
     return { created: false, path: targetPath };
   } catch {}
 
-  const sourcePath = join(harnessRoot, "templates", ".husky", "pre-commit");
+  const sourcePath = join(harnessRoot, "docs", "templates", "hooks", "pre-commit");
   await fs.mkdir(join(projectRoot, ".husky"), { recursive: true });
   await fs.copyFile(sourcePath, targetPath);
   await fs.chmod(targetPath, 0o755);
@@ -559,7 +605,7 @@ export async function deployHuskyCommitMsgHook(
     return { created: false, path: targetPath };
   } catch {}
 
-  const sourcePath = join(harnessRoot, "templates", ".husky", "commit-msg");
+  const sourcePath = join(harnessRoot, "docs", "templates", "hooks", "commit-msg");
   await fs.mkdir(join(projectRoot, ".husky"), { recursive: true });
   await fs.copyFile(sourcePath, targetPath);
   await fs.chmod(targetPath, 0o755);

package/scripts/harness/traceability-model/domain/value-objects/work-item-frontmatter.ts

@@ -13,7 +13,8 @@ export type WorkItemStatus =
   | 'drafted'
   | 'reflected'
   | 'implemented'
-  | 'tested';
+  | 'tested'
+  | 'completed';
 
 export interface WorkItemFrontmatter {
   readonly id: string;
@@ -54,4 +55,5 @@ export const WORK_ITEM_STATUSES: ReadonlySet<WorkItemStatus> = new Set([
   'reflected',
   'implemented',
   'tested',
+  'completed',
 ]);

package/scripts/harness/validator-system/infrastructure/adapters/phase-dependency-phase-gate-policy-adapter.ts

@@ -12,6 +12,10 @@ export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPor
     satisfied: boolean;
     violations: readonly HarnessErrorLike[];
   }> {
+    if (context.unitName.trim().length === 0) {
+      return { satisfied: true, violations: [] };
+    }
+
     try {
       // WI-085: paths config を phase-dependency-model に流入させる
       const { createConfigFoundationModule } = await import('../../../config-foundation/composition-root.js');