phasegate 0.191.0 → 0.222.0

package/templates/.claude/scripts/deny-check.sh

@@ -90,11 +90,271 @@ glob_to_regex() {
     printf '%s' "$1" | sed 's/\*/.*/g'
 }
 
+# --- git subcommand allowlist (default-deny) ---------------------------------
+# Enumerated deny lists for git always leak (e.g. `git switch` slipped past the
+# `git checkout*` / `git reset*` deny rules). We therefore invert the policy for
+# git: only the subcommands below are permitted; every other git subcommand is
+# denied by default. To grant a new git subcommand, a human adds it here.
+#
+# Rationale for the set: read-only inspection, staging/commit/tag creation, and
+# worktree/fetch operations that agents legitimately use. History- and
+# working-tree-mutating subcommands (checkout, switch, reset, rebase, merge,
+# cherry-pick, revert, stash, clean, update-ref, reflog, filter-branch,
+# replace, am, ...) are intentionally absent so they fail closed.
+GIT_ALLOWED_SUBCOMMANDS=(
+    status log show diff add commit tag restore rev-parse rev-list
+    merge-base branch worktree fetch grep cat-file ls-files ls-tree
+    ls-remote init remote describe blame shortlog
+    for-each-ref name-rev check-ignore check-attr
+    stripspace var help version whatchanged push
+)
+
+# `symbolic-ref` is deliberately NOT in the allowlist above: its write form
+# (`git symbolic-ref HEAD refs/heads/<branch>` or `git symbolic-ref -d HEAD`)
+# re-points HEAD, i.e. it is a checkout-equivalent HEAD/history mutation that the
+# default-deny policy exists to block. Only the read form (reporting the ref HEAD
+# points at, e.g. `git symbolic-ref HEAD` / `git symbolic-ref --short HEAD`) is
+# state-preserving and therefore permitted. This guard, checked before the plain
+# allowlist, allows the read form and denies every write form.
+check_symbolic_ref() {
+    local segment="$1"
+    local sub
+    sub=$(extract_git_subcommand "$segment")
+    [[ "$sub" != "symbolic-ref" ]] && return 0
+
+    # Re-tokenize and walk to the subcommand, then inspect its arguments.
+    local -a tokens
+    read -ra tokens <<< "$segment"
+    local i=1
+    local n=${#tokens[@]}
+    # Advance past global options to the `symbolic-ref` token (mirrors
+    # extract_git_subcommand's flag handling so flag-stuffing cannot evade this).
+    while (( i < n )); do
+        case "${tokens[$i]}" in
+            -C|-c|--git-dir|--work-tree|--namespace|--exec-path|--config-env)
+                i=$(( i + 2 )) ;;
+            --git-dir=*|--work-tree=*|--namespace=*|--exec-path=*|--config-env=*)
+                i=$(( i + 1 )) ;;
+            --no-pager|--paginate|--no-replace-objects|--bare|--literal-pathspecs|--no-optional-locks|--html-path|--man-path|--info-path)
+                i=$(( i + 1 )) ;;
+            symbolic-ref)
+                break ;;
+            -*)
+                i=$(( i + 1 )) ;;
+            *)
+                break ;;
+        esac
+    done
+    # Skip the `symbolic-ref` token itself.
+    i=$(( i + 1 ))
+
+    # Count positional (non-flag) arguments after the subcommand. A read is
+    # `symbolic-ref [--short|-q] <name>` (<= 1 positional, no delete). A write is
+    # `symbolic-ref <name> <ref>` (>= 2 positionals) or `symbolic-ref -d <name>`.
+    local positional=0
+    while (( i < n )); do
+        local arg="${tokens[$i]}"
+        case "$arg" in
+            -d|--delete)
+                debug_log "BLOCKED git symbolic-ref delete form (segment '$segment')"
+                echo "Security policy violation: 'git symbolic-ref' delete form is denied (it mutates HEAD; only the read form is permitted). Segment: '$segment'." >&2
+                exit 2 ;;
+            -m|--reason)
+                # `-m <reason>` accompanies a write; the reason value consumes one token.
+                i=$(( i + 2 )); continue ;;
+            --short|-q|--quiet)
+                # Read-only modifiers; do not count as positionals.
+                : ;;
+            --)
+                : ;;
+            -*)
+                : ;;
+            *)
+                positional=$(( positional + 1 )) ;;
+        esac
+        i=$(( i + 1 ))
+    done
+
+    if (( positional >= 2 )); then
+        debug_log "BLOCKED git symbolic-ref write form (segment '$segment')"
+        echo "Security policy violation: 'git symbolic-ref' write form (re-pointing HEAD) is denied; it is checkout-equivalent HEAD mutation. Only the read form (e.g. 'git symbolic-ref HEAD') is permitted. Segment: '$segment'." >&2
+        exit 2
+    fi
+    # <= 1 positional and no delete: read form. Allowed.
+    return 0
+}
+
+# `config` is deliberately NOT in the allowlist above: its write form
+# (`git config <key> <value>`, `--unset`, `--add`, `--edit`, ...) can re-point
+# the hook path itself (`git config core.hooksPath <dir>`), which would disable
+# the entire L0 defence layer. Only read forms (`--get*`, `--list`/`-l`, or a
+# single <key> positional with no value) are state-preserving and therefore
+# permitted. Ambiguous invocations fail closed; read forms combined with scope
+# flags (`--global --list`, `--local --get <key>`, ...) are legitimate and pass.
+check_git_config() {
+    local segment="$1"
+    local sub
+    sub=$(extract_git_subcommand "$segment")
+    [[ "$sub" != "config" ]] && return 0
+
+    # Re-tokenize and walk to the subcommand, then inspect its arguments.
+    local -a tokens
+    read -ra tokens <<< "$segment"
+    local i=1
+    local n=${#tokens[@]}
+    # Advance past global options to the `config` token (mirrors
+    # extract_git_subcommand's flag handling so flag-stuffing cannot evade this).
+    while (( i < n )); do
+        case "${tokens[$i]}" in
+            -C|-c|--git-dir|--work-tree|--namespace|--exec-path|--config-env)
+                i=$(( i + 2 )) ;;
+            --git-dir=*|--work-tree=*|--namespace=*|--exec-path=*|--config-env=*)
+                i=$(( i + 1 )) ;;
+            --no-pager|--paginate|--no-replace-objects|--bare|--literal-pathspecs|--no-optional-locks|--html-path|--man-path|--info-path)
+                i=$(( i + 1 )) ;;
+            config)
+                break ;;
+            -*)
+                i=$(( i + 1 )) ;;
+            *)
+                break ;;
+        esac
+    done
+    # Skip the `config` token itself.
+    i=$(( i + 1 ))
+
+    # Classify the arguments after the subcommand.
+    #   read flags  -> explicitly allowed (`--get`, `--list`, ...)
+    #   write flags -> explicitly denied (`--unset`, `--add`, `--edit`, ...)
+    #   positionals -> counted: 1 positional with no write indicator is the
+    #                  `git config <key>` read; >= 2 positionals is the
+    #                  `git config <key> <value>` write (fail closed).
+    # Scope flags (`--global`, `--system`, `--local`, `--worktree`) and other
+    # modifiers are neutral: the verdict is driven by read/write flags and the
+    # positional count, so `--global --list` passes and `--global k v` fails.
+    local read_flag=0
+    local positional=0
+    while (( i < n )); do
+        local arg="${tokens[$i]}"
+        case "$arg" in
+            --unset|--unset-all|--add|--replace-all|--edit|-e|--remove-section|--rename-section|--set*)
+                debug_log "BLOCKED git config write flag '$arg' (segment '$segment')"
+                echo "Security policy violation: 'git config' write form ('$arg') is denied; config writes can re-point hooks (core.hooksPath) and disable the L0 defence layer. Only read forms (--get/--get-all/--get-regexp/--list/-l or a bare <key>) are permitted. Segment: '$segment'." >&2
+                exit 2 ;;
+            --get|--get-all|--get-regexp|--get-urlmatch|--get-color|--get-colorbool|--list|-l)
+                read_flag=1 ;;
+            --file|-f|--blob|--default|--type)
+                # Neutral flags that consume a separate value token.
+                i=$(( i + 2 )); continue ;;
+            --file=*|--blob=*|--default=*|--type=*)
+                : ;;
+            --)
+                : ;;
+            -*)
+                # Scope flags and other modifiers: neutral, do not count.
+                : ;;
+            *)
+                # New-style verb subcommands (git >= 2.46) that mutate config.
+                if (( positional == 0 )); then
+                    case "$arg" in
+                        set|unset|edit|rename-section|remove-section)
+                            debug_log "BLOCKED git config verb '$arg' (segment '$segment')"
+                            echo "Security policy violation: 'git config $arg' is a config write form and is denied; config writes can re-point hooks (core.hooksPath) and disable the L0 defence layer. Segment: '$segment'." >&2
+                            exit 2 ;;
+                    esac
+                fi
+                positional=$(( positional + 1 )) ;;
+        esac
+        i=$(( i + 1 ))
+    done
+
+    # Explicit read flag: allowed regardless of positional count
+    # (`--get <key>`, `--get-regexp <pattern>`, `--get-urlmatch <key> <url>`).
+    (( read_flag == 1 )) && return 0
+
+    if (( positional >= 2 )); then
+        debug_log "BLOCKED git config write form (segment '$segment')"
+        echo "Security policy violation: 'git config' write form (<key> <value>) is denied; config writes can re-point hooks (core.hooksPath) and disable the L0 defence layer. Only read forms (--get/--get-all/--get-regexp/--list/-l or a bare <key>) are permitted. Segment: '$segment'." >&2
+        exit 2
+    fi
+    # <= 1 positional and no write indicator: value read (`git config <key>`)
+    # or a no-op. Allowed.
+    return 0
+}
+
+# Extract the git subcommand from a segment, skipping the `git` binary and any
+# global options that may precede the subcommand:
+#   git -C <path> <sub>        git --no-pager <sub>
+#   git -c key=val <sub>       git --git-dir=<dir> <sub>
+#   git --work-tree <dir> <sub>
+# Prints the subcommand (or empty string if none / not a git command).
+extract_git_subcommand() {
+    # Tokenize on whitespace.
+    local -a tokens
+    read -ra tokens <<< "$1"
+    [[ "${tokens[0]}" != "git" ]] && return 0
+    local i=1
+    local n=${#tokens[@]}
+    while (( i < n )); do
+        local tok="${tokens[$i]}"
+        case "$tok" in
+            # Global flags that take a separate argument.
+            -C|-c|--git-dir|--work-tree|--namespace|--exec-path|--config-env)
+                i=$(( i + 2 ))
+                ;;
+            # Global flags bundled with their value (=), or standalone toggles.
+            --git-dir=*|--work-tree=*|--namespace=*|--exec-path=*|--config-env=*)
+                i=$(( i + 1 ))
+                ;;
+            --no-pager|--paginate|--no-replace-objects|--bare|--literal-pathspecs|--no-optional-locks|--html-path|--man-path|--info-path)
+                i=$(( i + 1 ))
+                ;;
+            -*)
+                # Unknown global flag; skip conservatively.
+                i=$(( i + 1 ))
+                ;;
+            *)
+                printf '%s' "$tok"
+                return 0
+                ;;
+        esac
+    done
+    return 0
+}
+
+check_git_allowlist() {
+    local segment="$1"
+    local sub
+    sub=$(extract_git_subcommand "$segment")
+    # Not a git command, or `git` with no subcommand (e.g. `git`, `git --help`).
+    [[ -z "$sub" ]] && return 0
+    # `symbolic-ref` is adjudicated by check_symbolic_ref (read form allowed,
+    # write form denied); do not treat its absence from the allowlist as a deny.
+    [[ "$sub" == "symbolic-ref" ]] && return 0
+    # `config` is adjudicated by check_git_config (read forms allowed, write
+    # forms denied); do not treat its absence from the allowlist as a deny.
+    [[ "$sub" == "config" ]] && return 0
+    local allowed
+    for allowed in "${GIT_ALLOWED_SUBCOMMANDS[@]}"; do
+        [[ "$sub" == "$allowed" ]] && return 0
+    done
+    debug_log "BLOCKED git subcommand '$sub' not in allowlist (segment '$segment')"
+    echo "Security policy violation: git subcommand '$sub' is not in the agent allowlist (default-deny for git). Segment: '$segment'. If this subcommand is genuinely needed, a human must add it to GIT_ALLOWED_SUBCOMMANDS in .claude/scripts/deny-check.sh." >&2
+    exit 2
+}
+
 check_segment() {
     local segment="$1"
     # Strip leading whitespace so "^pattern" anchors match after operators.
     segment="${segment#"${segment%%[![:space:]]*}"}"
     [[ -z "$segment" ]] && return 0
+    # git subcommands are default-deny (allowlist); check that first.
+    # symbolic-ref and config get a dedicated read-vs-write adjudication before
+    # the plain allowlist (their write forms mutate HEAD / the hook path and
+    # must fail closed).
+    check_symbolic_ref "$segment"
+    check_git_config "$segment"
+    check_git_allowlist "$segment"
     for pattern in "${DENY_PATTERNS[@]}"; do
         local regex_pattern
         regex_pattern=$(glob_to_regex "$pattern")

package/skills/doc-freshness-checker/SKILL.md

@@ -1,140 +0,0 @@
----
-name: doc-freshness-checker
-description: 設計文書の鮮度チェック（L4バリデータ拡張）。`phasegate check-freshness` CLIを使い、設計文書の最終更新日が閾値を超えていないか、コード変更と設計文書の乖離がないかを検出する。使用タイミング: 「設計文書が古くなっていないか確認して」「ドキュメントの鮮度チェックを実行して」「L4 freshness チェック」「設計とコードの乖離を調べて」など。
-model: sonnet
-review: opus
-languages: [typescript]
----
-
-# Doc Freshness Checker
-
-## 目的
-
-設計文書の鮮度（freshness）を検証し、古くなった文書や対応コードとの乖離を検出するスキル。
-`phasegate check-freshness` CLIをラップし、結果を解釈・対処する。
-
-## 前提条件
-
-- `phasegate.config.json` に `docFreshnessThresholds` が設定されていること（未設定時はデフォルト値使用）
-- git リポジトリ内で実行すること（最終更新日は `git log` で判定）
-
-## 入力
-
-- 対象ディレクトリ: `--dir <path>` または `phasegate.config.json` の `constructionDir`（デフォルト `docs/`）
-- 閾値: `--threshold <days>` または `docFreshnessThresholds`（未設定時はデフォルト30日）
-- git 履歴（最終更新日の判定に使用）
-
----
-
-## ⚠️ 2フェーズ実行ルール
-
-- **Phase 1（計画）**: チェック対象スコープを確認し、人間の承認を得る
-- **Phase 2（実行）**: CLIを実行し、結果を解釈してアクションを提案する
-
-**Phase 1/2を同時に実行してはならない。**
-
----
-
-## Phase 1: チェック計画（plan）
-
-### 出力（会話内のみ）
-
-```markdown
-# Doc Freshness チェック計画
-
-## チェック対象スコープ
-- ディレクトリ: {phasegate.config.json の constructionDir、デフォルト: docs/}
-- 閾値: {phasegate.config.json の値 or デフォルト 30日}
-
-## 実行コマンド
-npx phasegate check-freshness [--dir {path}] [--threshold {days}]
-
-## QA
-[Question] Q1: ...
-[Answer]
-```
-
-### Phase 1 完了条件
-- スコープを報告した
-- 人間にボールを渡した
-- **CLIはまだ実行していない**
-
----
-
-## Phase 2: 実行（execution）
-
-### Step 1: CLIの実行
-
-```bash
-npx phasegate check-freshness
-```
-
-オプション:
-- `--dir <path>` — チェック対象ディレクトリ（デフォルト: `phasegate.config.json` の `constructionDir`）
-- `--threshold <days>` — 警告閾値（日数）
-
-### Step 2: 結果の解釈
-
-`CheckDocFreshnessOutput` の構造:
-
-| フィールド | 意味 |
-|-----------|------|
-| `results[].status` | `ok` / `warn` / `error` |
-| `results[].documentPath` | チェック対象ファイルパス |
-| `results[].daysSinceUpdate` | 最終更新からの日数 |
-| `results[].threshold` | 設定閾値 |
-| `summary.error` | エラー件数（即対応必要） |
-| `summary.warn` | 警告件数（確認推奨） |
-
-### Step 3: アクションの提案
-
-| 状態 | 推奨アクション |
-|------|--------------|
-| `error`（閾値超過） | cascade-updater で上位設計文書を更新 |
-| `warn`（閾値近接） | 設計文書の内容確認・必要に応じて更新 |
-| `ok` | 対応不要 |
-
-### 出力フォーマット
-
-```markdown
-# Doc Freshness チェック結果
-
-## サマリー
-- 総ドキュメント数: N
-- ok: N / warn: N / error: N
-
-## 要対応（error）
-| ファイル | 最終更新 | 閾値超過日数 | 推奨アクション |
-|---------|---------|------------|--------------|
-
-## 要確認（warn）
-| ファイル | 最終更新 | 残り日数 |
-|---------|---------|---------|
-
-## 次のアクション
-（errorがある場合は `cascade-updater` の実行を提案）
-```
-
----
-
-## phasegate.config.json 設定例
-
-```json
-{
-  "docFreshnessThresholds": {
-    "domain_model.md": 90,
-    "logical_design.md": 60,
-    "unit_test_design.md": 30,
-    "default": 30
-  }
-}
-```
-
----
-
-## 関連スキル
-
-| スキル | 用途 |
-|-------|------|
-| `cascade-updater` | errorが検出された設計文書の更新 |
-| `consistency-checker` | 文書間整合性の検証（freshness修正後の確認） |

package/skills/implementation-planner/SKILL.md

@@ -1,169 +0,0 @@
----
-name: implementation-planner
-description: "Unit仕様とドメインモデル設計を元に実装計画を立てる。WI IDや機能名から関連Unitを特定し、API設計・レイヤー別実装方針を整理してmdファイルで出力する。使用タイミング: 実装計画を立てて、WI-XXXの実装方針を決めて、この機能の設計を整理して、など実装前の計画策定時。"
-model: sonnet
-review: opus
-languages: [typescript]
----
-
-# Implementation Planner
-
-## 目的
-
-UnitドキュメントとConstructionのドメインモデル設計を元に、**設計フェーズの実装計画**を体系的に立案する。
-
-## ⚠️ `story-implementor` との役割分担
-
-| 観点 | `implementation-planner`（本スキル） | `story-implementor` |
-|------|-------------------------------------|---------------------|
-| **目的** | 設計段階で実装方針を整理・合意する | TDD実装を実行する |
-| **タイミング** | 論理設計の前後（設計の方向性確認） | テスト設計・カバレッジ検証の後 |
-| **出力** | 実装計画書（API設計・レイヤー別方針） | TDD実装計画 → 実装コード |
-| **テスト設計** | 参照しない（設計フェーズのため） | 必須（テスト設計完了が前提） |
-
-**使い分けの指針:**
-- 「この機能どう実装する？」→ `implementation-planner`
-- 「テスト設計も終わった、TDD実装を始めたい」→ `story-implementor`
-
-## ⚠️ 3フェーズ実行ルール
-
-**このスキルは3フェーズで実行する。**
-- **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: 委任先モデルに委任して成果物を生成する（`npx phasegate delegate-sonnet` 経由）
-- **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
-
-**Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照（consumer プロジェクトでは `node_modules/phasegate/docs/principles/model-routing.md`、phasegate 自リポジトリでは `docs/principles/model-routing.md` を参照する）。**
-
----
-
-## ワークフロー
-
-## 前提条件チェック（Pre-flight, BLOCKING）
-
-Before generating any plan, verify `docs/inception/{unit}/WI-XXX/description.md` exists.
-If not, halt and ask the user to create the WI first, or offer to run `phasegate scaffold-wi <unit> <story|issue|chore>`.
-
-```
-入力解析 → Unit特定 → ドメインモデル確認 → 既存実装確認 → 計画作成 → 出力
-```
-
-### Step 1: 入力解析
-
-ユーザー入力から抽出:
-- WI ID（WI-XXX形式）
-- 機能名・タスク説明
-- 優先度・制約条件
-
-### Step 2: Unit特定
-
-1. `docs/product/units/integration_contract.md`を読み込み
-2. 関連する公開APIエンドポイントを特定
-3. 該当Unitの`{unit}.md`を確認
-4. Unit間依存関係を整理
-
-**検索方法:**
-- Grep/Globツールを使用して `docs/product/units/` 配下からストーリーIDやキーワードを検索する
-- `integration_contract.md` から関連する公開APIエンドポイントを特定する
-
-### Step 3: ドメインモデル確認
-
-1. `docs/product/construction/{context}/domain_model.md`を読み込み
-2. 以下を把握:
-   - 集約と不変条件
-   - エンティティ・値オブジェクト
-   - ドメインイベント
-   - 状態遷移
-3. 必要に応じて`shared_kernel/domain_model.md`を参照
-
-### Step 4: 既存実装確認
-
-- Glob/Readツールを使用してプロジェクトの実装ディレクトリ構造を確認する
-- 既存の実装パターンを検索し、コードスタイル・ファイル配置を把握する
-
-### Step 5: 計画作成
-
-[references/plan-template.md](references/plan-template.md)のフォーマットに従って:
-1. API設計（新規/既存拡張）
-2. レイヤー別実装内容
-3. 実装ステップ分解
-4. 影響範囲特定
-
-## 出力ファイル
-
-### Step 6: 出力
-
-計画をmdファイルとして出力。パスの推奨:
-```
-docs/inception/{task_id}_plan.md
-docs/inception/{unit}/WI-XXX/tdd_implementation_plan.md
-```
-
-> **パス注記**: 本スキルが扱う設計文書パス（`docs/inception/...` / `docs/product/units/...` / `docs/product/construction/...`）は既定値であり、consumer が `phasegate.config.json` の `paths` 設定で上書きしている場合はそちらが優先される。
-
-**[Question][Answer]セクション必須**: 不明点や確認事項をまとめ、ユーザーからのフィードバックを受け取れるようにする。
-
----
-
-## 入力（参照ドキュメント）
-
-| ファイル | 用途 |
-|----------|------|
-| `docs/product/units/integration_contract.md` | Unit間API定義・依存関係 |
-| `docs/product/units/{unit}.md` | ユーザーストーリー・機能要件 |
-| `docs/product/construction/{context}/domain_model.md` | ドメインモデル設計 |
-
-**詳細は以下を参照:**
-- [document-structure.md](references/document-structure.md): ドキュメント構造リファレンス
-- [workflow.md](references/workflow.md): 詳細ワークフロー
-- [plan-template.md](references/plan-template.md): 出力テンプレート
-
----
-
-## Unit一覧（クイックリファレンス）
-
-実行時に `docs/product/units/` 配下のUnit定義ファイルを動的に読み取ること。ハードコードしない。
-
----
-
-### Phase 2 最低出力基準（Sonnet委任時の品質制約）
-
-以下の基準を満たさない出力は不完全とみなし、Phase 3レビューでBLOCKとする。
-
-| 基準 | 最低要件 |
-|------|---------|
-| Unit特定 | 対象ストーリー/機能に関連するUnitが正しく特定されていること |
-| ドメインモデル参照 | 関連する集約・エンティティ・値オブジェクトが列挙されていること |
-| API設計 | 新規/既存拡張のエンドポイントが具体的に定義されていること |
-| レイヤー別実装内容 | 各層（Domain/UseCase/Controller/Infrastructure）の実装内容が記載されていること |
-| 実装ステップ | 実装順序が具体的なステップに分解されていること |
-| 影響範囲 | 変更が他Unit・他コンポーネントに与える影響が分析されていること |
-| QAセクション | 不明点・確認事項が[Question][Answer]形式で記載されていること |
-
----
-
-## Phase 3: レビュー（Opus review）
-
-### 実行主体
-メインセッション（model-routing.md の Architect ロール）が実行する。Sonnetへの再委任は行わない。
-
-### レビュー手順
-1. Sonnetが出力したファイルを読み込む
-2. `docs/principles/model-routing.md` の「レビュー観点」節に沿って検証する
-3. **スキル固有レビュー観点**を検証する
-4. 判定結果を出力する
-
-### スキル固有レビュー観点（BLOCK基準）
-- [ ] 対象Unit/ドメインモデルの特定が正確か
-- [ ] API設計が統合契約と整合しているか
-- [ ] レイヤー間の依存方向が正しいか（Domain → Port → UseCase → Controller）
-- [ ] 実装ステップの順序が論理的か（依存関係に沿っているか）
-- [ ] 影響範囲の分析が漏れなく行われているか
-
-### 判定と修正
-- **BLOCK項目にFAIL** → Opusが直接修正してから完了とする
-- **WARNのみFAIL** → Opusが直接修正してから完了とする
-- **全PASS** → 完了
-
-## コードベース構成（クイックリファレンス）
-
-実行時にプロジェクトのディレクトリ構造を動的に確認すること。ハードコードしない。