システム設計法典

references/                ← テキスト正本 (git 管理)
  characters/<slug>/
    profile.md             ← キャラ設定の Single Source of Truth
    refs/sheet.jpg         ← 参照画像 (style anchor)
  style/ivs2026_aesthetic.md ← 共通ビジュアル指針
prompts/                   ← repo root 直下 (references の外)
  world_supplement_v1.yaml ← アイテム/背景マニフェスト
  storyboard_pv01.yaml     ← 絵コンテ定義

  ↓ npm run sync (predev / prebuild で自動)

site/
  content/characters/*.md  ← Next.js が読む派生物
  public/sheets/*.jpg      ← 配信用画像

  ↓ buildSupplementPrompt()

JSONL (prompt + reference_images)
  ↓ openai_batch_with_refs --concurrency 8
out/<batch>/*.png

  ↓ /review-items で OK / NG 判定 → #promote

site/public/items/<slug>.png   ← 採用 (promote)
site/public/sheets/_ng/*.jpg   ← 没 (move-rejected-to-ng)

【種別】絵コンテカット PNG — gen.mjs
【解像度】2048×1152 / quality: high

| # | id        | サイズ     | 品質 | 内容概要             |
|---|-----------|------------|------|----------------------|
| 1 | ch04_C1   | 2048×1152  | high | 沼辺の全景、霧の夜明け |
| 2 | ch04_C2   | 2048×1152  | high | ハニワ腰〜頭 MS      |

合計 2 枚 / スクリプト: node site/scripts/gen.mjs ch04 --go

【種別】映像 — /storyboard UI コピー (lib/video/prompt.ts ビルダー) + Higgsfield MCP generate_video (Kling V3 i2v 主軸 / Seedance サブ)

| # | id      | モデル                       | 長さ | 内容             |
|---|---------|------------------------------|------|------------------|
| 1 | c1-s1-1 | Kling V3 i2v (mode=pro)      | 5s   | ハニワ出土シーン |

合計 1 本 / 実行: Higgsfield MCP generate_video（コピーしたプロンプトを使用）
※ モデルは Higgsfield MCP 側で選択 (Kling V3 image-to-video 主軸 / Seedance 2.0 サブ)。
   「Omni / multi-ref」は廃止語彙

ストーリー (Story)
  └─ 章立て (Chapter) × N
       └─ シーン (Scene) × M
            └─ 字コンテ (Jikonte) — テキストによるカット仕様
                 └─ カット (Cut) × K
                      └─ カット画像 (Cut Image) — AI生成PNG
            ※ シーンボード画像 (storyboard-boards) は 2026-06-11 廃止

キャラクター (Character) — ストーリー/シーンに登場する存在
アイテム (Item / Supplement) — 物語に登場する道具・武器・背景・場所の概念画
世界観 (World) — ストーリーの背景設定 (地理・歴史・社会・ルール)
ロケーション (Location) — 具体的な撮影場所の定義

id:            "ch01"          // 識別子 (固定)
chapter_no:    1               // 表示番号 (1始まり)
chapter_label: "第1章·ハニワくん出土"
location:      "再開発地区·東京（夜）"
time_of_day:   "深夜（午前2〜3時）"
characters:    ["haniwa_boy"]   // 登場キャラ slug[]
scenes:        [...]            // JikonteScene[] → #jk-schema

scene_id: "ch01_sc01"   // シーン ID (ch<NN>_sc<NN>)

// cut.n が overlay / API / ファイル名の単一マスターキー
// 形式 = "c1-s1-1" (c<ch>-s<scene>-<cut>)。混成キー ${scene_id}_${cut.n} は spec §2 で廃止
// 表示用は cutDisplayId() で "CH01-S1-C1" に整形 (cut-naming.ts)

// Item エンティティ (lib/items.ts ItemMeta) — /items の curated 正本
interface ItemMeta {
  name:        string;
  display_name_ja: string;
  display_name_en: string;
  kind:        "key_item" | "mecha";   // ← 2値のみ
  tagline_ja?: string;
  appears_in_boards?: string[];
}

// SupplementItem (lib/supplement-items.ts) — /review-items 用の没マニフェスト (別物)
interface SupplementItem {
  no:         number;
  slug:       string;
  kind:       "character" | "item" | "background";  // ← Item.kind とは別系統
  title_ja:   string;
  title_en:   string;
  importance: "critical" | "high" | "medium" | "low";
  summary:    string;      // プロンプトに注入される設定概要
}

references/world/locations/<slug>/profile.md   ← テキスト正本 (SoT)
references/world/locations/<slug>/refs/sheet.jpg ← 参照画像 (SoT)

  ↓ npm run sync (sheet.jpg → png 変換)

site/content/locations/<slug>.md   ← 派生 (プロンプト注入用)
site/public/locations/<slug>.png   ← 派生 (絵コンテ生成の ref)

references/                    ← テキスト正本 (characters/ items/ style/ world/ boards/ brand/)
  characters/
    <slug>/
      profile.md          必須。frontmatter + 設定本文
      refs/sheet.jpg      参照画像 (style anchor として使用)
  items/
    <slug>/
      profile.md          アイテム設定 (kind: key_item|mecha)
      refs/sheet.jpg      参照画像
  world/locations/
    <slug>/
      profile.md          ロケーション設定
      refs/sheet.jpg      概念画 (sheet → public/locations/<slug>.png に変換)
  style/
    ivs2026_aesthetic.md  プロジェクト共通ビジュアル指針 (→ content/aesthetic.md)

prompts/                       ← repo root 直下 (references の外)
  world_supplement_v1.yaml     補足資料マニフェスト
  storyboard_pv01.yaml         絵コンテ定義

{
  "scripts": {
    "sync":     "node scripts/sync-env.mjs && node scripts/sync-refs.mjs && node scripts/sync-storyboard.mjs && node scripts/sync-supplement.mjs && node scripts/generate-board-manifest.mjs",
    "predev":   "npm run sync && npm run check:cutid && npm run check:overlay",
    "prebuild": "npm run sync && npm run check:cutid && npm run check:overlay",
    "dev":      "next dev --port 3300"
  }
}

---
name: haniwa_boy                    # 内部 slug (必須)
display_name_ja: ハニワモード（少年期）  # 表示名 (必須)
display_name_en: Haniwa Mode (Boy)
role: protagonist                   # enum: protagonist|rival|guardian|trial_enemy
                                    #       |gauntlet_enemy|mid_boss|enemy|final_boss
stage: "1/3"                        # 進化段階 (optional)
evolution_prev: ...                 # 前形態 slug (optional)
evolution_next: haniwa_youth        # 次形態 slug (optional)
final_form: haniwa_ashura           # 最終形態 slug (optional)
tagline_ja: ...                     # optional
threat_level: ...                   # optional
story_role: ...                     # optional
---
# 派生 (derived): sheet / ng / turnaround。alive フィールドは無い (生死は別ロジック)
本文: キャラクター設定の詳細 (Markdown)

Layer 1: BASE_PROMPT (export, lib/prompt-codex.ts)
  └─ プロジェクト全体の DNA。色・様式・禁則・メタファー変換表。
     変更は全バッチに波及するため慎重に。配信は prompt-blocks registry
     (getPromptBlock('sheet.base_prompt')) 経由。[BASE_TONMANA] は
     TEMPLATES 内の穴埋めトークン (export ではない)。

Layer 2: Subject Meta
  └─ 生成対象ごとのメタデータ (slug / kind / summary / scene)。
     SUPPLEMENT_ITEMS[] に列挙。

Layer 3: CHARACTER_CANON
  └─ 参照キャラの profile.md 全文を inline 注入。
     これによりキャラ外見の一貫性を担保する。

// 本文ブロックは getPromptBlock registry (lib/prompt-blocks.ts) 経由で読む
export function buildSupplementPrompt(item: SupplementItem): string {
  const refs = SUPPLEMENT_REF_CHARS[item.slug] ?? [];
  const refBlock = refs.map((slug) => {
    const md = readFileSync(`content/characters/${slug}.md`, "utf-8");
    // canon ヘッダは "### Character canon: <ja> (<en>) — slug:<slug>" 形式
    return `### Character canon: ... — slug:${slug}\n${md}`;
  }).join("\n\n");

  return [
    `# Tonmana base\n` + getPromptBlock("sheet.base_prompt"),  // = prompt-codex BASE_PROMPT 系
    `# Target\nslug: ${item.slug}\nkind: ${item.kind}\n${item.summary}`,
    `# Embedded character canon\n` + refBlock,
    `# Layout requirements\n` + getPromptBlock(`supplement.kind_layout.${item.kind}`),
    getPromptBlock("supplement.trail"),
  ].join("\n\n");
}

// getPromptBlock('supplement.kind_layout.character')
character:
  1) large central full-body illustration;
  2) front / side / back turnaround row;
  3) 4-5 action pose thumbnails (labelled in Japanese);
  4) 3-5 equipment/ability close-ups with annotations;
  5) personality / role text box (JP+EN sub);
  6) story-position diagram;
  7) color palette swatches.
  // chibi は無い (禁則)

STEP 0: 種別を宣言する
  → 絵コンテカットPNG / シーンボード / 映像 のどれか
  → 解像度・品質・スクリプトが種別で決まる（序 #gen-confirm 参照）
  ↓
STEP 1: JSONL (またはリクエストリスト) を構築
  ↓
STEP 2: 以下を表形式で提示してユーザー承認を待つ
  - 種別 / id / サイズ / 品質 / 内容 (画像)
  - id / モデル / 長さ / 内容        (映像)
  - 合計枚数 / 推定コスト
  ↓ (承認後のみ)
STEP 3: バッチ実行
  カット   : node site/scripts/gen.mjs <chId> --go
             (内部 python は --concurrency 10 --quality high --size 2048x1152 を自動付与)
  補足シート: python -m src.openai_batch_with_refs <jsonl> --concurrency 8
  映像     : /storyboard UI コピー → Higgsfield MCP generate_video
  ※ raw openai_batch 直焼きは禁止 (format anchor が乗らない)
  ※ gpt-image-2 は input_fidelity 未対応 (2026-05-25 API 400)。忠実度は
    プロンプト文言 (STRICTLY MATCH / PER-IMAGE ROLE MANIFEST) で担保
  ↓
STEP 4: 結果を out/<timestamp>/ に保存
STEP 5: npm run sync → public/ に反映 → /review-items で判定

$env:PYTHONIOENCODING = "utf-8"
cd C:\Users\akihi\26mv
python -m src.openai_batch_with_refs out/_supplement_with_refs.jsonl --concurrency 8

{
  "slug": "pact_seal",
  "prompt": "<buildSupplementPrompt の出力>",
  "size": "1536x1024",
  "quality": "high",
  "output_format": "png",
  "reference_images": ["public/sheets/haniwa_boy.jpg"]
}

# 全件書き出し (format anchor + style anchor を reference_images に添付)
node site/scripts/dump-supplement-prompts-with-refs.mjs

# 出力: out/_supplement_with_refs.jsonl

// SoT: content/judgments.json — { "<uid>": { decision, note, anchor?: true } }
// lib/confirmed.ts は overlay mirror から anchor:true の slug 集合を導出するシム
export const CONFIRMED_CHARS: string[] = Array.from(readOverlayMirror().anchor);

// server からの判定取得は lib/judgments-blob.ts::getJudgmentsBySlug() (slug キー)
// anchor の追加/削除は /review-items または content/judgments.json で行う
// scripts/dump-supplement-prompts-with-refs.mts が anchor キャラの sheet 画像を
// 自動収集 → JSONL の reference_images に追加

// 階層1: Chapter
interface JikonteChapter {
  id:              string;   // "ch01"
  chapter_no:      number;   // 1–16
  chapter_label:   string;   // "第1章·ハニワくん出土"
  location:        string;
  time_of_day:     string;
  characters:      string[]; // slug[]
  scenes:          JikonteScene[];
  chapter_master?: string;   // 章単位の style anchor (cut slug)
}

// 階層2: Scene
interface JikonteScene {
  scene_id:           string;       // "ch01_sc01"
  scene_no:           number;
  scene_label:        string;
  situation:          string;       // 観客に見えない因果・感情
  lighting:           string;
  props:              string;
  refs:               JikonteRef[]; // 参照画像
  cuts:               JikonteCut[];
  // ── 任意フィールド ──
  scene_transition?:  unknown;      // シーン境界の遷移技法 (resolveSceneTransition で解決)
  combat?:            boolean;      // true で cut 動画既定 = Battle Bridge
  scene_master?:      string;       // シーン単位の style anchor (cut slug)
  scene_video?:       unknown;      // scene 丸ごと長尺の first/last 等
  seedance_sequence?: unknown;      // Seedance Pro シーケンス overlay
}

// 参照画像 (三層リファレンス)
interface JikonteRef {
  slug:  string;
  kind:  "character" | "item" | "background" | "location";
  label: string;
  // path フィールドは無い。public パスは refImagePath(ref) で導出する
}

// 階層3: Cut
interface JikonteCut {
  n:                 string;  // "c1-s1-1" 形式 (c<ch>-s<scene>-<cut><suffix>。chapter→scene→cut 順。グローバル連番は廃止)
  size:              string;  // 推奨語彙 LS|WS|MS|MCU|CU|ECU|INSERT (自由記述)
  move:              string;  // 推奨語彙 FIX|DOLLY-IN|PAN-L|CRANE... (自由記述。例 "DOLLY-IN 高度から降下")
  angle:             string;  // 推奨語彙 BIRD|HI|EYE|LO|DUTCH (自由記述)
  sec:               string;  // "0:03"
  dialogue:          string | null;
  dialogue_speaker?: string;  // 任意
  composition:       string;  // カメラが何をどう切り取るか (2–5文)
  // ── 生成挙動を支配する任意フィールド ──
  orientation?:      "front" | "back";  // back で背面プロンプト + sheet_back.jpg を自動注入
  master_override?:  string;            // この cut だけ style anchor を上書き (極稀)
  reveal_namecard?:  {                  // 墨絵 namecard 1枚 (BEFORE/AFTER 2フレーム制は 2026-06-11 廃止)
    character_slug: string;
    display_name_ja: string;
    display_name_en: string;
    tagline_ja?: string;
    iconic_pose?: string;
  };
  cut_characters?:   string[];          // この cut の出演キャラ slug ホワイトリスト
  seedance?:         {                  // 二点キーフレーム長尺 (やられ描写等)
    last_cut: string;
    duration: number;
    intent?: string;
    beats?: string[];
  };
}

字コンテ TypeScript (storyboard-jikonte.ts + chapters/ch??.ts)
  ↓  node site/scripts/gen.mjs <chId> --go   (内部: dump-cuts.ts → cut-prompt-composer
                                              → openai_batch_with_refs → sync → webp → check)
PNG  → public/storyboard-cuts/<chId>/<slug>.png

命名ルール (cut-naming.ts cutToSlug):
  chId  = "ch01" / "ch02" ...
  slug  = cutToSlug(cut.n) (小文字化のみ)。cutToSlug("c1-s1-1") → "c1-s1-1"
          cut.n は c<ch>-s<scene>-<cut><suffix> 形式、scene-local 固定、グローバル連番は廃止

例: public/storyboard-cuts/ch01/c1-s1-1.png  ← Ch.1 シーン1カット1

// POST /api/storyboard/bulk-ng { approved_id }
// 1回の Blob read-modify-write で全アセットを ng に (approved_id のみ除外)
// N 回ループは禁止 (Blob 書き込みコスト増大)

const db = await readBlobJson("storyboard/status-v1.json");
for (const [id, asset] of Object.entries(db.assets)) {
  if (id !== approved_id) asset.status = "ng";
}
await writeBlobJson("storyboard/status-v1.json", db);

type Decision = "ok" | "ng" | "pending";

interface JudgmentRecord {
  decision:   Decision;
  note?:      string;     // NG 理由 or OK ポイント
  updated_at: string;     // ISO timestamp
}

interface JudgmentsStore {
  version:    "v1";
  updated_at: string;
  items:      Record<string, JudgmentRecord>;
}

export async function saveJudgment(slug: string, record: JudgmentRecord) {
  // 1. localStorage に即書き (offline 対応)
  const local = loadAll();
  local[slug] = record;
  localStorage.setItem(STORAGE_KEY, JSON.stringify(local));

  // 2. 非同期で Blob に push (失敗しても UI は壊れない)
  await fetch("/api/judgments", {
    method: "POST",
    body: JSON.stringify({ slug, ...record }),
  }).catch(() => {});
}

【採用 (OK → canonical)】
POST /api/promote { slug, base64png, target: "items" | "sheets" }
  → site/public/items/<slug>.png を上書き
  → 旧版を site/public/items/_versions/<slug>_<timestamp>.png に退避
  → site/content/items/<slug>.md を生成/更新 (canonical_status: promoted)

【没 (NG)】
  1. lib/rejected.ts の REJECTED_CHARS 配列に slug を追加
  2. node scripts/move-rejected-to-ng.mjs を実行
     → site/public/sheets/<slug>.jpg を _ng/ に 1/4 圧縮で退避
  3. /characters グリッドの「没・廃案図鑑」セクションに小サムネで表示

// ページ先頭に必須
export const dynamic = "force-dynamic";

const [all, judgmentsDoc, blobMap] = await Promise.all([
  getAllXxx(),         // references/ 由来の canonical エントリ
  getJudgments(),     // judgments/items-v1.json → ok/ng 判定
  getCanonicalMap(),  // canonical/promotions-v1.json → promote 済みの image_url
]);

const okSlugs       = new Set(Object.entries(judgmentsDoc.items)
  .filter(([, v]) => v.decision === "ok").map(([k]) => k));
const promotedSlugs = new Set(Object.keys(blobMap.items));

// 3 セクション表示:
// 1. references/ 由来の正本  (canonical)
// 2. Blob 昇格済みの補足     (promotedSlugs)
// 3. OK 判定済み・未昇格     (okSlugs - promotedSlugs)

{
  "version": "v1",
  "updated_at": "2026-05-20T...",
  "assets": {
    "<asset_id>": {
      "status":       "generated" | "approved" | "ng" | "pending",
      "image_url":    "https://...",
      "generated_at": "ISO 8601",

      // 生成コンテキスト (再現性のために記録)
      "prompt_text":        "...",
      "ref_slugs":          ["haniwa_boy"],
      "ref_image_urls":     ["/sheets/..."],
      "location_image_url": "/locations/...",
      "style_ref_url":      "https://...",
      "style_ref_asset_id": "ch01_...",

      // 生成パラメータ
      "size":         "1536x864",
      "quality":      "low" | "high",
      "api_endpoint": "/v1/images/edits" | "/v1/images/generations",

      // メタデータ
      "asset_label":   "Ch.1 再開発地区 — MASTER",
      "asset_type":    "master" | "sheet",
      "scene_id":      "ch01_sc01",
      "chapter_no":    1,
      "director_note": "...",
      "note":          "..."
    }
  },
  "proposals": {
    "<scene_id>__<proposal_id>": true
  }
}

import base64, json, time
from pathlib import Path

BLOB_PATH = Path("./db/status-v1.json")

def load_db() -> dict:
    if BLOB_PATH.exists():
        return json.loads(BLOB_PATH.read_text())
    return {"version": "v1", "updated_at": "", "assets": {}, "proposals": {}}

def save_db(db: dict):
    db["updated_at"] = time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
    BLOB_PATH.write_text(json.dumps(db, ensure_ascii=False, indent=2))

def generate_and_save(asset_id: str, prompt: str, ref_images: list[bytes]) -> str:
    import requests
    files = [("image[]", (f"ref_{i}.png", b, "image/png"))
             for i, b in enumerate(ref_images)]
    resp = requests.post(
        "https://api.openai.com/v1/images/edits",
        headers={"Authorization": f"Bearer {OPENAI_API_KEY}"},
        # 注: size/quality は外部移植の縮小デモ値。実値は
        # config/generation-params.json 由来 (cut=2048x1152/high, supplement=1536x1024/high)
        data={"model": "gpt-image-2", "prompt": prompt,
              "size": "1536x864", "quality": "low", "n": "1"},
        files=files,
    )
    b64 = resp.json()["data"][0]["b64_json"]
    out_path = Path(f"./generated/{asset_id}.png")
    out_path.write_bytes(base64.b64decode(b64))

    db = load_db()
    db["assets"][asset_id] = {
        "status": "generated",
        "image_url": str(out_path),
        "generated_at": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
    }
    save_db(db)
    return str(out_path)

PHASE 1: スタイル確定 (Style Lock)
  1. マスターショットを複数バリエーション生成 (v1, v2, v3 ...)
  2. /generations でビジュアルを確認
  3. 「これだ」と思った1枚を ★ Style Anchor に設定
  結果: 以降の全生成がこのスタイルをリファレンスとして引き継ぐ

PHASE 2: シーン展開 (Scene Expansion)
  1. スタイルアンカー固定のまま、各章のマスターショットを生成
  2. OK/NG を /generations でチェック → approved に昇格
  3. マスターショットが確定した章から絵コンテシートを生成

PHASE 3: 正本化 (Canonicalization)
  1. /review-items で採用画像を promote → public/ に配置
  2. git push → Vercel 本番に反映

# VISUAL STYLE — [PROJECT NAME]
# MANDATORY: This is a FINISHED production key frame. NOT a sketch.

## Style DNA: [Anime_A] × [Anime_B] × [Anime_C]
[STUDIO_A] [YEAR] — [what to extract]
[STUDIO_B] [YEAR] — [what to extract]

## Line Art
- OUTER SILHOUETTE: THICK, HEAVY. [8–14px] brushstroke weight.
- INTERIOR STRUCTURE: Medium [3–6px].
- TECHNIQUE: Pressure variation. Taper at line ends. Never uniform.

## Shadow System
- PARALLEL HATCHING at 45°. NOT smooth gradient.
- SOLID BLACK for absolute darks.

## FORBIDDEN
[List what destroys your aesthetic]

STEP 1: 同じシーンを3〜5バリエーション生成 (スタイルアンカーなし)
STEP 2: 「これだ」の1枚を選ぶ
  判定基準:
    ① 線質 — 手描き感・筆圧変化・テーパー
    ② 影の質 — ハッチング密度・ベタ黒の使い方
    ③ 色の深度 — フラットでなく情報量がある
    ④ カメラ言語 — 狙ったアングルが出ているか
    ⑤ キャラ再現度 — シートとの一致
STEP 3: ★ Style Anchor ボタンを押す → localStorage に保存
STEP 4: 以降の全生成でアンカーが自動適用される

[1] ANIM_STYLE ヘッダ         ← シリーズ DNA (全体の30-40%)
[2] PROJECT AESTHETIC         ← aesthetic.md から補足
[3] REFERENCE IMAGES          ← 添付画像の役割を宣言
    "CHARACTER SHEETS (haniwa_boy): match every detail exactly"
    "LOCATION IMAGE: inherit atmosphere and scale"
    "STYLE ANCHOR: match this line art style and color depth"
[4] LOCATION BLOCK            ← location_profile.md の内容
[5] SCENE SPECIFICATION       ← 章・シーン・Duration・Director's Shot Note
[6] APPROVED PROPOSALS        ← Director が確定した設定
[7] CHARACTER CANON           ← CHAR_SHEET_ANCHORS (シートあり) or 全文記述
[8] DIRECTOR'S NOTE           ← このリクエスト固有の追加指示 (省略可)
[9] RENDER TASK               ← 最後に「何を生成するか」を明示

cut.master_override        ← 個別上書き（極稀）
scene.scene_master          ← シーン単位の style anchor
chapter.chapter_master      ← 章単位の style anchor
defaultChapterMaster        ← fallback: 章最初の base cut (cut.n が
                              c<ch>-s<scene>-<cut> suffix無し、現行 = c1-s1-1) の slug。
                              動的 chapterAnchor があればそれが最優先

export interface TodoItem {
  id:      string;   // "slug-like-id"
  title:   string;
  status:  "in_progress" | "pending" | "future";
  owner:   "claude" | "user" | "system";
  detail?: string;
  refs?:   string[]; // ファイルパス / issue URL
}

export const PROJECT_TODOS: TodoItem[] = [
  // ← done になったものは削除してアーカイブへ
];

# 1. アーカイブ MD を作成
site/content/completed-tasks/<YYYY-MM-DD>__<id>.md

---
id: <short-slug>
title: <タイトル>
owner: claude | user | system
completed_at: YYYY-MM-DD
tags: [tag1, tag2]
---
何をしたか・どこを変えたか

# 2. project-todos.ts から該当 entry を削除

# 3. commit message に以下を含める
"PROJECT_TODOS から <id> を archive (content/completed-tasks/<file>)"

OPENAI_API_KEY=sk-...
BLOB_READ_WRITE_TOKEN=vercel_blob_...   # vercel env pull で取得

{
  "buildCommand": "cd site && npm run build",
  "outputDirectory": "site/.next",
  "installCommand": "cd site && npm install"
}

# または Vercel Dashboard > Project Settings > Build & Output
# Root Directory: site

[ ] 1. リポジトリを fork または template として複製
[ ] 2. references/ 配下を全削除 → 新プロジェクトの設定資料で再構築
[ ] 3. lib/prompt-codex.ts の export const BASE_PROMPT を新プロジェクト用に書き換え
       (prompt-blocks registry / video STYLE_HEADER 定数も固有として併せて見直す)
[ ] 4. lib/supplement-items.ts を新アイテム構成に書き換え
[ ] 5. lib/supplement-references.ts を新 item/char 構成に合わせて書き換え
[ ] 6. prompts/world_supplement_v1.yaml を新アイテムで再構築
[ ] 7. lib/chapters/ch01..ch15.ts を新章構成で書き換え
       (章を増減する時は ch??.ts 追加 + storyboard-jikonte.ts の import & JIKONTE_CHAPTERS map 両方更新)
[ ] 8. lib/confirmed.ts / rejected.ts を空配列でリセット
[ ] 9. lib/project-todos.ts を空配列でリセット
[ ] 10. site/content/ と site/public/sheets|items|storyboard/ を削除
      (npm run sync で再生成される)
[ ] 11. site/.env.local に OPENAI_API_KEY を設定
[ ] 12. npm run dev で動作確認 (port 3300)
[ ] 13. 字コンテ確定後に cut 画像を再生成:
       node site/scripts/gen.mjs ch01      (DRY 確認)
       node site/scripts/gen.mjs ch01 --go (実生成。ch02..ch15 反復)

# 汎用部分 (scripts / lib の型定義 / app/api) はそのまま流用できる

# 1. テキスト/設定を差し替え (上記「差し替え点」を編集)
#    references/characters/* / prompts/*.yaml / lib/prompt-codex.ts BASE_PROMPT
#    lib/supplement-items.ts / supplement-references.ts / lib/chapters/ch*.ts
#    lib/confirmed.ts / rejected.ts / project-todos.ts を新内容/空配列に

cd site && npm run sync          # references→content/public 同期 (predev/prebuild で自動)

# 2. 補足アイテム/背景シート生成 (正規経路: format anchor 同梱)
node site/scripts/dump-supplement-prompts-with-refs.mjs
python -m src.openai_batch_with_refs out/_supplement_with_refs.jsonl --label supplement_v1 --concurrency 8
cd site && npm run sync

# 3. 絵コンテ cut 画像生成 (1コマンド統合, 章ごと)
node site/scripts/gen.mjs ch01           # DRY: cut一覧+anchor健全性+概算費用→停止(確認)
node site/scripts/gen.mjs ch01 --go      # 実生成: dump→batch→sync→webp→check
#   ...ch02〜ch15 反復。bootstrap章(cut0枚)は chapter_master に既存master を当てるか c1-s1-1 先行1枚

# 4. 動画は Higgsfield MCP (Kling V3 i2v mode=pro 主軸 / Seedance 2.0 サブ)。/manual の正規プロンプト使用