phasegate 0.315.0 → 0.335.0

package/scripts/harness/quick-mode/domain/value-objects/category-override-rules.ts

@@ -0,0 +1,147 @@
+/**
+ * @layer domain
+ * @unit quick-mode
+ * @work-item-id WI-372
+ *
+ * `quickMode.categoryOverrides` を表す値オブジェクト。
+ * ChangeCategory 7 値をキー、glob パターン列を値とする写像で、
+ * プロジェクト固有パス（`results/**` 等）を任意カテゴリへ割り当てる。
+ */
+
+import { QuickModeConfigError } from '../errors/quick-mode-config-error.js';
+import {
+  CHANGE_CATEGORY_VALUES,
+  ChangeCategory,
+  type ChangeCategoryValue,
+  isChangeCategoryValue,
+} from './change-category.js';
+
+/**
+ * glob → 正規表現の変換。
+ *
+ * domain 層は repo 全体で外部 npm パッケージを import していないため
+ * （picomatch は infrastructure adapter 専用）、
+ * `agent-integration/domain/value-objects/protected-file-list.ts` と同型の
+ * 純正規表現実装を採る（logical_design.md LD-10）。
+ *
+ * サポートする記法:
+ * - `**` … `/` を含む任意の文字列
+ * - `*`  … `/` を含まない任意の文字列
+ * - `?`  … `/` 以外の 1 文字
+ * - その他はリテラル（正規表現メタ文字はエスケープ）
+ */
+function globToRegExp(pattern: string): RegExp {
+  const regexSource = pattern
+    .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+    .replace(/\*\*/g, '__DOUBLE_STAR__')
+    .replace(/\*/g, '[^/]*')
+    .replace(/__DOUBLE_STAR__/g, '.*')
+    .replace(/\?/g, '[^/]');
+  return new RegExp(`^${regexSource}$`);
+}
+
+export type CategoryOverrideRulesInput = Readonly<Record<string, readonly string[]>>;
+
+export class CategoryOverrideRules {
+  private readonly patterns: ReadonlyMap<ChangeCategoryValue, readonly string[]>;
+  private readonly matchers: ReadonlyMap<ChangeCategoryValue, readonly RegExp[]>;
+
+  private constructor(
+    patterns: ReadonlyMap<ChangeCategoryValue, readonly string[]>,
+    matchers: ReadonlyMap<ChangeCategoryValue, readonly RegExp[]>,
+  ) {
+    this.patterns = patterns;
+    this.matchers = matchers;
+    Object.freeze(this);
+  }
+
+  static empty(): CategoryOverrideRules {
+    return new CategoryOverrideRules(new Map(), new Map());
+  }
+
+  static create(raw: CategoryOverrideRulesInput | undefined | null): CategoryOverrideRules {
+    if (raw === undefined || raw === null) {
+      return CategoryOverrideRules.empty();
+    }
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+      throw new QuickModeConfigError('categoryOverrides must be an object keyed by change category');
+    }
+
+    const patterns = new Map<ChangeCategoryValue, readonly string[]>();
+    const matchers = new Map<ChangeCategoryValue, readonly RegExp[]>();
+
+    for (const [key, value] of Object.entries(raw)) {
+      if (!isChangeCategoryValue(key)) {
+        throw new QuickModeConfigError(
+          `categoryOverrides contains unknown category "${key}". Valid values: ${CHANGE_CATEGORY_VALUES.join(', ')}`,
+        );
+      }
+      if (!Array.isArray(value)) {
+        throw new QuickModeConfigError(`categoryOverrides.${key} must be an array of glob patterns`);
+      }
+      for (const pattern of value) {
+        if (typeof pattern !== 'string' || pattern.length === 0) {
+          throw new QuickModeConfigError(
+            `categoryOverrides.${key} must not contain an empty or non-string glob pattern`,
+          );
+        }
+      }
+      if (value.length === 0) {
+        continue;
+      }
+      patterns.set(key, Object.freeze([...value]));
+      matchers.set(key, Object.freeze(value.map(globToRegExp)));
+    }
+
+    return new CategoryOverrideRules(patterns, matchers);
+  }
+
+  isEmpty(): boolean {
+    return this.matchers.size === 0;
+  }
+
+  /**
+   * パスに対応する override カテゴリを返す。
+   * 一致が無ければ null（組み込み分類へ委譲）。
+   * 複数カテゴリに一致した場合はリスク優先度が最も高いカテゴリを返すため、
+   * JSON のキー列挙順に依存しない決定的な結果になる（domain_model.md DD-4）。
+   */
+  resolve(filePath: string): ChangeCategory | null {
+    if (filePath === '' || this.matchers.size === 0) {
+      return null;
+    }
+
+    let resolved: ChangeCategory | null = null;
+    let resolvedPriority = -1;
+
+    for (const [category, regexps] of this.matchers) {
+      if (!regexps.some((regexp) => regexp.test(filePath))) {
+        continue;
+      }
+      const candidate = ChangeCategory.fromString(category);
+      const priority = candidate.riskPriority();
+      if (priority > resolvedPriority) {
+        resolvedPriority = priority;
+        resolved = candidate;
+      }
+    }
+
+    return resolved;
+  }
+
+  /** キーは ChangeCategory 語彙順に正規化する（equals をキー順に依存させないため） */
+  toRecord(): Readonly<Record<string, readonly string[]>> {
+    const record: Record<string, readonly string[]> = {};
+    for (const category of CHANGE_CATEGORY_VALUES) {
+      const globs = this.patterns.get(category);
+      if (globs !== undefined) {
+        record[category] = globs;
+      }
+    }
+    return Object.freeze(record);
+  }
+
+  equals(other: CategoryOverrideRules): boolean {
+    return JSON.stringify(this.toRecord()) === JSON.stringify(other.toRecord());
+  }
+}

