phasegate 0.74.0 → 0.91.0

package/scripts/harness/config-foundation/domain/errors/config-foundation-domain-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit config-foundation
- *
- * config-foundation ドメイン層の基底エラークラス
- */
+// @unit config-foundation
+// @layer domain
+
 export class ConfigFoundationDomainError extends Error {
   readonly errorCode: string;
 

package/scripts/harness/config-foundation/domain/errors/invalid-preset-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit config-foundation
- *
- * project.preset が許可列挙値に一致しない場合のエラー
- */
+// @unit config-foundation
+// @layer domain
+
 import { ConfigFoundationDomainError } from './config-foundation-domain-error.js';
 
 export class InvalidPresetError extends ConfigFoundationDomainError {

package/scripts/harness/config-foundation/domain/harness-config.ts

@@ -8,6 +8,7 @@ import { UnsupportedFeatureError } from './errors/unsupported-feature-error.js';
 import { LayersConfig } from './value-objects/layers-config.js';
 import { PathsConfig } from './value-objects/paths-config.js';
 import { PhaseDependenciesConfig } from './value-objects/phase-dependencies-config.js';
+import type { PhaseDependenciesPresetId } from './value-objects/phase-dependencies-config.js';
 import { PlanningModeConfig } from './value-objects/planning-mode-config.js';
 import { ProjectConfig } from './value-objects/project-config.js';
 import { QuickModeConfig } from './value-objects/quick-mode-config.js';
@@ -23,7 +24,7 @@ import type { L4Config } from './value-objects/l4-config.js';
 export type LayerId = 'L1' | 'L2' | 'L3' | 'L4';
 export type PresetId = 'minimal' | 'standard' | 'strict';
 export type PlanningModeValue = 'interactive' | 'embedded-qa';
-export type PhaseDependenciesPresetId = 'default' | 'full' | 'standard' | 'minimal' | 'custom';
+export type { PhaseDependenciesPresetId };
 type DeepPartial<T> = {
   [K in keyof T]?: T[K] extends Array<infer TItem>
     ? Array<DeepPartial<TItem>>

package/scripts/harness/config-foundation/domain/value-objects/phase-dependencies-config.ts

@@ -7,7 +7,8 @@
  */
 import { CustomPhaseRule } from './custom-phase-rule.js';
 import type { CustomPhaseRuleProps } from './custom-phase-rule.js';
-import type { PhaseDependenciesPresetId } from '../harness-config.js';
+
+export type PhaseDependenciesPresetId = 'default' | 'full' | 'standard' | 'minimal' | 'custom';
 
 export interface PhaseDependenciesConfigProps {
   readonly preset: PhaseDependenciesPresetId;

package/scripts/harness/config-foundation/index.ts

@@ -1,26 +1,17 @@
-/**
- * @layer public-api
- * @unit config-foundation
- *
- * config-foundation ユニットのバレルエクスポート。
- */
+// @unit config-foundation
+// @layer public-api
 
-// Composition Root
 export { createConfigFoundationModule } from './composition-root.js';
 
-// Application — usecases
 export { LoadResolvedConfigUseCase } from './application/usecases/load-resolved-config-use-case.js';
 
-// Application — DTOs
 export type { ResolvedConfigOutput } from './application/dto/resolved-config-output.js';
 export type { FeatureToggleResult } from './application/dto/feature-toggle-result.js';
 export type { AvailableFeatureItem } from './application/dto/available-feature-item.js';
 
-// Presentation — CLI handlers
 export { EnableFeatureCommandHandler } from './presentation/cli/enable-feature-command-handler.js';
 export { DisableFeatureCommandHandler } from './presentation/cli/disable-feature-command-handler.js';
 
-// Domain — ports
 export type { ConfigRepositoryPort } from './domain/ports/config-repository-port.js';
 export type { ConfigSchemaValidatorPort } from './domain/ports/config-schema-validator-port.js';
 export type { FeatureRegistryPort } from './domain/ports/feature-registry-port.js';

package/scripts/harness/harness-error/application/dto/error-definition-summary.ts

@@ -1,9 +1,6 @@
-/**
- * @layer application
- * @unit harness-error
- *
- * ErrorDefinition の一覧投影DTO
- */
+// @unit harness-error
+// @layer application
+
 export interface ErrorDefinitionSummary {
   readonly code: string;
   readonly title: string;

package/scripts/harness/harness-error/application/dto/harness-error-contract.ts

@@ -1,9 +1,6 @@
-/**
- * @layer application
- * @unit harness-error
- *
- * HarnessError の公開契約DTO
- */
+// @unit harness-error
+// @layer application
+
 export interface HarnessErrorContract {
   readonly code: string;
   readonly severity: 'error' | 'warning';

package/scripts/harness/harness-error/application/dto/validator-issue-draft.ts

@@ -1,9 +1,6 @@
-/**
- * @layer application
- * @unit harness-error
- *
- * validator出力の正規化前DTO
- */
+// @unit harness-error
+// @layer application
+
 export interface ValidatorIssueDraft {
   readonly code: string;
   readonly message: string;

package/scripts/harness/harness-error/domain/errors/adr-reference-not-found-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ADR参照先が実在しない場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class AdrReferenceNotFoundError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/duplicate-error-code-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ErrorDefinitionRegistry に重複コードが登録された場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class DuplicateErrorCodeError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/invalid-adr-ref-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * AdrRef の形式不正時に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class InvalidAdrRefError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/invalid-error-code-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ErrorCode の形式不正時に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class InvalidErrorCodeError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/invalid-severity-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * Severity の入力不正時に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class InvalidSeverityError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/missing-adr-ref-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ADR参照が必須なのに未指定の場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class MissingAdrRefError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/missing-fix-example-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * fix_example が必須なのに未指定の場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class MissingFixExampleError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/severity-downgrade-violation-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * severity の格下げ（error -> warning）が試みられた場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class SeverityDowngradeViolationError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/errors/unknown-error-definition-error.ts

@@ -1,9 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * ErrorDefinitionRegistry に未登録のコードが指定された場合に送出されるドメインエラー
- */
+// @unit harness-error
+// @layer domain
+
 import { HarnessErrorDomainError } from './harness-error-domain-error.js';
 
 export class UnknownErrorDefinitionError extends HarnessErrorDomainError {

package/scripts/harness/harness-error/domain/ports/fix-example-validator-port.ts

@@ -1,10 +1,6 @@
-/**
- * @layer domain
- * @unit harness-error
- *
- * FixExample検証ポート
- * Infrastructure層が実装し、構文妥当性確認と適用後のvalidator通過を検証する
- */
+// @unit harness-error
+// @layer domain
+
 import type { ErrorCode } from '../value-objects/error-code.js';
 import type { FixExample } from '../value-objects/fix-example.js';
 import type { FixExampleValidationResult } from '../value-objects/fix-example-validation-result.js';

package/scripts/harness/nyquist-validation/application/dto/analyze-impact-output.ts

@@ -1,9 +1,5 @@
-/**
- * @layer application
- * @unit nyquist-validation
- *
- * H07-04: AnalyzeImpactUseCase 出力DTO
- */
+// @unit nyquist-validation
+// @layer application
 
 export interface TestReferenceDto {
   readonly filePath: string;

package/scripts/harness/nyquist-validation/infrastructure/adapters/ajv-json-schema-validator-adapter.ts

@@ -4,20 +4,13 @@
  *
  * JSONスキーマバリデーション実装: Ajv
  */
-import Ajv from 'ajv';
+import AjvModule, { type ErrorObject, type ValidateFunction } from 'ajv';
+const Ajv = AjvModule.default ?? AjvModule;
 import type { NyquistHarnessError } from '../../domain/services/ac-coverage-gate-policy.js';
 import type { AjvValidatorPort } from '../../application/usecases/validate-matrix-usecase.js';
 import { loadMatrixSchema } from '../schema/matrix-schema-loader.js';
 
-interface AjvErrorObject {
-  keyword: string;
-  instancePath: string;
-  schemaPath: string;
-  params: Record<string, unknown>;
-  message?: string;
-}
-
-function convertAjvError(err: AjvErrorObject): NyquistHarnessError {
+function convertAjvError(err: ErrorObject): NyquistHarnessError {
   let message: string;
 
   switch (err.keyword) {
@@ -41,27 +34,22 @@ function convertAjvError(err: AjvErrorObject): NyquistHarnessError {
 }
 
 export class AjvJsonSchemaValidatorAdapter implements AjvValidatorPort {
-  // biome-ignore lint/suspicious/noExplicitAny: Ajv v8 namespace/class type conflict
-  private readonly ajv: any;
+  private readonly ajv: InstanceType<typeof Ajv>;
 
   constructor() {
-    // biome-ignore lint/suspicious/noExplicitAny: Ajv v8 default export typing
-    this.ajv = new (Ajv as any)({ allErrors: true });
+    this.ajv = new Ajv({ allErrors: true });
   }
 
   async validate(data: unknown): Promise<{ valid: boolean; errors: NyquistHarnessError[] }> {
     const schema = await loadMatrixSchema();
-    const validateFn = this.ajv.compile(schema as object);
+    const validateFn: ValidateFunction = this.ajv.compile(schema as object);
     const valid = validateFn(data);
 
     if (valid) {
       return { valid: true, errors: [] };
     }
 
-    // biome-ignore lint/suspicious/noExplicitAny: Ajv error objects typed via AjvErrorObject cast
-    const errors: NyquistHarnessError[] = (validateFn.errors ?? []).map((e: any) =>
-      convertAjvError(e as AjvErrorObject)
-    );
+    const errors: NyquistHarnessError[] = (validateFn.errors ?? []).map((e) => convertAjvError(e));
     return { valid: false, errors };
   }
 }

package/scripts/harness/nyquist-validation/infrastructure/adapters/traceability-model-story-registry-adapter.ts

@@ -1,14 +1,10 @@
-/**
- * @layer infrastructure
- * @unit nyquist-validation
- *
- * StoryRegistryPort 実装: traceability-model アダプタ
- * @stub wave2-pending
- */
+// @unit nyquist-validation
+// @layer infrastructure
+// @stub wave2-pending
+
 import type { StoryRegistryPort } from '../../domain/ports/story-registry-port.js';
 
 export interface TraceabilityModelStoryRegistryAdapterDeps {
-  /** traceability-model から有効なstoryIdを取得するコールバック（Wave2暫定） */
   getStoryIds: () => Promise<readonly string[]>;
 }
 

package/scripts/harness/phase-dependency-model/application/usecases/check-story-reflection-usecase.ts

@@ -1,16 +1,5 @@
-/**
- * @layer application
- * @unit phase-dependency-model
- *
- * CheckStoryReflectionUseCase
- * StoryReflectionChecker をオーケストレーションし、inception → product への
- * storyId 反映状況を検証するユースケース。
- *
- * 入力: unitId, StoryReflectionConfig
- * 出力: StoryReflectionResult（pass/fail + violations/warnings）
- *
- * enabled=false の場合は即座に pass を返す。
- */
+// @unit phase-dependency-model
+// @layer application
 
 import type { StoryReflectionChecker } from '../../domain/services/story-reflection-checker.js';
 import type { StoryReflectionConfig } from '../../domain/values/story-reflection-config.js';

package/scripts/harness/phase-dependency-model/domain/ports/story-reflection-file-system-port.ts

@@ -1,12 +1,8 @@
-/**
- * @layer domain
- * @unit phase-dependency-model
- */
+// @unit phase-dependency-model
+// @layer domain
 
 export interface StoryReflectionFileSystemPort {
-  /** inception/{unit}/ 配下の storyId ディレクトリ名一覧を返す */
   listStoryDirectories(unitId: string): Promise<readonly string[]>;
-  /** ファイルの存在チェック */
   fileExists(path: string): Promise<boolean>;
   /** product 文書内に @story-id {storyId} アノテーションが含まれているか */
   fileContainsStoryAnnotation(

package/scripts/harness/quick-mode/application/dto/change-category-classification-contract.ts

@@ -1,10 +1,6 @@
-/**
- * @layer application
- * @unit quick-mode
- * @story H10-05
- *
- * ChangeCategoryClassification の公開 DTO
- */
+// @unit quick-mode
+// @layer application
+// @story H10-05
 
 export interface ChangeCategoryPerFile {
   readonly path: string;

package/scripts/harness/quick-mode/index.ts

@@ -1,11 +1,6 @@
-/**
- * @layer application
- * @unit quick-mode
- *
- * quick-mode ユニットの公開エントリポイント
- */
+// @unit quick-mode
+// @layer application
 
-// Domain Value Objects
 export { ChangeCategory, UnknownChangeCategoryError } from './domain/value-objects/change-category.js';
 export { ChangedFile } from './domain/value-objects/changed-file.js';
 export { ChangeClassification } from './domain/value-objects/change-classification.js';
@@ -14,29 +9,23 @@ export { QuickModeDecision } from './domain/value-objects/quick-mode-decision.js
 export { QuickModeEligibility } from './domain/value-objects/quick-mode-eligibility.js';
 export { ValidatorRelaxationProfile } from './domain/value-objects/validator-relaxation-profile.js';
 
-// Domain Services
 export { QuickModeJudgmentEngine } from './domain/services/quick-mode-judgment-engine.js';
 export { ValidatorRelaxationService } from './domain/services/validator-relaxation-service.js';
 
-// Application DTOs
 export type { QuickModeDecisionContract } from './application/dto/quick-mode-decision-contract.js';
 export type { QuickModeEligibilityContract } from './application/dto/quick-mode-eligibility-contract.js';
 export type { ValidatorRelaxationProfileContract } from './application/dto/validator-relaxation-profile-contract.js';
 
-// Application UseCases
 export { JudgeQuickModeEligibilityUseCase } from './application/usecases/judge-quick-mode-eligibility-usecase.js';
 export { BuildRelaxationProfileUseCase, QuickModeNotEligibleError } from './application/usecases/build-relaxation-profile-usecase.js';
 export { ExecuteQuickCiCheckUseCase } from './application/usecases/execute-quick-ci-check-usecase.js';
 
-// Application Mappers
 export { QuickModeDecisionContractMapper } from './application/mappers/quick-mode-decision-contract-mapper.js';
 
-// Infrastructure Adapters
 export { GitDiffChangedFilesAdapter, GitNotAvailableError, GitCommandError } from './infrastructure/adapters/git-diff-changed-files-adapter.js';
 export { HarnessConfigQuickModeConfigAdapter, HarnessConfigNotFoundError, HarnessConfigParseError } from './infrastructure/adapters/harness-config-quick-mode-config-adapter.js';
 export { ValidatorSystemValidatorIdRegistryAdapter } from './infrastructure/adapters/validator-system-validator-id-registry-adapter.js';
 
-// Presentation
 export { CiCheckQuickModeHandler } from './presentation/handlers/ci-check-quick-mode-handler.js';
 export { HumanQuickModeFormatter } from './presentation/formatters/human-quick-mode-formatter.js';
 export { AgentQuickModeFormatter } from './presentation/formatters/agent-quick-mode-formatter.js';

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

@@ -1,12 +1,5 @@
-/**
- * @layer infrastructure
- *
- * Harnessスキルのデプロイメントインフラ。
- * パッケージルートの skills/ を対象プロジェクトの .claude/skills/ にコピーする。
- * harness init / harness update-skills コマンドから呼び出される。
- *
- * Note: import.meta.url を使わず、呼び出し元 (main.ts) がパスを解決して渡す設計。
- */
+// @layer infrastructure
+// Note: import.meta.url を使わず、呼び出し元 (main.ts) がパスを解決して渡す設計。
 
 import { join } from 'node:path';
 import { promises as fs } from 'node:fs';
@@ -60,9 +53,6 @@ export const SKILL_CATEGORIES: Record<SkillCategory, readonly string[]> = {
   ],
 } as const;
 
-/**
- * 指定された SkillSet に含まれるスキル名の一覧を返す。
- */
 export function getSkillsForSet(skillSet: SkillSet): string[] {
   if (skillSet === 'core') {
     return [...SKILL_CATEGORIES.core];
@@ -74,9 +64,6 @@ export function getSkillsForSet(skillSet: SkillSet): string[] {
   ];
 }
 
-/**
- * スキル名からカテゴリを逆引きする。未知のスキルは null を返す。
- */
 export function getCategoryForSkill(skillName: string): SkillCategory | null {
   for (const [category, skills] of Object.entries(SKILL_CATEGORIES)) {
     if ((skills as readonly string[]).includes(skillName)) {
@@ -128,13 +115,6 @@ async function copyDirectory(src: string, dest: string): Promise<number> {
   return count;
 }
 
-/**
- * skills/ ディレクトリを対象プロジェクトの .claude/skills/ にデプロイする。
- * 既存ファイルは上書きされる（update-skills でも同じ関数を使う）。
- *
- * @param harnessRoot - harnessパッケージのルートディレクトリ（skills/がある場所）
- * @param projectRoot - デプロイ先プロジェクトのルートディレクトリ
- */
 export async function deploySkills(
   harnessRoot: string,
   projectRoot: string,
@@ -168,10 +148,6 @@ export async function deploySkills(
   return { deployedSkills: skills, targetDir: skillsTarget, version, deployedAt, skillSet };
 }
 
-/**
- * デプロイ済みバージョン情報を読み取る。
- * .harness-version ファイルが存在しない場合は null を返す。
- */
 export async function getDeployedVersion(projectRoot: string): Promise<VersionInfo | null> {
   const versionFile = join(projectRoot, SKILLS_TARGET_DIR, HARNESS_VERSION_FILE);
   try {
@@ -188,14 +164,6 @@ export interface DeployHooksResult {
   settingsCreated: boolean;
 }
 
-/**
- * templates/.claude/scripts/ を対象プロジェクトの .claude/scripts/ にデプロイする。
- * templates/.claude/settings.json も存在しなければ作成する。
- * 既存のスクリプトは上書き、settings.json は既存があればスキップ。
- *
- * @param harnessRoot - harnessパッケージのルートディレクトリ
- * @param projectRoot - デプロイ先プロジェクトのルートディレクトリ
- */
 export async function deployHookScripts(
   harnessRoot: string,
   projectRoot: string,
@@ -220,7 +188,6 @@ export async function deployHookScripts(
       }
     }
   } catch {
-    // テンプレートが存在しない場合はスキップ
   }
 
   // settings.json を作成（既存があればスキップ）
@@ -238,17 +205,12 @@ export async function deployHookScripts(
       await fs.copyFile(settingsSource, settingsTarget);
       settingsCreated = true;
     } catch {
-      // テンプレートが存在しない場合はスキップ
-    }
+      }
   }
 
   return { scriptsDeployed, settingsCreated };
 }
 
-/**
- * phasegate.config.json のデフォルトテンプレートを生成する。
- * 対象プロジェクトに phasegate.config.json が存在しない場合のみ作成する。
- */
 export async function initHarnessConfig(
   projectRoot: string,
   projectName: string,
@@ -298,12 +260,6 @@ export interface DeployDesignDocsResult {
   skippedFiles: string[];
 }
 
-/**
- * 設計原則ドキュメントを対象プロジェクトの docs/ にデプロイする。
- * - docs/folder_management_rules.md → <projectRoot>/docs/folder_management_rules.md
- * - docs/principles/*.md → <projectRoot>/docs/principles/*.md
- * 既存ファイルは上書きせずスキップする。
- */
 export async function deployDesignDocs(
   harnessRoot: string,
   projectRoot: string,
@@ -367,10 +323,6 @@ export interface DeployHuskyHookResult {
   path: string;
 }
 
-/**
- * husky pre-commit フックを対象プロジェクトの .husky/ にデプロイする。
- * 既存があればスキップする。実行権限 0o755 を付与する。
- */
 export async function deployHuskyHook(
   harnessRoot: string,
   projectRoot: string,
@@ -381,7 +333,6 @@ export async function deployHuskyHook(
     await fs.access(targetPath);
     return { created: false, path: targetPath };
   } catch {
-    // 配置先が存在しない場合は新規作成
   }
 
   const sourcePath = join(harnessRoot, 'templates', '.husky', 'pre-commit');
@@ -397,11 +348,6 @@ export interface DeployCodexHooksResult {
   path: string;
 }
 
-/**
- * Codex CLI 向け hooks.json を対象プロジェクトの .codex/ にデプロイする。
- * 既存があればスキップする (ユーザー定義 hooks を上書きしない)。
- * ISSUE-013 Wave 2: --agent codex フラグ経由で init から呼び出される。
- */
 export async function deployCodexHooks(
   harnessRoot: string,
   projectRoot: string,
@@ -412,7 +358,6 @@ export async function deployCodexHooks(
     await fs.access(targetPath);
     return { created: false, path: targetPath };
   } catch {
-    // 配置先が存在しない場合は新規作成
   }
 
   const sourcePath = join(harnessRoot, 'templates', '.codex', 'hooks.json');

package/scripts/harness/skill-quality/infrastructure/adapters/ajv-lesson-artifact-schema-adapter.ts

@@ -2,8 +2,8 @@
  * @layer infrastructure
  * @unit skill-quality
  */
-import AjvModule from 'ajv';
-const Ajv = (AjvModule as any).default ?? AjvModule;
+import AjvModule, { type ErrorObject } from 'ajv';
+const Ajv = AjvModule.default ?? AjvModule;
 import type { LessonArtifactSchemaPort } from '../../domain/ports/lesson-artifact-schema-port.js';
 import type { ValidationViolation } from '../../domain/types/validation-violation.js';
 
@@ -29,7 +29,7 @@ export class AjvLessonArtifactSchemaAdapter implements LessonArtifactSchemaPort
   async validate(json: unknown): Promise<readonly ValidationViolation[]> {
     const valid = this.compiledValidator(json);
     if (valid) return [];
-    return (this.compiledValidator.errors ?? []).map((err: any) => ({
+    return (this.compiledValidator.errors ?? []).map((err: ErrorObject) => ({
       ruleId: 'SCHEMA_VIOLATION',
       message: err.message ?? 'Schema validation error',
       location: err.instancePath,

package/scripts/harness/traceability-model/domain/services/metadata-validator.ts

@@ -13,7 +13,7 @@ import {
 import type { StoryIdLike } from '../value-objects/story-reference.js';
 import type { StoryIdAnnotation } from '../value-objects/story-id-annotation.js';
 
-const STORY_ID_PATTERN = /^H[0-9]{2}-[0-9]{2}$/;
+const STORY_ID_PATTERN = /^H(?:F\d+|[0-9]{2})-[0-9]{2}$/;
 const VALID_LAYER_NAMES = new Set([
   'domain',
   'application',

package/scripts/harness/traceability-model/domain/value-objects/story-id.ts

@@ -2,13 +2,13 @@
  * @layer domain
  * @unit traceability-model
  *
- * HXX-XX形式の正規ストーリーID
+ * HXX-XX形式の正規ストーリーID（Phase 2 拡張 Epic として HF\d+-XX も許容）
  */
-const STORY_ID_PATTERN = /^H(?<epicNumber>[0-9]{2})-(?<storyNumber>[0-9]{2})$/;
+const STORY_ID_PATTERN = /^H(?<epicNumber>F\d+|\d{2})-(?<storyNumber>\d{2})$/;
 
 export class StoryIdFormatError extends Error {
   constructor(value: string) {
-    super(`StoryIdはHXX-XX形式で指定してください: ${value}`);
+    super(`StoryIdはHXX-XX形式（HF\\d+-XX も可）で指定してください: ${value}`);
     this.name = 'StoryIdFormatError';
   }
 }