phasegate 0.16.0 → 0.32.0

package/scripts/harness/regression-suite/application/dto/configure-ci-gate-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { SuiteIdValue } from '../../domain/value-objects/suite-id.js';
 import type { ExecutionMode } from '../../domain/value-objects/ci-gate-config.js';
 

package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface MigrateV0TestsInput {
   confirmExecute?: boolean;
   outOfScopePattern?: string[];

package/scripts/harness/regression-suite/application/dto/migrate-v0-tests-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface MigrationMappingOutput {
   v0TestId: string;
   v1TestPath: string;

package/scripts/harness/regression-suite/application/dto/run-regression-suite-input.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { SuiteIdValue } from '../../domain/value-objects/suite-id.js';
 
 export interface RunRegressionSuiteInput {

package/scripts/harness/regression-suite/application/dto/run-regression-suite-output.ts

@@ -1,3 +1,4 @@
+// @layer application
 export interface TestFailureDetailOutput {
   testCaseId: string;
   errorMessage: string;

package/scripts/harness/regression-suite/application/mappers/migration-mapping-mapper.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { V0TestMigration } from '../../domain/aggregates/v0-test-migration.js';
 import type { MigrationMappingOutput } from '../dto/migrate-v0-tests-output.js';
 

package/scripts/harness/regression-suite/application/mappers/test-execution-summary-mapper.ts

@@ -1,3 +1,4 @@
+// @layer application
 import type { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { RunRegressionSuiteOutput } from '../dto/run-regression-suite-output.js';
 

package/scripts/harness/regression-suite/application/usecases/analyze-v0-migration-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { MigrationAnalyzer } from '../../domain/services/migration-analyzer.js';
 import type { V0SpecReaderPort } from '../../domain/ports/v0-spec-reader-port.js';
 import type { MigrationMappingRepositoryPort } from '../../domain/ports/migration-mapping-repository-port.js';

package/scripts/harness/regression-suite/application/usecases/configure-ci-gate-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { CiGateConfig } from '../../domain/value-objects/ci-gate-config.js';
 import type { ConfigQueryPort } from '../../domain/ports/config-query-port.js';

package/scripts/harness/regression-suite/application/usecases/migrate-v0-tests-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { MigrationAnalyzer } from '../../domain/services/migration-analyzer.js';
 import type { V0SpecReaderPort } from '../../domain/ports/v0-spec-reader-port.js';
 import type { MigrationMappingRepositoryPort } from '../../domain/ports/migration-mapping-repository-port.js';

package/scripts/harness/regression-suite/application/usecases/run-agent-independence-guard-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import { TestFailureDetail } from '../../domain/value-objects/test-failure-detail.js';

package/scripts/harness/regression-suite/application/usecases/run-gng-gate-regression-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/application/usecases/run-k-requirements-regression-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/application/usecases/run-k14-k15-regression-usecase.ts

@@ -1,3 +1,4 @@
+// @layer application
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { TestExecutionSummary } from '../../domain/value-objects/test-execution-summary.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/composition-root.ts

@@ -1,4 +1,5 @@
 /**
+ * @layer infrastructure
  * @unit regression-suite
  *
  * Composition Root - wires all dependencies together

package/scripts/harness/regression-suite/domain/aggregates/v0-test-migration.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestId } from '../value-objects/v0-test-id.js';
 import type { V1TestPath } from '../value-objects/v1-test-path.js';
 import type { BiomeModificationSpec } from '../value-objects/biome-modification-spec.js';

package/scripts/harness/regression-suite/domain/ports/ci-gate-result-writer-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteIdValue } from '../value-objects/suite-id.js';
 import type { TestExecutionSummary } from '../value-objects/test-execution-summary.js';
 

package/scripts/harness/regression-suite/domain/ports/config-query-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface ConfigQueryPort {
   getCoverageThreshold(): Promise<number>;
 }

package/scripts/harness/regression-suite/domain/ports/import-analyzer-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface ImportAnalyzerPort {
   analyzeImports(targetModule: string): Promise<string[]>;
 }

package/scripts/harness/regression-suite/domain/ports/migration-mapping-repository-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestMigration } from '../aggregates/v0-test-migration.js';
 import type { V0TestId } from '../value-objects/v0-test-id.js';
 import type { MigrationMapping } from '../value-objects/migration-mapping.js';

package/scripts/harness/regression-suite/domain/ports/suite-registry-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteId } from '../value-objects/suite-id.js';
 import type { RegressionSuiteDefinition } from '../value-objects/regression-suite-definition.js';
 

package/scripts/harness/regression-suite/domain/ports/test-runner-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { TestCase } from '../value-objects/regression-suite-definition.js';
 import type { CoverageRate } from '../value-objects/coverage-rate.js';
 import type { TestFailureDetail } from '../value-objects/test-failure-detail.js';

package/scripts/harness/regression-suite/domain/ports/v0-spec-reader-port.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestId } from '../value-objects/v0-test-id.js';
 
 export interface V0SpecReaderPort {

package/scripts/harness/regression-suite/domain/services/import-guard-service.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { AgentIndependenceTest } from '../value-objects/agent-independence-test.js';
 import { ImportViolation } from '../value-objects/import-violation.js';
 import type { ImportAnalyzerPort } from '../ports/import-analyzer-port.js';

package/scripts/harness/regression-suite/domain/services/migration-analyzer.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import { V0TestMigration } from '../aggregates/v0-test-migration.js';
 import { V1TestPath } from '../value-objects/v1-test-path.js';
 import { BiomeModificationSpec } from '../value-objects/biome-modification-spec.js';

package/scripts/harness/regression-suite/domain/services/regression-runner.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteId } from '../value-objects/suite-id.js';
 import { TestExecutionSummary } from '../value-objects/test-execution-summary.js';
 import { TestFailureDetail } from '../value-objects/test-failure-detail.js';

package/scripts/harness/regression-suite/domain/value-objects/agent-independence-test.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface AgentIndependenceTestProps {
   targetModule: string;
   forbiddenPatterns: string[];

package/scripts/harness/regression-suite/domain/value-objects/biome-modification-spec.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface BiomeModificationSpecProps {
   targetApi: string;
   replacementApi: string;

package/scripts/harness/regression-suite/domain/value-objects/ci-gate-config.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteId } from './suite-id.js';
 
 export type ExecutionMode = 'parallel' | 'sequential';

package/scripts/harness/regression-suite/domain/value-objects/coverage-rate.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export class CoverageRate {
   readonly value: number;
 

package/scripts/harness/regression-suite/domain/value-objects/gng-condition-test.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface GngConditionTestProps {
   gngNumber: string;
   targetUnit: string;

package/scripts/harness/regression-suite/domain/value-objects/import-violation.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface ImportViolationProps {
   modulePath: string;
   forbiddenPackage: string;

package/scripts/harness/regression-suite/domain/value-objects/k-requirement-test.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface KRequirementTestProps {
   kNumber: string;
   targetUnit: string;

package/scripts/harness/regression-suite/domain/value-objects/migration-mapping.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { V0TestId } from './v0-test-id.js';
 import type { V1TestPath } from './v1-test-path.js';
 import type { BiomeModificationSpec } from './biome-modification-spec.js';

package/scripts/harness/regression-suite/domain/value-objects/regression-suite-definition.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { SuiteId } from './suite-id.js';
 import type { KRequirementTest } from './k-requirement-test.js';
 import type { GngConditionTest } from './gng-condition-test.js';

package/scripts/harness/regression-suite/domain/value-objects/suite-id.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export type SuiteIdValue = 'k-requirements' | 'gng-gate' | 'v0-migration' | 'agent-independence';
 
 const VALID_SUITE_IDS: ReadonlySet<string> = new Set([

package/scripts/harness/regression-suite/domain/value-objects/test-execution-summary.ts

@@ -1,3 +1,4 @@
+// @layer domain
 import type { CoverageRate } from './coverage-rate.js';
 import type { TestFailureDetail } from './test-failure-detail.js';
 

package/scripts/harness/regression-suite/domain/value-objects/test-failure-detail.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export interface TestFailureDetailProps {
   testCaseId: string;
   errorMessage: string;

package/scripts/harness/regression-suite/domain/value-objects/v0-test-id.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export class V0TestId {
   readonly value: string;
 

package/scripts/harness/regression-suite/domain/value-objects/v1-test-path.ts

@@ -1,3 +1,4 @@
+// @layer domain
 export class V1TestPath {
   readonly value: string;
 

package/scripts/harness/regression-suite/infrastructure/adapters/biome-ast-import-analyzer-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import * as fs from 'node:fs/promises';
 import type { ImportAnalyzerPort } from '../../domain/ports/import-analyzer-port.js';
 

package/scripts/harness/regression-suite/infrastructure/adapters/file-system-v0-spec-reader-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { V0TestId } from '../../domain/value-objects/v0-test-id.js';

package/scripts/harness/regression-suite/infrastructure/adapters/harness-config-query-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import type { ConfigQueryPort } from '../../domain/ports/config-query-port.js';
 
 export class HarnessConfigQueryAdapter implements ConfigQueryPort {

package/scripts/harness/regression-suite/infrastructure/adapters/json-ci-gate-result-writer-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import type { SuiteIdValue } from '../../domain/value-objects/suite-id.js';

package/scripts/harness/regression-suite/infrastructure/adapters/markdown-migration-mapping-repository-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import type { V0TestMigration } from '../../domain/aggregates/v0-test-migration.js';

package/scripts/harness/regression-suite/infrastructure/adapters/static-suite-registry-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import type { SuiteId } from '../../domain/value-objects/suite-id.js';
 import type { RegressionSuiteDefinition } from '../../domain/value-objects/regression-suite-definition.js';
 import type { SuiteRegistryPort } from '../../domain/ports/suite-registry-port.js';

package/scripts/harness/regression-suite/infrastructure/adapters/vitest-test-runner-adapter.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import { execSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';

package/scripts/harness/regression-suite/infrastructure/registry/agent-independence-suite-definition.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { RegressionSuiteDefinition } from '../../domain/value-objects/regression-suite-definition.js';
 import { AgentIndependenceTest } from '../../domain/value-objects/agent-independence-test.js';

package/scripts/harness/regression-suite/infrastructure/registry/gng-gate-suite-definition.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { RegressionSuiteDefinition } from '../../domain/value-objects/regression-suite-definition.js';
 import { GngConditionTest } from '../../domain/value-objects/gng-condition-test.js';

package/scripts/harness/regression-suite/infrastructure/registry/k-requirements-suite-definition.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { RegressionSuiteDefinition } from '../../domain/value-objects/regression-suite-definition.js';
 import { KRequirementTest } from '../../domain/value-objects/k-requirement-test.js';

package/scripts/harness/regression-suite/infrastructure/registry/v0-migration-suite-definition.ts

@@ -1,3 +1,4 @@
+// @layer infrastructure
 import { SuiteId } from '../../domain/value-objects/suite-id.js';
 import { RegressionSuiteDefinition } from '../../domain/value-objects/regression-suite-definition.js';
 import { KRequirementTest } from '../../domain/value-objects/k-requirement-test.js';

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

@@ -18,16 +18,86 @@ const HARNESS_CONFIG_FILE = 'phasegate.config.json';
 const HOOKS_TEMPLATE_DIR = join('templates', '.claude');
 const HOOKS_TARGET_DIR = '.claude';
 
+// ── Skill Category Map ──
+
+export type SkillCategory = 'core' | 'aidlc' | 'utility';
+export type SkillSet = 'core' | 'all';
+
+export const SKILL_CATEGORIES: Record<SkillCategory, readonly string[]> = {
+  core: [
+    'cascade-updater',
+    'codebase-mapper',
+    'consistency-checker',
+    'doc-freshness-checker',
+    'engineering-perspective',
+    'implementation-readiness-checker',
+    'pointer-validator',
+    'test-coverage-checker',
+  ],
+  aidlc: [
+    'domain-designer',
+    'environment-designer',
+    'implementation-planner',
+    'it-test-designer',
+    'it-test-logic-designer',
+    'logical-designer',
+    'mock-designer',
+    'product-architect',
+    'quick-implementor',
+    'scenario-test-designer',
+    'scenario-test-logic-designer',
+    'story-implementor',
+    'story-mapper',
+    'story-writer',
+    'uiux-designer',
+    'unit-designer',
+    'unit-test-designer',
+    'unit-test-logic-designer',
+  ],
+  utility: [
+    'codex-delegator',
+    'skill-creator',
+  ],
+} as const;
+
+/**
+ * 指定された SkillSet に含まれるスキル名の一覧を返す。
+ */
+export function getSkillsForSet(skillSet: SkillSet): string[] {
+  if (skillSet === 'core') {
+    return [...SKILL_CATEGORIES.core];
+  }
+  return [
+    ...SKILL_CATEGORIES.core,
+    ...SKILL_CATEGORIES.aidlc,
+    ...SKILL_CATEGORIES.utility,
+  ];
+}
+
+/**
+ * スキル名からカテゴリを逆引きする。未知のスキルは null を返す。
+ */
+export function getCategoryForSkill(skillName: string): SkillCategory | null {
+  for (const [category, skills] of Object.entries(SKILL_CATEGORIES)) {
+    if ((skills as readonly string[]).includes(skillName)) {
+      return category as SkillCategory;
+    }
+  }
+  return null;
+}
+
 export interface DeployResult {
   deployedSkills: string[];
   targetDir: string;
   version: string;
   deployedAt: string;
+  skillSet: SkillSet;
 }
 
 export interface VersionInfo {
   version: string;
   deployedAt: string;
+  skillSet?: SkillSet;
 }
 
 interface PkgJson {
@@ -65,14 +135,20 @@ async function copyDirectory(src: string, dest: string): Promise<number> {
  * @param harnessRoot - harnessパッケージのルートディレクトリ（skills/がある場所）
  * @param projectRoot - デプロイ先プロジェクトのルートディレクトリ
  */
-export async function deploySkills(harnessRoot: string, projectRoot: string): Promise<DeployResult> {
+export async function deploySkills(
+  harnessRoot: string,
+  projectRoot: string,
+  skillSet: SkillSet = 'all',
+): Promise<DeployResult> {
   const skillsSource = join(harnessRoot, SKILLS_SOURCE_DIR);
   const skillsTarget = join(projectRoot, SKILLS_TARGET_DIR);
   const version = await getHarnessVersion(harnessRoot);
   const deployedAt = new Date().toISOString();
 
   const skillDirs = await fs.readdir(skillsSource, { withFileTypes: true });
-  const skills = skillDirs.filter((d) => d.isDirectory()).map((d) => d.name);
+  const allSkills = skillDirs.filter((d) => d.isDirectory()).map((d) => d.name);
+  const allowedSkills = getSkillsForSet(skillSet);
+  const skills = allSkills.filter((s) => allowedSkills.includes(s));
 
   await fs.mkdir(skillsTarget, { recursive: true });
 
@@ -82,14 +158,14 @@ export async function deploySkills(harnessRoot: string, projectRoot: string): Pr
     await copyDirectory(srcSkillDir, destSkillDir);
   }
 
-  const versionInfo: VersionInfo = { version, deployedAt };
+  const versionInfo: VersionInfo = { version, deployedAt, skillSet };
   await fs.writeFile(
     join(skillsTarget, HARNESS_VERSION_FILE),
     JSON.stringify(versionInfo, null, 2) + '\n',
     'utf-8',
   );
 
-  return { deployedSkills: skills, targetDir: skillsTarget, version, deployedAt };
+  return { deployedSkills: skills, targetDir: skillsTarget, version, deployedAt, skillSet };
 }
 
 /**
@@ -176,6 +252,7 @@ export async function deployHookScripts(
 export async function initHarnessConfig(
   projectRoot: string,
   projectName: string,
+  phasePreset?: 'full' | 'standard' | 'minimal' | 'custom',
 ): Promise<{ created: boolean; path: string }> {
   const configPath = join(projectRoot, HARNESS_CONFIG_FILE);
   try {
@@ -193,7 +270,7 @@ export async function initHarnessConfig(
     layers: {},
     quickMode: {},
     phaseDependencies: {
-      preset: 'default',
+      preset: phasePreset ?? 'default',
       override: false,
       customRules: [],
     },

package/scripts/harness/shared-kernel/harness-api.ts

@@ -1,3 +1,4 @@
+// @layer domain
 // harness-api.ts — Shared Kernel public entry for harness-api types
 
 export type { HarnessApiResponseContract } from '../harness-api/application/dto/harness-api-response-contract.js';

package/scripts/harness/skill-quality/composition-root.ts

@@ -1,4 +1,5 @@
 /**
+ * @layer infrastructure
  * @unit skill-quality
  * Composition Root - wires all dependencies together
  */

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

@@ -2,7 +2,8 @@
  * @layer infrastructure
  * @unit skill-quality
  */
-import Ajv from 'ajv';
+import AjvModule from 'ajv';
+const Ajv = (AjvModule as any).default ?? AjvModule;
 import type { LessonArtifactSchemaPort } from '../../domain/ports/lesson-artifact-schema-port.js';
 import type { ValidationViolation } from '../../domain/types/validation-violation.js';
 
@@ -17,8 +18,8 @@ const LESSON_ARTIFACT_SCHEMA = {
 };
 
 export class AjvLessonArtifactSchemaAdapter implements LessonArtifactSchemaPort {
-  private readonly ajv: Ajv;
-  private readonly compiledValidator: ReturnType<Ajv['compile']>;
+  private readonly ajv: InstanceType<typeof Ajv>;
+  private readonly compiledValidator: ReturnType<InstanceType<typeof Ajv>["compile"]>;
 
   constructor() {
     this.ajv = new Ajv();
@@ -28,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) => ({
+    return (this.compiledValidator.errors ?? []).map((err: any) => ({
       ruleId: 'SCHEMA_VIOLATION',
       message: err.message ?? 'Schema validation error',
       location: err.instancePath,

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

@@ -80,10 +80,10 @@ export class MetadataValidator {
     }>;
   }): Promise<MetadataValidationResult> {
     const errors: TraceabilityHarnessError[] = [];
-    const unitTag = input.tags.find((tag) => tag.type === '@unit');
+    const unitTags = input.tags.filter((tag) => tag.type === '@unit');
     const layerTag = input.tags.find((tag) => tag.type === '@layer');
 
-    if (!unitTag) {
+    if (unitTags.length === 0) {
       errors.push(
         createError({
           message: '@unit が必要です',
@@ -111,14 +111,16 @@ export class MetadataValidator {
       );
     }
 
-    if (unitTag && !(await hasUnit(this.unitDefinitionPort, unitTag.value))) {
-      errors.push(
-        createError({
-          message: `@unit "${unitTag.value}" は unit 定義に存在しません`,
-          suggestion: '登録済みの unit 名を指定してください',
-          fixExample: '@unit traceability-model',
-        }),
-      );
+    for (const unitTag of unitTags) {
+      if (!(await hasUnit(this.unitDefinitionPort, unitTag.value))) {
+        errors.push(
+          createError({
+            message: `@unit "${unitTag.value}" は unit 定義に存在しません`,
+            suggestion: '登録済みの unit 名を指定してください',
+            fixExample: '@unit traceability-model',
+          }),
+        );
+      }
     }
 
     if (errors.length > 0) {

package/scripts/harness/traceability-model/infrastructure/parsers/source-metadata-parser.ts

@@ -17,6 +17,20 @@ export interface ParsedMetadataTag {
   readonly lineNumber: number;
 }
 
+function expandUnitTags(rawValue: string, lineNumber: number): ParsedMetadataTag[] {
+  if (!rawValue.includes(',')) {
+    return [{ type: '@unit', value: rawValue.trim(), lineNumber }];
+  }
+  return rawValue
+    .split(',')
+    .map((v) => ({
+      type: '@unit' as const,
+      value: v.trim(),
+      lineNumber,
+    }))
+    .filter((t) => t.value.length > 0);
+}
+
 /**
  * 実装ファイル向けに @unit / @layer / @story-id を抽出する
  */
@@ -30,7 +44,7 @@ export function parseImplementationTags(content: string): readonly ParsedMetadat
 
     const unitMatch = UNIT_TAG_PATTERN.exec(line);
     if (unitMatch) {
-      tags.push({ type: '@unit', value: unitMatch[1].trim(), lineNumber });
+      tags.push(...expandUnitTags(unitMatch[1], lineNumber));
     }
 
     const layerMatch = LAYER_TAG_PATTERN.exec(line);
@@ -80,7 +94,7 @@ export function parseAllTags(content: string): readonly ParsedMetadataTag[] {
 
     const unitMatch = UNIT_TAG_PATTERN.exec(line);
     if (unitMatch) {
-      tags.push({ type: '@unit', value: unitMatch[1].trim(), lineNumber });
+      tags.push(...expandUnitTags(unitMatch[1], lineNumber));
     }
 
     const layerMatch = LAYER_TAG_PATTERN.exec(line);

package/skills/cascade-updater/SKILL.md

@@ -9,6 +9,19 @@ review: opus
 
 下位フェーズでの発見・変更・人間からの指示を、正しいレイヤーの設計文書にフィードバックし、影響範囲を整合的に更新するスキル。
 
+## storyReflection ゲート通過の標準手段
+
+`phaseDependencies.storyReflection`（ADR-013）は、`docs/inception/{unit}/{storyId}/` 配下の US/issue 設計が `docs/product/construction/{unit}/` の累積設計文書に反映されていない場合、`src/{unit}/*` および `scripts/harness/{unit}/*` への Write/Edit（Bash 迂回経由の書き込みも含む）を pre-tool-use hook でブロックする。
+
+**cascade-updater はこの storyReflection ゲートを通過する標準手段である。**
+
+- `full` / `standard` プリセットでは、inception の新規 US/issue を作成した後、実装着手前に cascade-updater を実行して product 文書に `@story-id {storyId}` を追記する
+- cascade-updater を実行せずに実装へ進もうとすると `[L2-STORY-REFLECTION]` ブロックが発生する（エラー中で本スキルの実行が案内される）
+- `minimal` プリセットでは storyReflection が無効化されるためゲート連動しないが、cascade-updater による設計整合性の維持は推奨される
+- Quick Mode (`relaxedGates: ["phase-gate"]`) 時は storyReflection も緩和されるため、cascade-updater 実行の必須性は緩まる（ただし品質維持のため実行は推奨）
+
+詳細は ADR-013 および `docs/guide/configuration.md` の storyReflection セクションを参照。
+
 ## 前提条件チェック
 
 ### 必須インプット
@@ -21,10 +34,10 @@ review: opus
 
 **このスキルは3フェーズで実行する。**
 - **Phase 1（計画）**: Opus がスコープ・方針・不明点を整理し、人間の承認を得る
-- **Phase 2（実行）**: Sonnet 4.6 に委任して成果物を生成する（`scripts/delegate-sonnet.sh` 経由）
+- **Phase 2（実行）**: プロジェクトのモデルルーティング設定に従い、実行モデルに委譲して成果物を生成する
 - **Phase 3（レビュー）**: Opus が成果物を検証し、問題があれば直接修正する
 
-**Phase 1/2/3を同時に実行してはならない。モデルルーティングの詳細は `docs/principles/model-routing.md` を参照。**
+**Phase 1/2/3を同時に実行してはならない。**
 
 ---
 
@@ -110,7 +123,7 @@ review: opus
 
 ### レビュー手順
 1. Sonnetが出力したファイルを読み込む
-2. `docs/principles/model-routing.md` のレビュー観点 R1〜R7 に沿って検証する
+2. プロジェクトのレビュー基準に沿って検証する
 3. **スキル固有レビュー観点**を検証する
 4. 判定結果を出力する