package/scripts/harness/quick-mode/domain/value-objects/change-category.ts

@@ -24,6 +24,31 @@ const VALID_CATEGORIES: readonly ChangeCategoryValue[] = [
   'api',
 ] as const;
 
+/**
+ * ChangeCategory の語彙。config の enum 検証や categoryOverrides の
+ * キー検証はこの定義を唯一の権威として参照する。
+ * @work-item-id WI-372
+ */
+export const CHANGE_CATEGORY_VALUES: readonly ChangeCategoryValue[] = VALID_CATEGORIES;
+
+/** 与えられた文字列が ChangeCategory の語彙に含まれるか（正規化はしない） */
+export function isChangeCategoryValue(raw: string): raw is ChangeCategoryValue {
+  return VALID_CATEGORIES.includes(raw as ChangeCategoryValue);
+}
+
+// リスク順優先度（api > domain > feature > bugfix > test > config > docs）。
+// 複数の分類条件に一致した場合に、より高リスク側へ倒すための順序定義。
+// @work-item-id WI-372
+const RISK_PRIORITY: Record<ChangeCategoryValue, number> = {
+  api: 6,
+  domain: 5,
+  feature: 4,
+  bugfix: 3,
+  test: 2,
+  config: 1,
+  docs: 0,
+};
+
 export class UnknownChangeCategoryError extends Error {
   constructor(raw: string) {
     super(`Unknown change category: "${raw}". Valid values: ${VALID_CATEGORIES.join(', ')}`);
@@ -50,6 +75,14 @@ export class ChangeCategory {
     return this.value === 'domain' || this.value === 'feature' || this.value === 'api';
   }
 
+  /**
+   * リスク優先度。値が大きいほど高リスク（api=6 ... docs=0）。
+   * @work-item-id WI-372
+   */
+  riskPriority(): number {
+    return RISK_PRIORITY[this.value];
+  }
+
   toString(): string {
     return this.value;
   }

package/scripts/harness/quick-mode/domain/value-objects/quick-mode-config.ts

@@ -5,12 +5,14 @@
  * Quick Mode設定を表す値オブジェクト
  */
 
-export class QuickModeConfigError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'QuickModeConfigError';
-  }
-}
+import { QuickModeConfigError } from '../errors/quick-mode-config-error.js';
+import {
+  CategoryOverrideRules,
+  type CategoryOverrideRulesInput,
+} from './category-override-rules.js';
+import { CHANGE_CATEGORY_VALUES, isChangeCategoryValue } from './change-category.js';
+
+export { QuickModeConfigError };
 
 export type FullModeRequiredRuleId = 'mixedCategories' | 'newDomainFile' | 'apiContractChange';
 
