phasegate 0.160.20 → 0.161.0

package/scripts/harness/validator-system/application/use-cases/run-l4-validators-usecase.ts

@@ -2,6 +2,8 @@
  * @layer application
  * @unit validator-system
  * @work-item-id WI-107 / WI-156
+ * @work-item-id WI-217
+ * @work-item-id WI-212
  *
  * RunL4ValidatorsUseCase — H08-03: L4バリデータ実行
  */
@@ -10,6 +12,7 @@ import { ValidationResult } from '../../domain/value-objects/validation-result.j
 import { LayerConfig } from '../../domain/value-objects/layer-config.js';
 import { ValidatorRegistry } from '../../domain/services/validator-registry.js';
 import { ValidatorExecutionService, ValidatorExecutionError } from '../../domain/services/validator-execution-service.js';
+import { ValidatorLanguageCapabilityService } from '../../domain/services/validator-language-capability-service.js';
 import { ValidationResultContractMapper } from '../mappers/validation-result-contract-mapper.js';
 import type { ValidationResultContract } from '../dto/validation-result-contract.js';
 import type { RunL4ValidatorsInput } from '../dto/run-l4-validators-input.js';
@@ -70,6 +73,10 @@ export interface RunL4ValidatorsUseCaseDeps {
   deadCodeDetectionService?: DeadCodeDetectionService;
   architectureSemanticAnalysisService?: ArchitectureSemanticAnalysisService;
   skillCatalogDriftPort?: SkillCatalogDriftPort;
+  pathRoots?: {
+    readonly inceptionRoot: string;
+    readonly designRoot: string;
+  };
   checkDocFreshnessUseCase?: CheckDocFreshnessUseCasePort;
   validateDocPointersUseCase?: ValidateDocPointersUseCasePort;
 }
@@ -85,8 +92,10 @@ export class RunL4ValidatorsUseCase {
   private readonly architectureSemanticAnalysisService?: ArchitectureSemanticAnalysisService;
   private readonly skillCatalogDriftPort?: SkillCatalogDriftPort;
   private readonly skillCatalogDriftService = new SkillCatalogDriftService();
+  private readonly pathRoots: { readonly inceptionRoot: string; readonly designRoot: string };
   private readonly checkDocFreshnessUseCase?: CheckDocFreshnessUseCasePort;
   private readonly validateDocPointersUseCase?: ValidateDocPointersUseCasePort;
+  private readonly languageCapabilityService = new ValidatorLanguageCapabilityService();
 
   constructor(deps: RunL4ValidatorsUseCaseDeps) {
     this.registry = deps.validatorRegistry;
@@ -98,6 +107,10 @@ export class RunL4ValidatorsUseCase {
     this.deadCodeDetectionService = deps.deadCodeDetectionService;
     this.architectureSemanticAnalysisService = deps.architectureSemanticAnalysisService;
     this.skillCatalogDriftPort = deps.skillCatalogDriftPort;
+    this.pathRoots = deps.pathRoots ?? {
+      inceptionRoot: 'docs/inception',
+      designRoot: 'docs/product/construction',
+    };
     this.checkDocFreshnessUseCase = deps.checkDocFreshnessUseCase;
     this.validateDocPointersUseCase = deps.validateDocPointersUseCase;
   }
@@ -131,11 +144,17 @@ export class RunL4ValidatorsUseCase {
           thresholds: { ...layerConfig.thresholds },
           strictOnly: layerConfig.strictOnly,
           preset: layerConfig.preset,
-        })
+      })
       : layerConfig;
 
