phasegate 0.135.0 → 0.137.0

package/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.137.0] - 2026-05-09
+
+### Added
+
+- **WI-032 — AGENTS.md / CLAUDE.md auto-refresh pipeline** — `ci:auto-refresh-agent-context --dry-run|--apply|--json` を追加し、lesson artifact 由来の AGENTS.md pointer 更新と CLAUDE.md 標準セクション更新を 1 コマンドで実行できるようにした。
+  - `refresh-claude-md --dry-run|--apply|--json` を追加し、CLAUDE.md の user-owned section を保持しながら bundled template から標準セクションを再生成。
+  - `p2:check-agent-context --threshold-days <n> --json` を追加し、AGENTS.md / CLAUDE.md の鮮度を検査可能にした。
+  - `docs/templates/ci/agent-context-refresh.yml` を追加し、`ci:generate-template --type agent-context-refresh --render` と `phasegate init --with-ci` で配布可能にした。
+  - PhaseGate 自身にも `.github/workflows/agent-context-refresh.yml` を追加し、週次 refresh PR を作成する構成にした。
+
+## [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` ・ `.github/workflows/agent-context-refresh.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,10 @@ 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\|agent-context-refresh>` | CI/CD テンプレート生成（`--render` で bundled template を stdout 出力） |
+| `ci:auto-refresh-agent-context --dry-run` / `--apply` | AGENTS.md pointer と CLAUDE.md 標準セクションを更新 |
+| `refresh-claude-md --dry-run` / `--apply` | user section を保持して CLAUDE.md だけを更新 |
+| `p2:check-agent-context` | AGENTS.md / CLAUDE.md の鮮度を検査 |
 | `list-errors --layer <L0-L4>` | エラー定義一覧 |
 | `hook <pre-tool-use\|post-tool-use\|stop>` | agent hook を起動（stdin から JSON） |
 | `pre-commit` | L2 pre-commit バリデータをステージファイルに適用 |
@@ -451,8 +455,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 に昇格 |
 
 L3 Nyquist Validation の `requirement-test-matrix.json` 自動生成はまだ未自動化です。現時点では手動セットアップで利用できます。

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`, `.github/workflows/consistency-check.yml`, and `.github/workflows/agent-context-refresh.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,14 @@ 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\|agent-context-refresh> --render` | Render the bundled CI/hook template to stdout |
+| `ci:auto-refresh-agent-context --dry-run` / `--apply` | Refresh AGENTS.md pointers and CLAUDE.md standard sections |
+| `refresh-claude-md --dry-run` / `--apply` | Refresh only CLAUDE.md while preserving the user-owned section |
+| `p2:check-agent-context` | Check AGENTS.md / CLAUDE.md freshness |
 | `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,8 +517,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. |
 
 `requirement-test-matrix.json` auto-generation for L3 Nyquist Validation is not automated yet; see the L3 guide for the current manual setup.

package/docs/guide/cli-reference.md

@@ -321,6 +321,9 @@ ISSUE-005 P3-10 で明確化された境界:
 |---|---|---|
 | `ci:generate-template` | `--preset <id>` `--type <type>` `--render` `--json` | Generate CI/CD template |
 | `ci:migrate-agents-md` | `--dry-run` `--validate-only` `--json` | Migrate AGENTS.md to pointer format |
+| `ci:auto-refresh-agent-context` | `--dry-run` `--apply` `--json` | Refresh AGENTS.md pointers and CLAUDE.md standard sections |
+| `refresh-claude-md` | `--dry-run` `--apply` `--json` | Refresh CLAUDE.md while preserving the user-owned section |
+| `p2:check-agent-context` | `--threshold-days <n>` `--json` | Check AGENTS.md / CLAUDE.md freshness |
 | `ci:check-repetition` | `--code <errorCode>` `--reset` `--json` | Detect repetitive errors |
 
 ---

package/docs/templates/agent-context/CLAUDE.md.template.md

@@ -0,0 +1,29 @@
+# CLAUDE.md
+
+## 必読ドキュメント
+
+- `docs/folder_management_rules.md`
+- `docs/principles/architecture-philosophy.md`
+- `docs/principles/testing-rules.md`
+
+## PhaseGate Commands
+
+{{PHASEGATE_COMMANDS}}
+
+## Phase Presets
+
+{{PHASEGATE_PRESETS}}
+
+## Skills
+
+{{PHASEGATE_SKILLS}}
+
+## User Section
+
+<!-- phasegate:user-section:start -->
+{{PHASEGATE_USER_SECTION}}
+<!-- phasegate:user-section:end -->
+
+## Agent Context Refresh
+
+Run `phasegate ci:auto-refresh-agent-context --dry-run` to preview updates and `phasegate ci:auto-refresh-agent-context --apply` to write AGENTS.md / CLAUDE.md.

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

