phasegate 0.264.0 → 0.315.0

package/scripts/harness/validator-system/infrastructure/adapters/harness-config-validator-config-adapter.ts

@@ -5,11 +5,15 @@
  * @work-item-id WI-212
  * @work-item-id WI-301
  * @work-item-id WI-302
+ * @work-item-id WI-319
+ * @work-item-id WI-328
  *
  * HarnessConfigValidatorConfigAdapter — ValidatorConfigPort実装
  * HarnessConfigV2からLayerConfig VOを構築する
  */
 
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 import type { ValidatorConfigPort } from "../../domain/ports/validator-config-port.js";
 import { LayerConfig } from "../../domain/value-objects/layer-config.js";
 import { ValidatorId } from "../../domain/value-objects/validator-id.js";
@@ -38,11 +42,92 @@ export interface HarnessConfigV2Like {
   world?: { enabled?: boolean };
 }
 
+/**
+ * WI-319 (github#39): project.languages 未宣言時にファイルシステムから言語を検出するためのマーカー定義。
+ * typescript は package.json の存在自体を根拠にできない（phasegate 導入時に phasegate 用
+ * package.json が置かれるため）ので、この表には含めず hasTypescriptMarker() で個別判定する。
+ */
+const LANGUAGE_MARKER_FILES: ReadonlyArray<{ readonly language: string; readonly markers: readonly string[] }> = [
+  { language: "python", markers: ["pyproject.toml", "setup.py", "setup.cfg", "requirements.txt"] },
+  { language: "go", markers: ["go.mod"] },
+  { language: "rust", markers: ["Cargo.toml"] },
+  { language: "java", markers: ["pom.xml", "build.gradle", "build.gradle.kts"] },
+  { language: "ruby", markers: ["Gemfile"] },
+  { language: "php", markers: ["composer.json"] },
+];
+
+/** WI-328: 実効言語リストの出所。status 表示等で「なぜこの言語判定になったか」を示す。 */
+export type ProjectLanguageSource = "declared" | "detected" | "fallback";
+
+export interface ResolvedProjectLanguages {
+  readonly languages: readonly string[];
+  readonly source: ProjectLanguageSource;
+}
+
+/**
+ * WI-328 (github#39 残課題): 実効言語リストとその出所を解決する唯一の実装。
+ * getProjectLanguages()（WI-319 の検出ロジック）と phasegate:status の言語表示が
+ * 同じテーブル・同じ優先順位を共有するために export する。
+ *
+ * 優先順位:
+ * 1. declared — config の project.languages 宣言（従来どおり最優先）
+ * 2. detected — project root のマーカーファイルから検出（WI-319 / github#39）
+ * 3. fallback — 検出ゼロなら typescript フォールバック（純 JS リポジトリ等の挙動維持）
+ */
+export function resolveProjectLanguages(
+  declaredLanguages: readonly string[] | undefined,
+  rootDir: string,
+): ResolvedProjectLanguages {
+  if (declaredLanguages && declaredLanguages.length > 0) {
+    return { languages: [...declaredLanguages], source: "declared" };
+  }
+  const detected = detectLanguagesFromFilesystem(rootDir);
+  if (detected.length > 0) {
+    return { languages: detected, source: "detected" };
+  }
+  return { languages: ["typescript"], source: "fallback" };
+}
+
+function detectLanguagesFromFilesystem(rootDir: string): string[] {
+  const detected: string[] = [];
+  if (hasTypescriptMarker(rootDir)) detected.push("typescript");
+  for (const { language, markers } of LANGUAGE_MARKER_FILES) {
+    if (markers.some((marker) => existsSync(join(rootDir, marker)))) {
+      detected.push(language);
+    }
+  }
+  return detected;
+}
+
+/**
+ * typescript の根拠は tsconfig.json の存在、または package.json の
+ * dependencies / devDependencies に typescript があることのみ。
+ * package.json の存在自体は根拠にしない（phasegate 導入時に phasegate 用
+ * package.json が置かれるため、誤検出の原因になる）。
+ */
+function hasTypescriptMarker(rootDir: string): boolean {
+  if (existsSync(join(rootDir, "tsconfig.json"))) return true;
+  const packageJsonPath = join(rootDir, "package.json");
+  if (!existsSync(packageJsonPath)) return false;
+  try {
+    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf-8")) as {
+      dependencies?: Record<string, string>;
+      devDependencies?: Record<string, string>;
+    };
+    return parsed.dependencies?.typescript !== undefined || parsed.devDependencies?.typescript !== undefined;
+  } catch {
+    // parse 失敗は typescript 根拠なしとして扱う（throw しない）
+    return false;
+  }
+}
+
 export class HarnessConfigValidatorConfigAdapter implements ValidatorConfigPort {
   private readonly config: HarnessConfigV2Like;
+  private readonly rootDir: string;
 
-  constructor(config: HarnessConfigV2Like) {
+  constructor(config: HarnessConfigV2Like, rootDir: string = process.cwd()) {
     this.config = config;
+    this.rootDir = rootDir;
   }
 
   async getLayerConfig(layer: "L2" | "L3" | "L4"): Promise<LayerConfig> {
@@ -95,8 +180,9 @@ export class HarnessConfigValidatorConfigAdapter implements ValidatorConfigPort
   }
 
   async getProjectLanguages(): Promise<readonly string[]> {
-    const languages = this.config.project?.languages;
-    return languages && languages.length > 0 ? [...languages] : ["typescript"];
+    // WI-319 の宣言優先 → FS 検出 → typescript フォールバックの解決は
+    // resolveProjectLanguages() に一本化（WI-328 で status 表示と共有）。
+    return [...resolveProjectLanguages(this.config.project?.languages, this.rootDir).languages];
   }
 
   private normalizeValidatorId(idOrName: string): string {

package/scripts/harness/validator-system/infrastructure/adapters/nyquist-ac-coverage-policy-adapter.ts

@@ -18,18 +18,25 @@
  * （layers.L3.requirementMatrixPath）から供給される。未指定時は既定値
  * `.harness/requirement-test-matrix.json` を用いる。マトリクスが不在の場合は
  * fail-closed で「設定されているが不在」という実行可能なメッセージを返す。
+ *
+ * FRESH PROJECT SKIP (WI-324): 例外として「matrix 不在 かつ StoryCatalog の
+ * story がゼロ」の場合のみ skipped=true を返す。phasegate 導入直後（story 未作成・
+ * matrix 未生成）のオンボーディングを fail-closed で阻害しないため。story が
+ * 1件でも存在するのに matrix が不在なら「あるべき matrix が消えた事故」として
+ * 従来どおり fail-closed。story 数の取得自体に失敗した場合も判定不能として
+ * 保守的に fail-closed 側へ倒す。
  */
-import { access } from 'node:fs/promises';
-import { isAbsolute, join } from 'node:path';
-import type { AcCoveragePolicyPort } from '../../domain/ports/ac-coverage-policy-port.js';
-import type { HarnessErrorLike } from '../../domain/value-objects/validation-result.js';
+import { access } from "node:fs/promises";
+import { isAbsolute, join } from "node:path";
+import type { AcCoveragePolicyPort } from "../../domain/ports/ac-coverage-policy-port.js";
+import type { HarnessErrorLike } from "../../domain/value-objects/validation-result.js";
 
-const DEFAULT_MATRIX_PATH = '.harness/requirement-test-matrix.json';
+const DEFAULT_MATRIX_PATH = ".harness/requirement-test-matrix.json";
 
 function toL3004Error(message: string, suggestion: string): HarnessErrorLike {
   return {
-    code: { value: 'L3-004', toString: () => 'L3-004' },
-    severity: { value: 'error', toString: () => 'error' },
+    code: { value: "L3-004", toString: () => "L3-004" },
+    severity: { value: "error", toString: () => "error" },
     message,
     suggestion,
   };
@@ -39,21 +46,29 @@ export class NyquistAcCoveragePolicyAdapter implements AcCoveragePolicyPort {
   async checkCoverage(context: { matrixFilePath?: string }): Promise<{
     passed: boolean;
     errors: readonly HarnessErrorLike[];
+    skipped?: boolean;
+    skipReason?: string;
   }> {
     const rootDir = process.cwd();
     const relativeOrAbsolute =
-      context.matrixFilePath && context.matrixFilePath.length > 0
-        ? context.matrixFilePath
-        : DEFAULT_MATRIX_PATH;
-    const matrixFilePath = isAbsolute(relativeOrAbsolute)
-      ? relativeOrAbsolute
-      : join(rootDir, relativeOrAbsolute);
+      context.matrixFilePath && context.matrixFilePath.length > 0 ? context.matrixFilePath : DEFAULT_MATRIX_PATH;
+    const matrixFilePath = isAbsolute(relativeOrAbsolute) ? relativeOrAbsolute : join(rootDir, relativeOrAbsolute);
 
     // マトリクス不在は threshold-configured-but-absent と同様に fail-closed で
     // 明確なメッセージを返す（ENOENT の生メッセージで落とさない）。
+    // 例外（WI-324）: story がゼロのフレッシュプロジェクトのみ SKIP を返す。
     try {
       await access(matrixFilePath);
     } catch {
+      if (await this.hasZeroStories(rootDir)) {
+        return {
+          passed: true,
+          errors: [],
+          skipped: true,
+          skipReason:
+            "story 未作成のため L3-004 をスキップ（story 作成後に requirement-test-matrix を生成すると有効化されます）",
+        };
+      }
       return {
         passed: false,
         errors: [
@@ -69,7 +84,7 @@ export class NyquistAcCoveragePolicyAdapter implements AcCoveragePolicyPort {
       // 有効 storyId 一覧を traceability-model の StoryCatalog から取得する（REAL registry）
       const storyIds = await this.loadValidStoryIds(rootDir);
 
-      const { createNyquistValidationModule } = await import('../../../nyquist-validation/composition-root.js');
+      const { createNyquistValidationModule } = await import("../../../nyquist-validation/composition-root.js");
       const mod = createNyquistValidationModule({
         getStoryIds: async () => storyIds,
       });
@@ -79,9 +94,7 @@ export class NyquistAcCoveragePolicyAdapter implements AcCoveragePolicyPort {
 
       return {
         passed: output.passed,
-        errors: output.errors.map((err) =>
-          toL3004Error(err.message, ''),
-        ),
+        errors: output.errors.map((err) => toL3004Error(err.message, "")),
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -91,19 +104,35 @@ export class NyquistAcCoveragePolicyAdapter implements AcCoveragePolicyPort {
         errors: [
           toL3004Error(
             `AC網羅ゲートの検査に失敗しました（fail-closed）: ${message}`,
-            'requirement-test-matrix.json の存在・形式・スキーマ整合性を確認してください',
+            "requirement-test-matrix.json の存在・形式・スキーマ整合性を確認してください",
           ),
         ],
       };
     }
   }
 
+  /**
+   * WI-324: 「story がゼロ」判定。StoryCatalog（traceability-model）の登録 story 数を
+   * シグナルとする。StoryCatalog は requirement-test-matrix の生成元と同じ
+   * user_stories.md を読むため、「matrix が本来存在しうるか」と一貫した判定になる。
+   * catalog 読み込み自体が失敗した場合（config 不正等）は判定不能として false を返し、
+   * 呼び出し側を保守的に fail-closed へ倒す。
+   */
+  private async hasZeroStories(rootDir: string): Promise<boolean> {
+    try {
+      const storyIds = await this.loadValidStoryIds(rootDir);
+      return storyIds.length === 0;
+    } catch {
+      return false;
+    }
+  }
+
   private async loadValidStoryIds(rootDir: string): Promise<readonly string[]> {
-    const { createConfigFoundationModule } = await import('../../../config-foundation/composition-root.js');
+    const { createConfigFoundationModule } = await import("../../../config-foundation/composition-root.js");
     const configModule = createConfigFoundationModule();
     const resolvedConfig = await configModule.usecases.loadResolvedConfigUseCase.execute();
 
-    const { createTraceabilityModelModule } = await import('../../../traceability-model/composition-root.js');
+    const { createTraceabilityModelModule } = await import("../../../traceability-model/composition-root.js");
     const traceModule = createTraceabilityModelModule(rootDir, {
       pathRoots: { designDocsRoot: resolvedConfig.config.paths.designDocs },
     });

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

@@ -4,8 +4,27 @@
  *
  * PhaseDependencyPhaseGatePolicyAdapter — PhaseGatePolicyPort実装
  */
-import type { PhaseGatePolicyPort } from '../../domain/ports/phase-gate-policy-port.js';
-import type { HarnessErrorLike } from '../../domain/value-objects/validation-result.js';
+import type { PhaseGatePolicyPort } from "../../domain/ports/phase-gate-policy-port.js";
+import type { HarnessErrorLike } from "../../domain/value-objects/validation-result.js";
+
+/**
+ * WI-357 (issue #29): `validate --layer L2` の失敗出力には従来
+ * 'phase gate prerequisites are not met' という事実の再掲しか載らず、
+ * 「何を作れば通るのか」がどの経路からも得られなかった。
+ * hook の block メッセージ側にしか復旧手順がないため、CLI から検証した
+ * エージェントは不足文書を推測で書くしかなくなる。
+ *
+ * 実行可能な復旧手順（scaffold コマンド）と、文書のセクション構成の在り処
+ * （skills/<skill>/SKILL.md、未配置なら `phasegate skills info`）を suggestion に載せる。
+ */
+export function buildPhaseGateRecoverySuggestion(unitName: string): string {
+  const unitArg = unitName.trim().length > 0 ? unitName.trim() : "<unit-id>";
+  return [
+    `不足している設計文書を scaffold で作成してください: npx phasegate scaffold-design --unit ${unitArg} --phase <logical|domain|uiux|unit-test|it-test> --apply`,
+    "各文書のセクション構成は導入先 repo の skills/<skill>/SKILL.md に記載されています（logical_design.md → skills/logical-designer/SKILL.md、domain_model.md → skills/domain-designer/SKILL.md、unit plan → skills/unit-designer/SKILL.md）。",
+    "skills/ が repo に無い場合は `npx phasegate skills info <skill-name>` で同じ内容を stdout から読めます。",
+  ].join("\n");
+}
 
 export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPort {
   async checkPrerequisites(context: { unitName: string; currentPhase: string }): Promise<{
@@ -18,11 +37,13 @@ export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPor
 
     try {
       // WI-085: paths config を phase-dependency-model に流入させる
-      const { createConfigFoundationModule } = await import('../../../config-foundation/composition-root.js');
-      const { toPhaseConfigSection } = await import('../../../config-foundation/application/mappers/phase-config-section-mapper.js');
+      const { createConfigFoundationModule } = await import("../../../config-foundation/composition-root.js");
+      const { toPhaseConfigSection } = await import(
+        "../../../config-foundation/application/mappers/phase-config-section-mapper.js"
+      );
       const configModule = createConfigFoundationModule();
       const resolvedConfig = await configModule.usecases.loadResolvedConfigUseCase.execute();
-      const { createPhaseDependencyModelModule } = await import('../../../phase-dependency-model/composition-root.js');
+      const { createPhaseDependencyModelModule } = await import("../../../phase-dependency-model/composition-root.js");
       const mod = createPhaseDependencyModelModule({
         rootDir: process.cwd(),
         phaseConfig: toPhaseConfigSection(resolvedConfig.config),
@@ -42,10 +63,10 @@ export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPor
           satisfied: false,
           violations: [
             {
-              code: { value: 'L2-001', toString: () => 'L2-001' },
-              severity: { value: 'error', toString: () => 'error' },
+              code: { value: "L2-001", toString: () => "L2-001" },
+              severity: { value: "error", toString: () => "error" },
               message: result.text,
-              suggestion: 'phase gate prerequisites are not met',
+              suggestion: buildPhaseGateRecoverySuggestion(context.unitName),
             },
           ],
         };
@@ -57,10 +78,10 @@ export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPor
         satisfied: false,
         violations: [
           {
-            code: { value: 'L2-002', toString: () => 'L2-002' },
-            severity: { value: 'error', toString: () => 'error' },
+            code: { value: "L2-002", toString: () => "L2-002" },
+            severity: { value: "error", toString: () => "error" },
             message: `phase gate check returned unexpected exit code ${result.exitCode}; prerequisites cannot be confirmed`,
-            suggestion: 'phase gate prerequisites could not be evaluated; treating as NOT satisfied (fail-closed)',
+            suggestion: "phase gate prerequisites could not be evaluated; treating as NOT satisfied (fail-closed)",
           },
         ],
       };
@@ -73,10 +94,10 @@ export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPor
         satisfied: false,
         violations: [
           {
-            code: { value: 'L2-002', toString: () => 'L2-002' },
-            severity: { value: 'error', toString: () => 'error' },
+            code: { value: "L2-002", toString: () => "L2-002" },
+            severity: { value: "error", toString: () => "error" },
             message: `phase gate prerequisite check could not be evaluated: ${message}`,
-            suggestion: 'phase gate prerequisites could not be evaluated; treating as NOT satisfied (fail-closed)',
+            suggestion: "phase gate prerequisites could not be evaluated; treating as NOT satisfied (fail-closed)",
           },
         ],
       };

package/scripts/harness/validator-system/infrastructure/adapters/traceability-metadata-policy-adapter.ts

@@ -4,8 +4,8 @@
  *
  * TraceabilityMetadataPolicyAdapter — MetadataPolicyPort実装
  */
-import type { MetadataPolicyPort } from '../../domain/ports/metadata-policy-port.js';
-import type { HarnessErrorLike } from '../../domain/value-objects/validation-result.js';
+import type { MetadataPolicyPort } from "../../domain/ports/metadata-policy-port.js";
+import type { HarnessErrorLike } from "../../domain/value-objects/validation-result.js";
 
 export class TraceabilityMetadataPolicyAdapter implements MetadataPolicyPort {
   async validateMetadata(context: { filePath: string; fileContent: string }): Promise<{
@@ -19,21 +19,26 @@ export class TraceabilityMetadataPolicyAdapter implements MetadataPolicyPort {
     const hasLayer = /@layer\s+\S+/.test(fileContent);
     const hasStoryId = /@story-id\s+H\d{2}-\d{2}/.test(fileContent) || /@story\s+H\d{2}-\d{2}/.test(fileContent);
 
+    // WI-335: この suggestion は「<directive> <値> を先頭コメントに追加」という機械適用可能な
+    // 文言契約を持つ（remediationType: 'mechanical'）。文言をこの形から変える場合は
+    // remediation-round-trip テスト（機械適用器が同じ文言を解析する）が fail する。
     if (!hasUnit) {
       errors.push({
-        code: { value: 'L2-002', toString: () => 'L2-002' },
-        severity: { value: 'error', toString: () => 'error' },
+        code: { value: "L2-002", toString: () => "L2-002" },
+        severity: { value: "error", toString: () => "error" },
         message: `メタデータ不足: @unit アノテーションがありません (${filePath})`,
-        suggestion: '// @unit <unit-name> を先頭コメントに追加してください',
+        suggestion: "// @unit <unit-name> を先頭コメントに追加してください",
+        remediationType: "mechanical",
       });
     }
 
     if (!hasLayer) {
       errors.push({
-        code: { value: 'L2-002', toString: () => 'L2-002' },
-        severity: { value: 'error', toString: () => 'error' },
+        code: { value: "L2-002", toString: () => "L2-002" },
+        severity: { value: "error", toString: () => "error" },
         message: `メタデータ不足: @layer アノテーションがありません (${filePath})`,
-        suggestion: '// @layer domain|application|infrastructure|presentation を先頭コメントに追加してください',
+        suggestion: "// @layer domain|application|infrastructure|presentation を先頭コメントに追加してください",
+        remediationType: "mechanical",
       });
     }
 

package/scripts/harness/validator-system/presentation/formatters/agent-validation-result-formatter.ts

@@ -4,34 +4,43 @@
  *
  * AgentValidationResultFormatter — AIエージェント向け詳細テキスト
  */
-import type { AggregatedValidationReport } from '../../application/dto/aggregated-validation-report.js';
+import type { AggregatedValidationReport } from "../../application/dto/aggregated-validation-report.js";
 
 export class AgentValidationResultFormatter {
   format(report: AggregatedValidationReport): string {
     const lines: string[] = [];
-    lines.push('VALIDATION_REPORT');
-    lines.push(`OVERALL: ${report.overallPassed ? 'PASS' : 'FAIL'}`);
-    lines.push(`TOTAL: ${report.totalValidators} PASSED: ${report.passedValidators} FAILED: ${report.failedValidators} SKIPPED: ${report.skippedValidators}`);
-    lines.push('');
+    lines.push("VALIDATION_REPORT");
+    lines.push(`OVERALL: ${report.overallPassed ? "PASS" : "FAIL"}`);
+    lines.push(
+      `TOTAL: ${report.totalValidators} PASSED: ${report.passedValidators} FAILED: ${report.failedValidators} SKIPPED: ${report.skippedValidators}`,
+    );
+    lines.push("");
 
     for (const result of report.results) {
       lines.push(`VALIDATOR: ${result.validatorId}`);
-      lines.push(`STATUS: ${result.skipped ? 'SKIPPED' : result.passed ? 'PASSED' : 'FAILED'}`);
+      lines.push(`STATUS: ${result.skipped ? "SKIPPED" : result.passed ? "PASSED" : "FAILED"}`);
       lines.push(`DURATION: ${result.durationMs}ms`);
       if (result.skipped && result.skipReason) {
         lines.push(`SKIP_REASON: ${result.skipReason}`);
       }
       if (result.errors.length > 0) {
-        lines.push('ERRORS:');
+        lines.push("ERRORS:");
         for (const error of result.errors) {
           lines.push(`  - CODE: ${error.code}`);
           lines.push(`    MESSAGE: ${error.message}`);
-          lines.push(`    SUGGESTION: ${error.suggestion}`);
+          // WI-357: 復旧手順を載せた suggestion は複数行になりうる。
+          // 素朴に埋め込むと 2 行目以降がインデントを失い、ERRORS ブロックの
+          // 構造が壊れて機械読みできなくなるため継続行を明示的に字下げする。
+          const suggestionLines = String(error.suggestion).split("\n");
+          lines.push(`    SUGGESTION: ${suggestionLines[0]}`);
+          for (const continuation of suggestionLines.slice(1)) {
+            lines.push(`      ${continuation}`);
+          }
         }
       }
-      lines.push('');
+      lines.push("");
     }
 
-    return lines.join('\n');
+    return lines.join("\n");
   }
 }

package/skills/quick-implementor/SKILL.md

@@ -21,6 +21,25 @@ Quick Mode下での軽微変更実装スキル。story-implementorの緩和版
 | `test` | テスト追加・修正（新機能のテストではない） |
 | `config` | 設定変更、依存バージョン更新 |
 
+> **カテゴリ判定はファイルパスベース（意図ベースではない）**
+> pre-tool-use hook は変更の「意図」ではなく **書き込み対象パス** からカテゴリを機械判定する。
+> 特に `config` は allowlist で、以下だけが `config` に落ちる:
+> `*.config.json` / `*.config.ts` / `phasegate.config.json` / `.github/workflows/*.y(a)ml` /
+> リポジトリ直下の `.gitignore` `.gitattributes` `.editorconfig` `.npmrc` `.nvmrc` `tsconfig.json` `tsconfig.*.json` / `.husky/` 配下。
+> allowlist 外のパスは新規作成（CREATE）なら `feature` に落ちて **必ずブロックされる**（fail-closed）。
+>
+> ブロックされたら、まず分類を確認する:
+> ```bash
+> npx phasegate check-change-category --paths <file1>,<file2>
+> ```
+> 判定が妥当で、かつ許可カテゴリの一時拡張が必要なら CLI 経由で計画・適用する
+> （`phasegate.config.json` の手編集は保護ファイルとしてブロックされる）:
+> ```bash
+> npx phasegate config:plan --intent quick-mode-relax --dry-run --json   # 差分確認
+> npx phasegate config:plan --intent quick-mode-relax --apply --json     # 承認後に適用
+> ```
+> 判定が `feature` / `domain` / `api` なら、それは Quick Mode のスコープ外。`story-implementor` に切り替える。
+
 ### WI-aware trivial path（ISSUE-026 Phase D）
 
 作業対象に `WI-XXX` が明示されている場合、最初に `docs/inception/{unit}/WI-XXX/description.md` または `docs/inception/_cross/WI-XXX/description.md` のfrontmatterを確認する。