-    const results = this.executionService.execute(definitions, [effectiveLayerConfig]);
-    const overrideMap = new Map<string, ValidationResult>(results.map((result) => [result.validatorId.value, result]));
+    const projectLanguages = await this.getProjectLanguages();
+    const { executableDefinitions, unsupportedResults } =
+      this.languageCapabilityService.splitDefinitions(definitions, projectLanguages);
+
+    const results = this.executionService.execute(executableDefinitions, [effectiveLayerConfig]);
+    const overrideMap = new Map<string, ValidationResult>(
+      [...unsupportedResults, ...results].map((result) => [result.validatorId.value, result]),
+    );
 
     if (this.driftDetectionService) {
       const l4001Result = overrideMap.get('L4-001');
@@ -158,13 +177,25 @@ export class RunL4ValidatorsUseCase {
       const l4002Result = overrideMap.get('L4-002');
       if (l4002Result && !l4002Result.skipped) {
         const report = await this.consistencyCheckService.check(input.targetUnits ? [...input.targetUnits] : undefined);
+        const reflectionResult = this.usesConfiguredDocumentRoots()
+          ? await this.consistencyCheckService.checkWorkItemReflection(this.pathRoots)
+          : undefined;
         const architectureSemanticErrors = this.architectureSemanticAnalysisService
           ? await this.architectureSemanticAnalysisService.analyze()
           : [];
-        if (report.hasMismatches() || architectureSemanticErrors.length > 0) {
+        if (report.hasMismatches() || (reflectionResult?.report.hasMismatches() ?? false) || architectureSemanticErrors.length > 0) {
           overrideMap.set(
             'L4-002',
-            ValidationResult.fail(ValidatorId.create('L4-002'), [...report.toHarnessErrors(), ...architectureSemanticErrors], 0),
+            ValidationResult.fail(
+              ValidatorId.create('L4-002'),
+              [...report.toHarnessErrors(), ...(reflectionResult?.report.toHarnessErrors() ?? []), ...architectureSemanticErrors],
+              0,
+            ),
+          );
+        } else if (reflectionResult?.skipReason && !report.hasMismatches() && architectureSemanticErrors.length === 0) {
+          overrideMap.set(
+            'L4-002',
+            ValidationResult.skipWithReason(ValidatorId.create('L4-002'), reflectionResult.skipReason),
           );
         }
       }
@@ -187,7 +218,10 @@ export class RunL4ValidatorsUseCase {
     if (this.checkDocFreshnessUseCase) {
       const l4004Result = overrideMap.get('L4-004');
       if (l4004Result && !l4004Result.skipped) {
-        const freshnessOutput = await this.checkDocFreshnessUseCase.execute({ format: 'json' });
+        const freshnessOutput = await this.checkDocFreshnessUseCase.execute({
+          format: 'json',
+          targetPattern: `${this.pathRoots.designRoot.replace(/\/+$/g, '')}/**/*.md`,
+        });
         const errors = this.toDocFreshnessHarnessErrors(freshnessOutput);
         overrideMap.set(
           'L4-004',
@@ -251,6 +285,14 @@ export class RunL4ValidatorsUseCase {
     return [...executionErrors, ...freshnessFindings];
   }
 
+  private async getProjectLanguages(): Promise<readonly string[]> {
+    return this.configPort.getProjectLanguages ? await this.configPort.getProjectLanguages() : ['typescript'];
+  }
+
+  private usesConfiguredDocumentRoots(): boolean {
+    return this.pathRoots.inceptionRoot !== 'docs/inception' || this.pathRoots.designRoot !== 'docs/product/construction';
+  }
+
   private toPointerValidationHarnessErrors(output: ValidateDocPointersOutputContract): readonly ValidationResult['errors'][number][] {
     const executionErrors = output.errors.map((error) => this.toHarnessErrorLike(
       'L4-005',

package/scripts/harness/validator-system/composition-root.ts

@@ -4,6 +4,7 @@
  *
  * DI 組み立て — validator-system の全依存関係を構築する
  * @work-item-id WI-110 / WI-111 / WI-132 / WI-133 / WI-136 / WI-137 / WI-138 / WI-156
+ * @work-item-id WI-217
  */
 import { ValidatorId } from './domain/value-objects/validator-id.js';
 import { ValidatorDefinition } from './domain/value-objects/validator-definition.js';
@@ -37,6 +38,7 @@ import { AdrFoundationReferenceAdapter } from './infrastructure/adapters/adr-fou
 import { ImportGraphSourceAnalysisAdapter } from './infrastructure/adapters/import-graph-source-analysis-adapter.js';
 import { FileSystemArchitectureSemanticSourceAdapter } from './infrastructure/adapters/file-system-architecture-semantic-source-adapter.js';
 import { FileSystemSkillCatalogDriftAdapter } from './infrastructure/adapters/file-system-skill-catalog-drift-adapter.js';
+import { FileSystemWorkItemReflectionAdapter } from './infrastructure/adapters/file-system-work-item-reflection-adapter.js';
 import { DriftDetectionService } from './domain/services/l4/drift-detection-service.js';
 import { ConsistencyCheckService } from './domain/services/l4/consistency-check-service.js';
 import { DeadCodeDetectionService } from './domain/services/l4/dead-code-detection-service.js';
@@ -55,6 +57,10 @@ const DEFAULT_CONFIG = {
     L3: { enabled: true, validators: ['L3-001', 'L3-002', 'L3-003', 'L3-004'], coverageThreshold: 90, bundleSizeLimit: 512000 },
     L4: { enabled: true, validators: ['L4-001', 'L4-002', 'L4-003', 'L4-004', 'L4-005', 'L4-006'] },
   },
+  paths: {
+    designDocs: 'docs/product/construction',
+    inceptionDocs: 'docs/inception',
+  },
   validate: { failOnWarning: false },
   architecture: {
     capabilityPolicies: {
@@ -149,8 +155,10 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
   const workItemStatusPolicyPort = new TraceabilityWorkItemStatusPolicyAdapter(process.cwd());
   const contractTraceabilityPolicyPort = new FileSystemContractTraceabilityPolicyAdapter();
 
-  const docsRoot = join(process.cwd(), 'docs/product/construction');
   const cwd = process.cwd();
+  const designDocsRoot = configData.paths?.designDocs ?? 'docs/product/construction';
+  const inceptionDocsRoot = configData.paths?.inceptionDocs ?? 'docs/inception';
+  const docsRoot = join(cwd, designDocsRoot);
   const e2eTestFileRegistryPort = new E2eTestFileRegistryAdapter({ e2eTestRoot: join(cwd, 'scripts/harness/__tests__/e2e') });
   const cliCommandRegistryPort = new CliCommandRegistryAdapter({
     commands: [
@@ -191,6 +199,7 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
   const sourceAnalysisPort = new ImportGraphSourceAnalysisAdapter();
   const architectureSemanticSourcePort = new FileSystemArchitectureSemanticSourceAdapter();
   const skillCatalogDriftPort = new FileSystemSkillCatalogDriftAdapter(cwd);
+  const workItemReflectionPort = new FileSystemWorkItemReflectionAdapter(cwd);
 
   const driftDetectionService = new DriftDetectionService({
     designDocumentPort: markdownDesignDocumentPort,
@@ -199,6 +208,7 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
   const consistencyCheckService = new ConsistencyCheckService({
     designDocumentPort: markdownDesignDocumentPort,
     adrReferencePort,
+    workItemReflectionPort,
   });
   const deadCodeDetectionService = new DeadCodeDetectionService({
     sourceAnalysisPort,
@@ -219,6 +229,10 @@ export function createValidatorSystemModule(config?: object): ValidatorSystemMod
     deadCodeDetectionService,
     architectureSemanticAnalysisService,
     skillCatalogDriftPort,
+    pathRoots: {
+      inceptionRoot: inceptionDocsRoot,
+      designRoot: designDocsRoot,
+    },
     checkDocFreshnessUseCase: phase2Extensions.checkDocFreshnessUseCase,
     validateDocPointersUseCase: phase2Extensions.validateDocPointersUseCase,
   });

package/scripts/harness/validator-system/domain/ports/validator-config-port.ts

@@ -1,6 +1,7 @@
 /**
  * @layer domain
  * @unit validator-system
+ * @work-item-id WI-212
  *
  * ValidatorConfigPort — HarnessConfigV2からLayerConfig取得
  */
@@ -8,4 +9,5 @@ import type { LayerConfig } from '../value-objects/layer-config.js';
 
 export interface ValidatorConfigPort {
   getLayerConfig(layer: 'L2' | 'L3' | 'L4'): Promise<LayerConfig>;
+  getProjectLanguages?(): Promise<readonly string[]>;
 }

package/scripts/harness/validator-system/domain/services/l4/consistency-check-service.ts

@@ -7,6 +7,7 @@
  * 設計文書間のレイヤー整合性検証（L4-002）
  */
 import { ConsistencyReport } from '../../value-objects/consistency-report.js';
+import type { MismatchPair } from '../../value-objects/consistency-report.js';
 
 export interface ConsistencyDesignDocumentPort {
   getLayerAnnotations(targetDocs?: readonly string[]): Promise<Record<string, string>>;
@@ -16,24 +17,47 @@ export interface ConsistencyAdrReferencePort {
   exists(adrRef: string): Promise<boolean>;
 }
 
+export interface WorkItemReflectionSnapshot {
+  readonly workItems: readonly {
+    readonly id: string;
+    readonly path: string;
+    readonly type?: string;
+  }[];
+  readonly productRefs: readonly {
+    readonly id: string;
+    readonly path: string;
+  }[];
+  readonly skipReason?: string;
+}
+
+export interface WorkItemReflectionPort {
+  collect(input: {
+    readonly inceptionRoot: string;
+    readonly designRoot: string;
+  }): Promise<WorkItemReflectionSnapshot>;
+}
+
 export interface ConsistencyCheckServiceDeps {
   designDocumentPort: ConsistencyDesignDocumentPort;
   adrReferencePort: ConsistencyAdrReferencePort;
+  workItemReflectionPort?: WorkItemReflectionPort;
 }
 
 export class ConsistencyCheckService {
   private readonly designDocumentPort: ConsistencyDesignDocumentPort;
   private readonly adrReferencePort: ConsistencyAdrReferencePort;
+  private readonly workItemReflectionPort?: WorkItemReflectionPort;
 
   constructor(deps: ConsistencyCheckServiceDeps) {
     this.designDocumentPort = deps.designDocumentPort;
     this.adrReferencePort = deps.adrReferencePort;
+    this.workItemReflectionPort = deps.workItemReflectionPort;
   }
 
   async check(targetDocs?: readonly string[]): Promise<ConsistencyReport> {
     const layerAnnotations = await this.designDocumentPort.getLayerAnnotations(targetDocs);
 
-    const mismatchPairs: { expected: string; actual: string; location: string }[] = [];
+    const mismatchPairs: MismatchPair[] = [];
     const checkTargets = Object.keys(layerAnnotations);
 
     for (const [location, annotation] of Object.entries(layerAnnotations)) {
@@ -75,4 +99,57 @@ export class ConsistencyCheckService {
       checkedAt: new Date().toISOString(),
     });
   }
+
+  async checkWorkItemReflection(input: {
+    readonly inceptionRoot: string;
+    readonly designRoot: string;
+  }): Promise<{ readonly report: ConsistencyReport; readonly skipReason?: string }> {
+    if (!this.workItemReflectionPort) {
+      return {
+        report: ConsistencyReport.create({ mismatchPairs: [], checkTargets: [], checkedAt: new Date().toISOString() }),
+        skipReason: 'work item reflection scanner is not configured',
+      };
+    }
+
+    const snapshot = await this.workItemReflectionPort.collect(input);
+    const checkTargets = [
+      ...snapshot.workItems.map((item) => `${item.path}#work-item:${item.id}`),
+      ...snapshot.productRefs.map((ref) => `${ref.path}#work-item:${ref.id}`),
+    ];
+    const productRefIds = new Set(snapshot.productRefs.map((ref) => ref.id));
+    const workItemIds = new Set(snapshot.workItems.map((item) => item.id));
+    const reflectionRequiredItems = snapshot.workItems.filter((item) => item.type !== 'chore');
+    const mismatchPairs: MismatchPair[] = [];
+
+    for (const item of reflectionRequiredItems) {
+      if (!productRefIds.has(item.id)) {
+        mismatchPairs.push({
+          expected: `product docs contain @work-item-id ${item.id}`,
+          actual: 'missing product reflection',
+          location: item.path,
+          nextAction: `Add @work-item-id ${item.id} to the matching product construction document under ${input.designRoot}.`,
+        });
+      }
+    }
+
+    for (const ref of snapshot.productRefs) {
+      if (!workItemIds.has(ref.id)) {
+        mismatchPairs.push({
+          expected: `inception description exists for ${ref.id}`,
+          actual: 'orphan product reflection',
+          location: ref.path,
+          nextAction: `Create or restore an inception description for ${ref.id} under ${input.inceptionRoot}, or remove the stale product annotation.`,
+        });
+      }
+    }
+
+    return {
+      report: ConsistencyReport.create({
+        mismatchPairs,
+        checkTargets,
+        checkedAt: new Date().toISOString(),
+      }),
+      skipReason: snapshot.skipReason,
+    };
+  }
 }

package/scripts/harness/validator-system/domain/services/validator-language-capability-service.ts

@@ -0,0 +1,64 @@
+/**
+ * @layer domain
+ * @unit validator-system
+ * @work-item-id WI-212
+ */
+import type { ValidatorId } from '../value-objects/validator-id.js';
+import { ValidationResult } from '../value-objects/validation-result.js';
+import type { ValidatorDefinition } from '../value-objects/validator-definition.js';
+
+const DEFAULT_SUPPORTED_LANGUAGES = ['typescript'] as const;
+
+const VALIDATOR_LANGUAGE_CAPABILITIES: Readonly<Record<string, readonly string[]>> = {
+  'L3-002': DEFAULT_SUPPORTED_LANGUAGES,
+  'L3-003': DEFAULT_SUPPORTED_LANGUAGES,
+  'L4-003': DEFAULT_SUPPORTED_LANGUAGES,
+};
+
+export class ValidatorLanguageCapabilityService {
+  getUnsupportedValidatorIds(
+    validatorIds: readonly ValidatorId[],
+    projectLanguages: readonly string[],
+  ): ReadonlySet<string> {
+    const normalizedProjectLanguages = new Set(projectLanguages.map((language) => language.toLowerCase()));
+    const unsupportedIds = validatorIds
+      .filter((validatorId) => {
+        const supportedLanguages = VALIDATOR_LANGUAGE_CAPABILITIES[validatorId.value];
+        if (!supportedLanguages) return false;
+        return !supportedLanguages.some((language) => normalizedProjectLanguages.has(language));
+      })
+      .map((validatorId) => validatorId.value);
+
+    return new Set(unsupportedIds);
+  }
+
+  splitDefinitions(
+    definitions: readonly ValidatorDefinition[],
+    projectLanguages: readonly string[],
+  ): {
+    readonly executableDefinitions: readonly ValidatorDefinition[];
+    readonly unsupportedResults: readonly ValidationResult[];
+    readonly unsupportedValidatorIds: ReadonlySet<string>;
+  } {
+    const unsupportedValidatorIds = this.getUnsupportedValidatorIds(
+      definitions.map((definition) => definition.validatorId),
+      projectLanguages,
+    );
+    const executableDefinitions = definitions.filter(
+      (definition) => !unsupportedValidatorIds.has(definition.validatorId.value),
+    );
+    const unsupportedResults = definitions
+      .filter((definition) => unsupportedValidatorIds.has(definition.validatorId.value))
+      .map((definition) => ValidationResult.skipWithReason(
+        definition.validatorId,
+        this.createSkipReason(definition.validatorId, projectLanguages),
+      ));
+
+    return { executableDefinitions, unsupportedResults, unsupportedValidatorIds };
+  }
+
+  private createSkipReason(validatorId: ValidatorId, projectLanguages: readonly string[]): string {
+    const supportedLanguages = VALIDATOR_LANGUAGE_CAPABILITIES[validatorId.value] ?? DEFAULT_SUPPORTED_LANGUAGES;
+    return `unsupported-language: ${validatorId.value} currently supports ${supportedLanguages.join(', ')}; project languages are ${projectLanguages.join(', ')}`;
+  }
+}

package/scripts/harness/validator-system/domain/value-objects/validation-result.ts

@@ -22,6 +22,7 @@ export interface ValidationResultRawProps {
   readonly errors: readonly HarnessErrorLike[];
   readonly durationMs: number;
   readonly skipped: boolean;
+  readonly skipReason?: string;
 }
 
 export class ValidationResult {
@@ -30,6 +31,7 @@ export class ValidationResult {
   readonly errors: readonly HarnessErrorLike[];
   readonly durationMs: number;
   readonly skipped: boolean;
+  readonly skipReason?: string;
 
   private constructor(props: ValidationResultRawProps) {
     this.validatorId = props.validatorId;
@@ -37,6 +39,7 @@ export class ValidationResult {
     this.errors = Object.freeze([...props.errors]);
     this.durationMs = props.durationMs;
     this.skipped = props.skipped;
+    this.skipReason = props.skipReason;
     Object.freeze(this);
   }
 
@@ -71,6 +74,10 @@ export class ValidationResult {
     return new ValidationResult({ validatorId, passed: true, errors: [], durationMs: 0, skipped: true });
   }
 
+  static skipWithReason(validatorId: ValidatorId, skipReason: string): ValidationResult {
+    return new ValidationResult({ validatorId, passed: true, errors: [], durationMs: 0, skipped: true, skipReason });
+  }
+
   hasErrors(): boolean {
     return this.errors.length > 0;
   }

package/scripts/harness/validator-system/infrastructure/adapters/file-system-work-item-reflection-adapter.ts

@@ -0,0 +1,102 @@
+/**
+ * @layer infrastructure
+ * @unit validator-system
+ * @work-item-id WI-217
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import type {
+  WorkItemReflectionPort,
+  WorkItemReflectionSnapshot,
+} from '../../domain/services/l4/consistency-check-service.js';
+
+const DESCRIPTION_FILE = 'description.md';
+const FRONTMATTER_PATTERN = /^---\r?\n([\s\S]*?)\r?\n---/;
+const WORK_ITEM_ANNOTATION_PATTERN = /@work-item-id\s+([^<\r\n]+)/g;
+
+function normalizePath(value: string): string {
+  return value.replace(/\\/g, '/');
+}
+
+async function listFiles(root: string): Promise<string[]> {
+  try {
+    const entries = await readdir(root, { withFileTypes: true });
+    const files: string[] = [];
+    for (const entry of entries) {
+      const path = join(root, entry.name);
+      if (entry.isDirectory()) {
+        files.push(...(await listFiles(path)));
+      } else if (entry.isFile()) {
+        files.push(path);
+      }
+    }
+    return files;
+  } catch {
+    return [];
+  }
+}
+
+function extractFrontmatterValue(markdown: string, key: string): string | undefined {
+  const frontmatter = FRONTMATTER_PATTERN.exec(markdown)?.[1];
+  if (!frontmatter) return undefined;
+  const pattern = new RegExp(`^${key}:\\s*(.+?)\\s*$`, 'm');
+  return pattern.exec(frontmatter)?.[1]?.replace(/^["']|["']$/g, '').trim();
+}
+
+function extractWorkItemRefs(markdown: string): string[] {
+  const refs = new Set<string>();
+  for (const match of markdown.matchAll(WORK_ITEM_ANNOTATION_PATTERN)) {
+    const raw = match[1].replace(/-->.*/, '');
+    for (const token of raw.split(/[,\s]+/).map((part) => part.trim()).filter(Boolean)) {
+      if (/^[A-Za-z][A-Za-z0-9_-]*-\d+(?:-\d+)*$/.test(token)) {
+        refs.add(token);
+      }
+    }
+  }
+  return [...refs];
+}
+
+export class FileSystemWorkItemReflectionAdapter implements WorkItemReflectionPort {
+  constructor(private readonly projectRoot: string) {}
+
+  async collect(input: {
+    readonly inceptionRoot: string;
+    readonly designRoot: string;
+  }): Promise<WorkItemReflectionSnapshot> {
+    const inceptionRoot = join(this.projectRoot, input.inceptionRoot);
+    const designRoot = join(this.projectRoot, input.designRoot);
+    const descriptionFiles = (await listFiles(inceptionRoot))
+      .filter((path) => path.endsWith(`/${DESCRIPTION_FILE}`));
+
+    if (descriptionFiles.length === 0) {
+      return {
+        workItems: [],
+        productRefs: [],
+        skipReason: `no work item descriptions found under ${input.inceptionRoot}`,
+      };
+    }
+
+    const workItems: Array<WorkItemReflectionSnapshot['workItems'][number]> = [];
+    for (const path of descriptionFiles) {
+      const markdown = await readFile(path, 'utf8');
+      const id = extractFrontmatterValue(markdown, 'id');
+      if (!id) continue;
+      workItems.push({
+        id,
+        path: normalizePath(relative(this.projectRoot, path)),
+        type: extractFrontmatterValue(markdown, 'type'),
+      });
+    }
+
+    const productRefs: Array<WorkItemReflectionSnapshot['productRefs'][number]> = [];
+    const productFiles = (await listFiles(designRoot)).filter((path) => path.endsWith('.md'));
+    for (const path of productFiles) {
+      const markdown = await readFile(path, 'utf8');
+      for (const id of extractWorkItemRefs(markdown)) {
+        productRefs.push({ id, path: normalizePath(relative(this.projectRoot, path)) });
+      }
+    }
+
+    return { workItems, productRefs };
+  }
+}

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

@@ -2,6 +2,7 @@
  * @layer infrastructure
  * @unit validator-system
  * @work-item-id WI-156
+ * @work-item-id WI-212
  *
  * HarnessConfigValidatorConfigAdapter — ValidatorConfigPort実装
  * HarnessConfigV2からLayerConfig VOを構築する
@@ -18,7 +19,7 @@ export interface HarnessConfigLayers {
 
 export interface HarnessConfigV2Like {
   preset?: 'minimal' | 'standard' | 'strict';
-  project?: { preset?: 'minimal' | 'standard' | 'strict' };
+  project?: { preset?: 'minimal' | 'standard' | 'strict'; languages?: readonly string[] };
   layers?: HarnessConfigLayers;
   harnesses?: {
     bundleSizeLimit?: number;
@@ -71,6 +72,11 @@ export class HarnessConfigValidatorConfigAdapter implements ValidatorConfigPort
     });
   }
 
+  async getProjectLanguages(): Promise<readonly string[]> {
+    const languages = this.config.project?.languages;
+    return languages && languages.length > 0 ? [...languages] : ['typescript'];
+  }
+
   private normalizeValidatorId(idOrName: string): string {
     try {
       return ValidatorId.create(idOrName).value;

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

@@ -18,6 +18,9 @@ export class AgentValidationResultFormatter {
       lines.push(`VALIDATOR: ${result.validatorId}`);
       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:');
         for (const error of result.errors) {

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

@@ -25,6 +25,9 @@ export class HumanValidationResultFormatter {
             ? 'FAIL'
             : 'WARN';
       lines.push(`[${status}] ${result.validatorId} (${result.durationMs}ms)`);
+      if (result.skipped && result.skipReason) {
+        lines.push(`  → ${result.skipReason}`);
+      }
       for (const error of result.errors) {
         lines.push(`  ⚠ ${error.message}`);
         lines.push(`  → ${error.suggestion}`);

package/skills/cascade-updater/SKILL.md

@@ -3,6 +3,7 @@ name: cascade-updater
 description: 下位フェーズの発見・変更を上位設計文書にフィードバックし影響範囲を整合的に更新
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Cascade Updater

package/skills/codebase-mapper/SKILL.md

@@ -3,6 +3,7 @@ name: codebase-mapper
 description: コードベースの構造マップを生成するスキル。全ソースファイルの `@unit`/`@layer` アノテーションを解析し、Unit・レイヤー分布・Unit間依存関係・循環依存を可視化したマップ文書を出力する。L4バリデータ（drift-detection/dead-code）の入力精度向上にも使用。使用タイミング: 「コードベースの構造を把握したい」「Unitマップを作って」「どのファイルがどのUnitに属するか調べて」「依存関係を可視化して」など。
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Codebase Mapper

package/skills/codex-delegator/SKILL.md

@@ -6,6 +6,7 @@ description: |
   使用タイミング: 「codexに委任して」「codexで並列に作成」「codexに実装させて」「agentに依頼して」など、
   codex CLIへのタスク委任・並列実行が必要な場面。
 model: codex
+languages: [typescript]
 ---
 
 # Codex Delegator

package/skills/consistency-checker/SKILL.md

@@ -3,6 +3,7 @@ name: consistency-checker
 description: AIDLC設計文書群のレイヤー間整合性チェック・矛盾/漏れ検出
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Consistency Checker

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

@@ -3,6 +3,7 @@ name: doc-freshness-checker
 description: 設計文書の鮮度チェック（L4バリデータ拡張）。`phasegate check-freshness` CLIを使い、設計文書の最終更新日が閾値を超えていないか、コード変更と設計文書の乖離がないかを検出する。使用タイミング: 「設計文書が古くなっていないか確認して」「ドキュメントの鮮度チェックを実行して」「L4 freshness チェック」「設計とコードの乖離を調べて」など。
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Doc Freshness Checker

package/skills/domain-designer/SKILL.md

@@ -2,6 +2,7 @@
 name: domain-designer
 description: DDD戦術パターンでドメインモデル（集約・エンティティ・VO・イベント）を設計（AIDLC Step 2.1）
 model: opus
+languages: [typescript]
 ---
 
 # Domain Designer

package/skills/engineering-perspective/SKILL.md

@@ -9,6 +9,7 @@ description: |
   (4) TDD/リファクタリング/DDDのベストプラクティスを適用したい
   (5) チーム議論で共通認識を構築したい
   トリガー例: 「レビューして」「これどう思う？」「設計見て」「SOLID的にどう？」「リファクタ必要？」「ドメイン的に正しい？」
+languages: [typescript]
 ---
 
 # Engineering Perspective

package/skills/environment-designer/SKILL.md

@@ -3,6 +3,7 @@ name: environment-designer
 description: ローカル開発環境のプラットフォーム構成設計。コードと環境のブリッジ（AIDLC Step 2.2並行）
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Environment Designer

package/skills/implementation-planner/SKILL.md

@@ -3,6 +3,7 @@ name: implementation-planner
 description: "Unit仕様とドメインモデル設計を元に実装計画を立てる。WI IDや機能名から関連Unitを特定し、API設計・レイヤー別実装方針を整理してmdファイルで出力する。使用タイミング: 実装計画を立てて、WI-XXXの実装方針を決めて、この機能の設計を整理して、など実装前の計画策定時。"
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Implementation Planner

package/skills/implementation-readiness-checker/SKILL.md

@@ -3,6 +3,7 @@ name: implementation-readiness-checker
 description: 実装開始前の準備状況を自動検証 - テスト設計・カバレッジ・ロジック設計の存在チェックとギャップ分析
 model: sonnet
 review: opus
+languages: [typescript]
 ---
 
 # Implementation Readiness Checker