@@ -0,0 +1,59 @@
+# Phasegate — Agent context refresh workflow
+#
+# 使い方:
+#   このファイルを .github/workflows/agent-context-refresh.yml にコピーして使用する。
+#
+# 実行タイミング: 毎週火曜 04:00 UTC（手動トリガーも可）
+# 実行内容:
+#   1. AGENTS.md pointer refresh
+#   2. CLAUDE.md standard section refresh
+#   3. 変更検出時: refresh branch を push して PR を作成
+
+name: Agent Context Refresh
+
+on:
+  schedule:
+    - cron: '0 4 * * 2'
+  workflow_dispatch:
+
+jobs:
+  refresh-agent-context:
+    name: Refresh AGENTS.md and CLAUDE.md
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    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
+
+      - name: Refresh agent context
+        run: pnpm run harness ci:auto-refresh-agent-context --apply
+
+      - name: Create pull request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          branch: phasegate/agent-context-refresh
+          title: 'chore: refresh agent context'
+          commit-message: 'chore: refresh agent context'
+          body: |
+            Automated AGENTS.md / CLAUDE.md refresh generated by PhaseGate.
+          labels: |
+            aidlc
+            agent-context
+            automated

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.137.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/application/dto/check-agent-context-input.ts

@@ -0,0 +1,8 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+export interface CheckAgentContextInput {
+  readonly thresholdDays?: number;
+}

package/scripts/harness/ci-governance/application/dto/check-agent-context-output.ts

@@ -0,0 +1,17 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+export interface AgentContextFreshnessFinding {
+  readonly path: string;
+  readonly status: 'pass' | 'error';
+  readonly ageInDays: number | null;
+  readonly message: string;
+}
+
+export interface CheckAgentContextOutput {
+  readonly passed: boolean;
+  readonly thresholdDays: number;
+  readonly findings: readonly AgentContextFreshnessFinding[];
+}

package/scripts/harness/ci-governance/application/dto/refresh-agent-context-input.ts

@@ -0,0 +1,8 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+export interface RefreshAgentContextInput {
+  readonly dryRun: boolean;
+}

package/scripts/harness/ci-governance/application/dto/refresh-agent-context-output.ts

@@ -0,0 +1,15 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+import type { MigrateAgentsMdOutput } from './migrate-agents-md-output.js';
+import type { RefreshClaudeMdOutput } from './refresh-claude-md-output.js';
+
+export interface RefreshAgentContextOutput {
+  readonly success: boolean;
+  readonly applied: boolean;
+  readonly agentsMd: MigrateAgentsMdOutput;
+  readonly claudeMd: RefreshClaudeMdOutput;
+  readonly errors: Array<{ code: string; message: string }>;
+}

package/scripts/harness/ci-governance/application/dto/refresh-claude-md-input.ts

@@ -0,0 +1,8 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+export interface RefreshClaudeMdInput {
+  readonly dryRun: boolean;
+}

package/scripts/harness/ci-governance/application/dto/refresh-claude-md-output.ts

@@ -0,0 +1,13 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+export interface RefreshClaudeMdOutput {
+  readonly success: boolean;
+  readonly path: string;
+  readonly changed: boolean;
+  readonly applied: boolean;
+  readonly preview: string;
+  readonly errors: Array<{ code: string; message: string }>;
+}

package/scripts/harness/ci-governance/application/usecases/check-agent-context-usecase.ts

@@ -0,0 +1,48 @@
+/**
+ * @layer application
+ * @unit ci-governance
+ */
+
+import type { AgentContextDocumentPort } from '../../domain/ports/agent-context-document-port.js';
+import type { CheckAgentContextInput } from '../dto/check-agent-context-input.js';
+import type { AgentContextFreshnessFinding, CheckAgentContextOutput } from '../dto/check-agent-context-output.js';
+
+const AGENT_CONTEXT_PATHS = ['AGENTS.md', 'CLAUDE.md'] as const;
+const DEFAULT_THRESHOLD_DAYS = 30;
+
+export class CheckAgentContextUseCase {
+  constructor(private readonly documentPort: AgentContextDocumentPort) {}
+
+  async execute(input: CheckAgentContextInput): Promise<CheckAgentContextOutput> {
+    const thresholdDays = input.thresholdDays ?? DEFAULT_THRESHOLD_DAYS;
+    const findings: AgentContextFreshnessFinding[] = [];
+
+    for (const path of AGENT_CONTEXT_PATHS) {
+      const stat = await this.documentPort.statProjectFile(path);
+      if (!stat.exists) {
+        findings.push({
+          path,
+          status: 'error',
+          ageInDays: null,
+          message: `${path} does not exist`,
+        });
+        continue;
+      }
+      const stale = stat.ageInDays !== null && stat.ageInDays > thresholdDays;
+      findings.push({
+        path,
+        status: stale ? 'error' : 'pass',
+        ageInDays: stat.ageInDays,
+        message: stale
+          ? `${path} is older than ${thresholdDays} days`
+          : `${path} is fresh`,
+      });
+    }
+
+    return {
+      passed: findings.every((finding) => finding.status === 'pass'),
+      thresholdDays,
+      findings,
+    };
+  }
+}