@@ -32,17 +34,21 @@ export class QuickModeConfig {
   readonly maintainedLayers: readonly string[];
   readonly relaxedGates: readonly string[];
   readonly fullModeRequiredWhen: FullModeRequiredRules;
+  /** @work-item-id WI-372 プロジェクト固有パスのカテゴリ割当ルール（未設定時は空） */
+  readonly categoryOverrides: CategoryOverrideRules;
 
   private constructor(
     allowedCategories: readonly string[],
     maintainedLayers: readonly string[],
     relaxedGates: readonly string[],
-    fullModeRequiredWhen: FullModeRequiredRules
+    fullModeRequiredWhen: FullModeRequiredRules,
+    categoryOverrides: CategoryOverrideRules
   ) {
     this.allowedCategories = allowedCategories;
     this.maintainedLayers = maintainedLayers;
     this.relaxedGates = relaxedGates;
     this.fullModeRequiredWhen = fullModeRequiredWhen;
+    this.categoryOverrides = categoryOverrides;
     Object.freeze(this);
   }
 
@@ -51,13 +57,26 @@ export class QuickModeConfig {
     maintainedLayers: string[];
     relaxedGates: string[];
     fullModeRequiredWhen?: Partial<FullModeRequiredRules>;
+    categoryOverrides?: CategoryOverrideRulesInput;
   }): QuickModeConfig {
-    const { allowedCategories, maintainedLayers, relaxedGates, fullModeRequiredWhen } = raw;
+    const { allowedCategories, maintainedLayers, relaxedGates, fullModeRequiredWhen, categoryOverrides } = raw;
 
     if (allowedCategories.length === 0) {
       throw new QuickModeConfigError('allowedCategories must not be empty');
     }
 
+    // WI-373: allowedCategories は ChangeCategory 7 値の enum。
+    // 従来は非空チェックのみだったため "typoo" のような未知値が黙って通り、
+    // 「設定したのに効かない」状態になっていた。分類結果のキーは常に小文字なので
+    // 大文字小文字の正規化はせず厳密一致で拒否する（正規化は効かない設定の黙認になる）。
+    for (const category of allowedCategories) {
+      if (!isChangeCategoryValue(category)) {
+        throw new QuickModeConfigError(
+          `allowedCategories contains unknown category "${category}". Valid values: ${CHANGE_CATEGORY_VALUES.join(', ')}`
+        );
+      }
+    }
+
     const mergedRules: FullModeRequiredRules = Object.freeze({
       mixedCategories: fullModeRequiredWhen?.mixedCategories ?? DEFAULT_FULL_MODE_REQUIRED_WHEN.mixedCategories,
       newDomainFile: fullModeRequiredWhen?.newDomainFile ?? DEFAULT_FULL_MODE_REQUIRED_WHEN.newDomainFile,
@@ -68,7 +87,8 @@ export class QuickModeConfig {
       Object.freeze([...allowedCategories]),
       Object.freeze([...maintainedLayers]),
       Object.freeze([...relaxedGates]),
-      mergedRules
+      mergedRules,
+      CategoryOverrideRules.create(categoryOverrides)
     );
   }
 
@@ -100,7 +120,8 @@ export class QuickModeConfig {
       JSON.stringify(this.relaxedGates) === JSON.stringify(other.relaxedGates) &&
       this.fullModeRequiredWhen.mixedCategories === other.fullModeRequiredWhen.mixedCategories &&
       this.fullModeRequiredWhen.newDomainFile === other.fullModeRequiredWhen.newDomainFile &&
-      this.fullModeRequiredWhen.apiContractChange === other.fullModeRequiredWhen.apiContractChange
+      this.fullModeRequiredWhen.apiContractChange === other.fullModeRequiredWhen.apiContractChange &&
+      this.categoryOverrides.equals(other.categoryOverrides)
     );
   }
 }

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

@@ -1,7 +1,13 @@
 // @unit quick-mode
 // @layer application
 
-export { ChangeCategory, UnknownChangeCategoryError } from './domain/value-objects/change-category.js';
+export {
+  CHANGE_CATEGORY_VALUES,
+  ChangeCategory,
+  isChangeCategoryValue,
+  UnknownChangeCategoryError,
+} from './domain/value-objects/change-category.js';
+export { CategoryOverrideRules } from './domain/value-objects/category-override-rules.js';
 export { ChangedFile } from './domain/value-objects/changed-file.js';
 export { ChangeClassification } from './domain/value-objects/change-classification.js';
 export { QuickModeConfig, QuickModeConfigError } from './domain/value-objects/quick-mode-config.js';

package/scripts/harness/quick-mode/infrastructure/adapters/harness-config-quick-mode-config-adapter.ts

@@ -2,81 +2,132 @@
  * @layer infrastructure
  * @unit quick-mode
  * @work-item-id WI-140
+ * @work-item-id WI-372
+ * @work-item-id WI-377
  *
  * phasegate.config.json から QuickModeConfig を取得する Adapter
+ *
+ * ADR-040: 実効値は config-foundation の防御プリセット解決を経由して決定する。
+ * preset 定義（presets/*.json の quickMode）が実効値の所在であり、
+ * 下の DEFAULT_QUICK_MODE_CONFIG は preset 解決不能時の fail-open 用フォールバックである。
  */
 
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { QuickModeConfig } from '../../domain/value-objects/quick-mode-config.js';
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import type {
+  HarnessConfigResolvedDocument,
+  HarnessConfigSourceDocument,
+  PresetId,
+} from "../../../config-foundation/domain/harness-config.js";
+import { PresetResolutionService } from "../../../config-foundation/domain/services/preset-resolution-service.js";
+import { PresetDefinitionStore } from "../../../config-foundation/infrastructure/preset-definition-store.js";
+import { QuickModeConfig } from "../../domain/value-objects/quick-mode-config.js";
 
 export class HarnessConfigNotFoundError extends Error {
   constructor(filePath: string) {
     super(`phasegate.config.json not found: ${filePath}`);
-    this.name = 'HarnessConfigNotFoundError';
+    this.name = "HarnessConfigNotFoundError";
   }
 }
 
 export class HarnessConfigParseError extends Error {
   constructor(message: string) {
     super(`Failed to parse phasegate.config.json: ${message}`);
-    this.name = 'HarnessConfigParseError';
+    this.name = "HarnessConfigParseError";
   }
 }
 
+/**
+ * preset 解決が使えない config（未知 preset / project 欠落 / 他セクション不正）でも
+ * Quick Mode 判定を止めないためのフォールバック。ADR-038 §3-1 の fail-open 原則に従い、
+ * preset 解決の導入によって新たな遮断経路を作らない。
+ */
 const DEFAULT_QUICK_MODE_CONFIG = {
-  allowedCategories: ['bugfix', 'docs', 'test', 'config'],
-  maintainedLayers: ['L1', 'L2-002', 'L2-003', 'L2-014', 'L3-001'],
-  relaxedGates: ['L2-001', 'L3-002', 'L3-003', 'L3-004', 'L4'],
+  allowedCategories: ["bugfix", "docs", "test", "config"],
+  maintainedLayers: ["L1", "L2-002", "L2-003", "L2-014", "L3-001"],
+  relaxedGates: ["L2-001", "L3-002", "L3-003", "L3-004", "L4"],
 };
 
+const PRESET_IDS: readonly PresetId[] = ["minimal", "standard", "strict"];
+
+type RawQuickMode = HarnessConfigResolvedDocument["quickMode"];
+
+function isPresetId(value: unknown): value is PresetId {
+  return typeof value === "string" && PRESET_IDS.includes(value as PresetId);
+}
+
 export class HarnessConfigQuickModeConfigAdapter {
   private readonly configPath: string;
+  private readonly presetDefinitionStore: PresetDefinitionStore;
+  private readonly presetResolutionService: PresetResolutionService;
 
   constructor(configPath?: string) {
-    this.configPath = configPath ?? path.resolve(process.cwd(), 'phasegate.config.json');
+    this.configPath = configPath ?? path.resolve(process.cwd(), "phasegate.config.json");
+    this.presetDefinitionStore = new PresetDefinitionStore();
+    this.presetResolutionService = new PresetResolutionService();
   }
 
   async getQuickModeConfig(): Promise<QuickModeConfig> {
+    const parsed = await this.readSourceDocument();
+    const quickMode = this.resolveQuickMode(parsed);
+
+    return QuickModeConfig.create({
+      allowedCategories: quickMode?.allowedCategories ?? DEFAULT_QUICK_MODE_CONFIG.allowedCategories,
+      maintainedLayers: quickMode?.maintainedLayers ?? DEFAULT_QUICK_MODE_CONFIG.maintainedLayers,
+      relaxedGates: quickMode?.relaxedGates ?? DEFAULT_QUICK_MODE_CONFIG.relaxedGates,
+      fullModeRequiredWhen: quickMode?.fullModeRequiredWhen,
+      // WI-372 × WI-377 合流点: categoryOverrides は preset 解決経路と raw 縮退経路の
+      // 双方が返す `quickMode` から一様に読む。preset 定義は当該キーを宣言しないため
+      // deepMerge は source の宣言をそのまま引き継ぎ（base 側 undefined → override を clone）、
+      // preset 解決が例外で縮退した場合も raw の宣言がそのまま渡る。未設定時は空ルール
+      // = 現行分類のまま。enum 違反は QuickModeConfig.create が QuickModeConfigError を
+      // 投げ、この try/catch の外側なので fail-closed 経路へ表面化する。
+      categoryOverrides: quickMode?.categoryOverrides,
+    });
+  }
+
+  private async readSourceDocument(): Promise<Record<string, unknown>> {
     let content: string;
 
     try {
-      content = await fs.readFile(this.configPath, 'utf8') as string;
+      content = (await fs.readFile(this.configPath, "utf8")) as string;
     } catch (err) {
       const error = err as NodeJS.ErrnoException;
-      if (error.code === 'ENOENT') {
+      if (error.code === "ENOENT") {
         throw new HarnessConfigNotFoundError(this.configPath);
       }
       throw err;
     }
 
-    let parsed: Record<string, unknown>;
     try {
-      parsed = JSON.parse(content) as Record<string, unknown>;
+      return JSON.parse(content) as Record<string, unknown>;
     } catch (err) {
       throw new HarnessConfigParseError(err instanceof Error ? err.message : String(err));
     }
+  }
+
+  /**
+   * 防御プリセット解決を経由した quickMode を返す。
+   * preset が特定できない、または解決が失敗する config では raw の quickMode に縮退し、
+   * 未宣言キーは呼び出し側で DEFAULT_QUICK_MODE_CONFIG に補完される。
+   */
+  private resolveQuickMode(parsed: Record<string, unknown>): Partial<RawQuickMode> | undefined {
+    const rawQuickMode = parsed["quickMode"] as Partial<RawQuickMode> | undefined;
+    const preset = (parsed["project"] as { preset?: unknown } | undefined)?.preset;
 
-    const quickMode = parsed['quickMode'] as {
-      allowedCategories?: string[];
-      maintainedLayers?: string[];
-      relaxedGates?: string[];
-      fullModeRequiredWhen?: {
-        mixedCategories?: boolean;
-        newDomainFile?: boolean;
-        apiContractChange?: boolean;
-      };
-    } | undefined;
-
-    if (!quickMode) {
-      return QuickModeConfig.create(DEFAULT_QUICK_MODE_CONFIG);
+    if (!isPresetId(preset)) {
+      return rawQuickMode;
     }
 
-    return QuickModeConfig.create({
-      allowedCategories: quickMode.allowedCategories ?? DEFAULT_QUICK_MODE_CONFIG.allowedCategories,
-      maintainedLayers: quickMode.maintainedLayers ?? DEFAULT_QUICK_MODE_CONFIG.maintainedLayers,
-      relaxedGates: quickMode.relaxedGates ?? DEFAULT_QUICK_MODE_CONFIG.relaxedGates,
-      fullModeRequiredWhen: quickMode.fullModeRequiredWhen,
-    });
+    try {
+      const presetDefinitions = this.presetDefinitionStore.load();
+      const resolved = this.presetResolutionService.resolve(
+        parsed as unknown as HarnessConfigSourceDocument,
+        presetDefinitions[preset],
+      );
+      return resolved.quickMode;
+    } catch {
+      return rawQuickMode;
+    }
   }
 }

package/skills/product-architect/SKILL.md

@@ -35,6 +35,18 @@ languages: [typescript]
 ### 出力ファイル
 `docs/inception/_shared/product_overview_plan.md`
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/product_overview_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show product_overview_plan          # 本文を stdout に出力
+> phasegate scaffold-inception --kind product-overview-plan --apply  # 実ファイルを生成
+> ```
+>
+> scaffold した文書は無編集で Level-1 フェーズゲート（`interactive` モード）を通る。
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown
@@ -93,6 +105,13 @@ languages: [typescript]
 |------|--------|
 | 成果物 | `docs/product/product_overview.md` |
 
+> **テンプレート実体の取得（正本）**: 実体は `templates/product_overview.template.md` にある。
+>
+> ```bash
+> phasegate templates show product_overview
+> phasegate scaffold-inception --kind product-overview --apply
+> ```
+
 ### product_overview.md の構成
 
 ```markdown

package/skills/story-mapper/SKILL.md

@@ -81,6 +81,17 @@ MVPスコープの方針・分類基準・不明点を整理し、人間の承
 ### 出力ファイル
 `docs/inception/_shared/story_mapping_plan.md`
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/story_mapping_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show story_mapping_plan
+> phasegate scaffold-inception --kind story-mapping-plan --apply
+> ```
+>
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown

package/skills/story-writer/SKILL.md

@@ -45,6 +45,17 @@ If not, halt and ask the user to create the WI first, or offer to run `phasegate
 ### 出力ファイル
 `docs/inception/_shared/story_writer_plan.md`
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/story_writer_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show story_writer_plan
+> phasegate scaffold-inception --kind story-writer-plan --apply
+> ```
+>
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown

package/skills/unit-designer/SKILL.md

@@ -84,6 +84,17 @@ Unit分割の方針・グルーピングの根拠・不明点を整理し、人
 
 > **パス注記**: 本スキルが扱う設計文書パス（`docs/inception/...` / `docs/product/units/...`）は既定値であり、consumer が `phasegate.config.json` の `paths` 設定で上書きしている場合はそちらが優先される。
 
+> **テンプレート実体の取得（正本）**: 下の構成ブロックは読み取り用の要約であり、
+> 実体は `templates/unit_design_plan.template.md` にある。
+> node_modules を Read せずに取得・生成するには次を使う:
+>
+> ```bash
+> phasegate templates show unit_design_plan
+> phasegate scaffold-inception --kind unit-design-plan --apply
+> ```
+>
+> `[Answer]` は **人間が記入する**。AI が埋めると承認証跡の偽造になる。
+
 ### 計画ファイルの構成
 
 ```markdown

package/templates/product_overview.template.md

@@ -0,0 +1,85 @@
+# <プロダクト名>
+
+> **スキル**: `product-architect` Phase 2（実行）
+> **入力**: `docs/inception/_shared/product_overview_plan.md`（承認済み）
+> **作成日**: <YYYY-MM-DD>
+
+このファイルは `phasegate scaffold-inception --kind product-overview --apply`
+が生成した雛形です。TODO を実体で埋めてください。
+このドキュメントは全スキルの**前提**として参照されます。
+
+---
+
+## 1. プロダクト定義
+
+### 1.1 根本思想
+
+TODO: このプロダクトが何を信条として作られるかを 2〜3 行で記述
+
+### 1.2 解決する問題
+
+TODO: 現状の痛みと、それが放置された場合のコスト
+
+### 1.3 対象ユーザー
+
+TODO: 主ターゲットと、明示的に対象外とするユーザー
+
+## 2. コアドメイン
+
+### 2.1 主要概念（ユビキタス言語）
+
+| 概念 | 定義 | 例 |
+|------|------|-----|
+| TODO | TODO | TODO |
+
+### 2.2 概念間の関係図
+
+```mermaid
+graph TD
+  A[TODO] --> B[TODO]
+```
+
+## 3. アーキテクチャ仕様
+
+### 3.1 全体構造（レイヤー図）
+
+```
+TODO: レイヤー構成
+```
+
+### 3.2 技術スタック
+
+| レイヤー | 技術 | 選定理由 |
+|---------|------|---------|
+| TODO | TODO | TODO |
+
+### 3.3 分離方針
+
+TODO: 認証/認可、同期/非同期 等の分離方針
+
+## 4. ADR Summary（技術決定記録）
+
+| # | 決定事項 | 選択肢 | 決定 | 理由 |
+|---|---------|-------|------|------|
+| 1 | TODO | TODO | TODO | TODO |
+
+## 5. 制約
+
+### 5.1 運用上の制約
+
+TODO
+
+### 5.2 実装上の制約
+
+TODO
+
+### 5.3 パフォーマンス要件
+
+TODO
+
+---
+
+## 注意事項
+
+- ユビキタス言語はプロジェクト全体で一貫して使用する
+- 技術選定の「なぜ」を必ず ADR Summary に記録する