takt-marp 0.1.0

package/templates/project/facets/instructions/takt-marp-intake.md

@@ -0,0 +1,15 @@
+対象briefのdeckディレクトリを確認し、入力が実行可能か判定してください。
+
+**やること:**
+1. `slides/<deck>/brief.md`が存在しない場合は、設計ドキュメントのテンプレートで作成してください。
+2. `review/`ディレクトリがなければ作成してください。
+3. 必須見出し `Goal`、`Core Message`、`Audience Context`、`Output Requirements` を確認してください。
+4. 不足がある場合は最終応答に不足項目を書き、briefを埋めて再実行するよう案内してください。
+5. 入力が利用可能なら次へ進める状態だと報告してください。
+
+**必須出力**
+## Intake Result
+- Status: template_created / needs_input / ready
+- Deck:
+- Files changed:
+- Missing:

package/templates/project/facets/instructions/takt-marp-normalize-brief.md

@@ -0,0 +1,24 @@
+briefを後続workflowが読みやすい形に正規化してください。
+
+**やること:**
+1. `brief.md`を読み、発表目的、聴衆、中心メッセージ、出力要件を整理してください。
+2. ローカルSource Materialsが指定されている場合は存在確認し、必要な要点を抜き出してください。
+3. URLは自動取得せず、brief内に内容がない場合は非ブロッキングメモとして残してください。
+4. **発表コンテキストの確認(必須):** `brief.md` の `## Event` 見出しからイベント名と発表時間(Duration)を確認してください。`Duration` は本編の発表時間を**分単位の数値**(例: `30`)へ正規化して記載し、時間帯表記(例: 14:00〜14:30)や質疑込み表記は数値へ換算したうえで元の記述を Non-blocking notes に残してください。数値へ換算できない場合は「未指定」としてください。`Date` と `Venue` も `## Event` に記載があれば `Event Context` 節へ転記してください。イベント名・発表時間・`Date`・`Venue` のうち欠落している項目は、正規化結果の `Event Context` 節の該当項目に「未指定」と明記し、イベント名・発表時間の欠落は Non-blocking notes にも残してください。
+5. **発表コンテキストの収集(推奨):** 登壇者プロフィール(`Speaker Profile`)と事実インベントリ(`Fact Inventory`: version・数値実績・出典等の根拠)を `brief.md` および Source Materials から収集してください。情報が提供されていない場合は「未指定」とするだけで `needs_input` にはしないでください。
+6. `brief.normalized.md`を書いてください。
+
+**artifact 出力:**
+- この step には `Report Directory` / `Report File` が渡されます。`Report File` の `brief.normalized.md` を正本として必ず出力してください。
+- deck-local `slides/<deck>/brief.normalized.md` も書ける場合は同じ内容で書いてください。ただし後続 step は `Report Directory/brief.normalized.md` を読める必要があります。
+
+**判定基準:**
+- 発表日、appendix要否、PPTX要否など、スライド作成を継続できる未指定事項は非ブロッキングとして扱ってください。
+- `brief.md`が存在しない、発表目的・聴衆・中心メッセージ・出力要件のいずれも判断できない、必須Source Materialを読めない場合だけ `needs_input` にしてください。
+
+**必須出力**
+## Normalize Result
+- Status: normalized / needs_input
+- Files changed:
+- Non-blocking notes:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-plan-fix.md

@@ -0,0 +1,26 @@
+{extends:fix}
+
+plan review の finding を精査し、妥当な修正だけを plan source artifacts に反映してください。
+
+**やること:**
+1. `review/plan-review.md` の finding を読み、`brief.md` と `brief.normalized.md` に照らして妥当性を判断してください。deck-local `review/plan-review.md` / `brief.normalized.md` / `plan.md` が存在しない場合は、この step の `Report Directory/plan-review.md` / `Report Directory/brief.normalized.md` / `Report Directory/plan.md` を読んでください。
+2. 妥当な finding は `plan.md` または `brief.normalized.md` に反映してください。TAKT run 内では `Report Directory/plan.md` と `Report Directory/brief.normalized.md` を正本として更新し、deck-local artifact が存在する場合は同じ内容にしてください。
+3. 妥当でない finding は理由を記録し、source artifact へ反映しないでください。
+4. `review/plan-fix.md` に finding ごとの対応結果を書いてください。
+
+**判定基準:**
+- 妥当な finding をすべて反映または理由付きで非対応にした場合は `fixed` としてください。
+- 安全に修正できない場合は `blocked` としてください。
+- deck-local に artifact がまだ同期されていないことだけを `blocked` 理由にしないでください。`Report Directory` の source artifact が読めるかで判断してください。
+
+**report file format:**
+- `review/plan-fix.md` は YAML front matter で開始し、`command: plan`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: fix`、`cycle`、`state: fixed`、`result`、`applied_finding_count`、`rejected_finding_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Plan Fix
+- Result: fixed / blocked
+- Applied findings:
+- Rejected findings:
+- Files changed:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-plan-review.md

@@ -0,0 +1,24 @@
+plan command の成果物をレビューしてください。
+
+**やること:**
+1. `brief.md`、`brief.normalized.md`、`plan.md`、`review/plan-work.md` を読んでください。deck-local `brief.normalized.md` / `plan.md` / `review/plan-work.md` が存在しない場合は、この step の `Report Directory/brief.normalized.md` / `Report Directory/plan.md` / `Report Directory/plan-work.md` を読んでください。
+2. 発表目的、聴衆、中心メッセージ、slide count、各スライドの Message/Layout/Content/Visual/Source が矛盾していないか確認してください。
+3. `plan.md` の requested deliverables が `brief.md` / `brief.normalized.md` の Output Requirements と矛盾していないか確認してください。
+4. 修正が必要な finding だけを stable `finding_id` 付きで記録してください。
+5. `review/plan-review.md` を書いてください。
+
+**判定基準:**
+- 修正不要なら `approved` としてください。
+- plan source artifact の修正で解消できる問題がある場合は `needs_fix` としてください。
+- 入力不足で判断不能な場合だけ `blocked` としてください。
+- deck-local に artifact がまだ同期されていないことだけを `blocked` 理由にしないでください。TAKT run 内では `Report Directory` の source artifact を正本として扱います。
+
+**report file format:**
+- `review/plan-review.md` は YAML front matter で開始し、`command: plan`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: review`、`cycle`、`state: reviewed`、`result`、`finding_count`、`blocking_finding_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Plan Review
+- Result: approved / needs_fix / blocked
+- Findings:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-plan-work-summary.md

@@ -0,0 +1,24 @@
+plan command の work 結果を、後続の review/fix/supervision が読める形で要約してください。
+
+**やること:**
+1. `brief.md`、`brief.normalized.md`、`plan.md` の存在と内容を確認してください。deck-local `slides/<deck>/brief.normalized.md` / `slides/<deck>/plan.md` が存在しない場合は、この step の `Report Directory/brief.normalized.md` / `Report Directory/plan.md` を読んでください。
+2. `plan.md` に requested deliverables が authoritative delivery request として明記されていることを確認してください。
+3. work step で作成・変更された source artifacts と、未解決の非ブロッキング確認事項を整理してください。
+4. `review/plan-work.md` に work summary を書いてください。
+
+**判定基準:**
+- deck-local または `Report Directory` の `plan.md` が存在し、slide plan と requested deliverables が確認できる場合は `passed` としてください。
+- deck-local に artifact がまだ同期されていないことだけを `needs_input` 理由にしないでください。TAKT run 内では `Report Directory` の source artifact を正本として扱います。
+- deck-local と `Report Directory` の両方で `plan.md` または requested deliverables が欠ける場合は `needs_input` としてください。
+
+**report file format:**
+- `review/plan-work.md` は YAML front matter で開始し、`command: plan`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: work`、`cycle`、`state: worked`、`result`、`source_artifact_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Plan Work Summary
+- Result: passed / needs_input
+- Source artifacts:
+- Requested deliverables:
+- Human review points:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-plan.md

@@ -0,0 +1,26 @@
+正規化されたbriefからスライド設計図を作成してください。
+
+**やること:**
+1. `brief.normalized.md`と必要なSource Materialsを読んでください。deck-local `slides/<deck>/brief.normalized.md` が存在しない場合は、この step の `Report Directory/brief.normalized.md` を読んでください。
+2. `docs/marp-slide-workflow.md`のplan契約に従って`plan.md`を作成してください。
+3. 各スライドに `Message`、`Layout`、`Content`、`Visual`、`Speaker note intent`、`Source` を必ず書いてください。
+4. `Layout` は knowledge `takt-marp-repo-conventions` の「Layout 語彙」表にある基本語彙のいずれかを選んでください。基本語彙で表現できない場合のみ `custom: <kebab-case-class> — <用途1行>` 句を使用してください(後続の design-system step が同名 class を定義します)。modifier を使う場合は `Layout` に基本 class と併記してください(例: `single profile`)。modifier 単独の指定は不可です。1列/2列の理由と比率を短く書いてください。
+5. visualは `none`、`svg: ...`、`existing: ...` のいずれかで明示してください。
+6. `plan.md` に `Requested Deliverables` セクションを作り、`deliverables: [html, pdf]` のような単一行を必ず含めてください。値は `html`、`pdf`、`pptx` のうち後続 delivery command が生成・確認すべき成果物だけを指定してください。
+7. appendixが必要な場合は本編と分けて計画してください。
+
+**artifact 出力:**
+- この step には `Report Directory` / `Report File` が渡されます。`Report File` の `plan.md` を正本として必ず出力してください。
+- deck-local `slides/<deck>/plan.md` も書ける場合は同じ内容で書いてください。ただし後続 step は `Report Directory/plan.md` を読める必要があります。
+
+**判定基準:**
+- 発表日、deck titleの表現、appendix要否、Deliverablesの追加要否など、人間が後で承認できる事項はplan作成を止めないでください。
+- slide count、中心メッセージ、必須Source Materialの根拠が決められず `plan.md` を作れない場合だけ `needs_input` にしてください。
+
+**必須出力**
+## Plan Result
+- Status: planned / needs_input
+- Slide count:
+- Files changed:
+- Non-blocking human review points:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-polish-fix.md

@@ -0,0 +1,25 @@
+{extends:fix}
+
+polish inspection の finding を精査し、visual/layout/render/design-token 関連の修正だけを反映してください。
+
+**やること:**
+1. `review/polish-inspect.md` の finding を読み、`design-system.md`、`SLIDES.md`、`images/*.svg` に照らして妥当性を判断してください。
+2. 妥当な finding は `design-system.md`、`SLIDES.md`、`images/*.svg` の範囲で修正してください。
+3. plan-level content、中心メッセージ、deliverables、official delivery artifact に関する finding は反映せず理由を記録してください。
+4. `review/polish-fix.md` に finding ごとの対応結果を書いてください。
+
+**判定基準:**
+- 妥当な finding をすべて反映または理由付きで非対応にした場合は `fixed` としてください。
+- 安全に修正できない場合は `blocked` としてください。
+
+**report file format:**
+- `review/polish-fix.md` は YAML front matter で開始し、`command: polish`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: fix`、`cycle`、`state: fixed`、`result`、`applied_finding_count`、`rejected_finding_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Polish Fix
+- Result: fixed / blocked
+- Applied findings:
+- Rejected findings:
+- Files changed:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-polish-inspect.md

@@ -0,0 +1,25 @@
+render evidence と compose source artifacts を照合し、visual/layout/render finding を記録してください。
+
+**やること:**
+1. `.takt/render/<deck>/cycle-1/metadata.json`、`design-system.md`、`SLIDES.md`、`images/*.svg` を読んでください。
+2. HTML/PDF/PDF raster の status と degraded reason を確認してください。
+3. visual、layout、render、design-token 関連の問題だけを finding として記録してください。
+4. plan-level content、中心メッセージ、delivery artifact の要否は scope 外として扱ってください。
+5. `review/polish-inspect.md` に stable `finding_id` 付きで finding を書いてください。
+
+**判定基準:**
+- 修正不要なら `approved` としてください。
+- visual/layout/render/design-token source correction で解消できる問題がある場合は `needs_fix` としてください。
+- render evidence metadata が読めない場合は `blocked` としてください。
+
+**report file format:**
+- `review/polish-inspect.md` は YAML front matter で開始し、`command: polish`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: inspect`、`cycle`、`state: inspected`、`result`、`finding_count`、`blocking_finding_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Polish Inspect
+- Result: approved / needs_fix / blocked
+- Findings:
+- Degraded render notes:
+- Out-of-scope notes:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-render-evidence.md

@@ -0,0 +1,35 @@
+polish command の render evidence を生成し、source artifact を表示確認できる状態にしてください。
+
+**やること:**
+1. 対象 target は `slides/<deck>` として扱ってください。
+2. `node scripts/takt-marp-render-slide-workflow-evidence.mjs <target> --cycle 1` を実行し、metadata の出力先を初期化してください。
+3. Marp HTML/PDF と必要な raster evidence を `.takt/render/<deck>/cycle-1/` 配下へ生成し、`metadata.json` の `html_png`、`pdf`、`pdf_raster` を `pending` 以外の完了状態へ更新してください。
+4. `.takt/render/<deck>/cycle-1/metadata.json` の生成結果を確認してください。
+5. `review/polish-work.md` に render evidence の実行結果を記録してください。
+
+**判定基準:**
+- metadata が生成され、`target`、`cycle`、`html_png.status`、`pdf.status`、`pdf_raster.status` が確認できる場合だけ評価対象にしてください。
+- `html_png` は slide PNG evidence なので、`passed` 相当の完了状態、空でない `files`、実在する非空ファイルが必要です。Puppeteer/Chromium missing、Marp image export failure、`failed`、`degraded`、`skipped` は `failed` としてください。
+- `pdf` は source render evidence なので、`passed` 相当の完了状態、実在する非空 `file` が必要です。PDF生成失敗、`failed`、`degraded`、`skipped` は `failed` としてください。
+- `pdftoppm` missing に限り `pdf_raster` の degraded/skipped と reason を許容し、単独では失敗にしないでください。
+- `pending` status が残っている場合は render evidence が未完了なので `failed` としてください。
+- metadata が生成されない、target/cycle が不一致、status field が欠ける場合は `failed` としてください。
+
+**禁止事項**
+- `dist/<deck>/` には書き込まないでください。
+- plan-level content を変更しないでください。
+- approval file を生成しないでください。
+
+**report file format:**
+- `review/polish-work.md` は YAML front matter で開始し、`command: polish`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: work`、`cycle`、`state: worked`、`result`、`source_artifact_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Render Evidence Result
+- Result: passed / failed
+- Metadata:
+- HTML status:
+- PDF status:
+- PDF raster status:
+- Degraded reasons:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-supervise-command.md

@@ -0,0 +1,58 @@
+{extends:supervise}
+
+command の最終 supervision report を作成してください。
+
+**やること:**
+1. 対象 command の work/finding/fix report と source artifacts を確認してください。finding report は plan/compose では `review/<command>-review.md`、polish では `review/polish-inspect.md`、deliver では `review/deliver-verify.md` です。fix/review の反復停止は TAKT workflow の `loop_monitors` が担うため、deck-local な loop monitor report は要求しないでください。deck-local report/source artifact が存在しない場合は、この step の `Report Directory` にある同名 report/source artifact を読んでください。
+2. report schema、source artifact の存在、未解消 finding、approval requirement を検証してください。
+3. foundation schema に従う front matter を持つ `review/<command>-supervision.md` を書いてください。
+4. `plan` は `state: planned`、`compose` は `state: composed`、`polish` は `state: polished`、`deliver` は `state: delivered` としてください。
+5. `plan` と `compose` は `human_gate: required`、`approval_required: true` とし、`polish` と `deliver` は `human_gate: not_required`、`approval_required: false` としてください。approval file は作成しないでください。
+6. finding counts は `blocking_findings`、`major_findings`、`minor_findings`、`info_findings`、`waived_major_findings`、`decision_items_count` で記録してください。
+
+**front matter の厳格ルール:**
+- `review/<command>-supervision.md` の先頭は必ず YAML front matter から始めてください。説明文を front matter より前に置かないでください。
+- `command` は短い command 名だけにしてください: `plan` / `compose` / `polish` / `deliver`。`takt-marp-slide-plan` や `supervise_plan` を書いてはいけません。
+- `target` は deck target を `slides/<deck>` 形式で書いてください。`deck` キーを使ってはいけません。
+- `generated_at` は parse 可能な ISO timestamp にしてください。
+- `workflow_run_id` は空でない実行識別子にしてください。TAKT run id または既存 report の `workflow_run_id` を使ってください。
+- `step` は必ず `supervision`、`cycle` は数値にしてください。
+- `state`、`result`、`blocking_findings`、`major_findings`、`minor_findings`、`info_findings` は foundation state validator の必須項目です。省略してはいけません。
+
+必須 front matter 例:
+
+```yaml
+---
+command: plan
+target: slides/_workflow-smoke
+generated_at: 2026-06-06T00:00:00.000Z
+workflow_run_id: 20260606-000000-slides-workflow-smoke
+step: supervision
+cycle: 1
+state: planned
+result: passed
+human_gate: required
+approval_required: true
+approval_file: review/plan-approval.md
+blocking_findings: 0
+major_findings: 0
+minor_findings: 0
+info_findings: 0
+waived_major_findings: 0
+decision_items_count: 0
+---
+```
+
+**判定基準:**
+- 成果物境界と report schema が満たされ、未解消の blocker がなければ `result: passed` としてください。
+- 必須 artifact、schema、未解消 finding に問題があれば `result: rejected` としてください。
+- plan command では、TAKT run 中の source artifact 正本は `Report Directory/brief.normalized.md` と `Report Directory/plan.md` です。deck-local への同期は command 完了後に runner が行うため、deck-local 未同期だけを rejected 理由にしないでください。
+
+**必須出力**
+## Supervision
+- Result: passed / rejected
+- State:
+- Human gate:
+- Approval required:
+- Finding counts:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-visual-generate.md

@@ -0,0 +1,26 @@
+planとSLIDES.mdに必要なSVG sourceを生成してください。
+
+**生成所有権**: SVG markup(外部ファイル・inline 両形式)の作成・修正はこの generate_visuals step が所有します。compose_slides は `Visual:` 予定スライドへの placeholder 配置までを所有し、SVG markup を書きません。
+
+**やること:**
+1. `plan.md`の `Visual: svg: ...` と `Visual: existing: ...` をすべて確認してください。
+2. `Visual: svg: ...` は、使い分け基準(SVGファーストVisualポリシーの「外部SVGとinline SVGの使い分け基準」節)に従い、外部ファイル形式またはinline形式を選択してください。
+   - 外部SVGファイル: `images/*.svg` として作成または更新し、`SLIDES.md` から画像参照で挿入します。
+   - inline SVG: `SLIDES.md` の該当スライドの図版領域(placeholder 部分)だけを編集し、SVG markup を直接記述します。front matter に `html: true` が未設定の場合は追加してください。
+   - `Visual: existing: ...`: 明示された既存画像への参照を `SLIDES.md` の該当スライドの placeholder 部分に挿入します。
+3. SVGはSVGファーストVisualポリシーに従ってください(外部ファイル・inline 両形式に適用)。
+4. 図形内テキストが図形からはみ出していないか確認してください。長いファイル名や英字ラベルは `tspan` で分割し、左右20px以上の余白を残してください。
+5. Marp配置時にスライド枠からSVGがはみ出しにくいよう、`SLIDES.md` の画像指定は個別サイズではなく `visual`、`visual-dense`、`visual-full` classのCSSで制御してください。inline SVGの場合も同様に、親classのcontainment(`--visual-max-height`系token)でサイズを制御してください。
+6. SVGをもう少し大きくしたい場合は、個別スライドの `![h:...]` を増やすのではなく、class側の `--visual-max-height` を調整してください。render evidence による確認は polish command に委譲してください。
+7. 外部ファイル形式の場合は `SLIDES.md`の参照パスが実在するSVGを指すようにしてください。
+8. 既存画像は明示されたものだけ使ってください。
+9. render output の生成や表示品質の最終判定は行わず、source artifact の作成に集中してください。
+
+**必須出力**
+## Visual Result
+- Status: generated / needs_input
+- SVG files: (外部ファイル形式・inline形式の両方を記載)
+- Text fit checks:
+- Source reference checks:
+- Files changed:
+- Notes:

package/templates/project/facets/knowledge/takt-marp-repo-conventions.md

@@ -0,0 +1,119 @@
+# Marpリポジトリ規約
+
+このリポジトリは Marp プレゼンテーションを `slides/` 配下で管理する。
+
+## 基本構成
+
+各 deck は `slides/<deck>/` に置く。
+
+```text
+slides/<deck>/
+  brief.md
+  brief.normalized.md
+  plan.md
+  design-system.md
+  SLIDES.md
+  images/
+  review/
+```
+
+## Marp
+
+`SLIDES.md` は Marp Markdown である。
+front matter には少なくとも `marp: true`、`theme`、`paginate` を含める。
+`SLIDES.md` 本文に HTML 要素(inline SVG 含む)を使う場合は、front matter に `html: true` を設定する。
+
+既存 deck は日本語 speaker notes を HTML コメントで持つ。
+
+```md
+<!--
+このスライドで話す補足を書く。
+-->
+```
+
+## Font
+
+font style には日本語優先フォールバックスタックを必ず指定する。
+推奨スタック: `"Noto Sans JP", "Hiragino Sans", "Yu Gothic", sans-serif`
+`@font-face` を宣言する場合は、`SLIDES.md` からの相対 path が実在するファイルのみを参照する(path が存在しない環境では `@font-face` を省略し、フォールバックスタックのみで描画する)。
+
+## Design System
+
+各deckは `design-system.md` を持つ。
+`design-system.md` は typography、spacing、layout、visual、color、QA rules のdeck-local tokenを定義する。
+`SLIDES.md` のfront matter CSSは、スライドごとの個別調整ではなく、design-system tokenと用途別classで構成する。
+
+## Visual
+
+SVG は `slides/<deck>/images/*.svg` に保存し、Marp から相対パスで参照する。
+
+```md
+<!-- _class: visual -->
+
+![](images/example.svg)
+```
+
+図入りスライドのSVGサイズは、個別の `![h:...]` や `![w:...]` ではなく、`visual` / `visual-dense` / `visual-full` などのMarp class側CSSで制御する。
+
+構造図やフロー図は SVG としてレビュー可能な形を優先する。
+
+## Layout 語彙
+
+以下は基本語彙であり、拡張可能な出発点である(閉じた enum ではない)。
+plan / compose は `_class:` にこの語彙を使用するか、命名規約に従い新 class を定義する。
+
+### 基本 class
+
+| class | 区分 | 用途 | 構造ヒント |
+|---|---|---|---|
+| title | 基本 | デッキ表紙・章扉 | 大見出しのみ、サブタイトル任意 |
+| single | 基本 | 本文 1 列のスタンダードスライド | 見出し + 本文エリア |
+| visual | 基本 | 図版主体(テキスト少) | 画像を中央大表示 |
+| visual-dense | 基本 | 図版 + 解説テキスト併置 | 図版と箇条書きを縦積み |
+| visual-full | 基本 | 図版全画面(テキストなし〜最小) | 画像がスライド全域を占有 |
+| split-50-50 | 基本 | 左右均等 2 分割 | 左右各 50% |
+| split-45-55 | 基本 | 左右非対称 2 分割(45:55) | 左 45% / 右 55% |
+| split-40-60 | 基本 | 左右非対称 2 分割(40:60) | 左 40% / 右 60% |
+| split-60-40 | 基本 | 左右非対称 2 分割(60:40) | 左 60% / 右 40% |
+| compare-2col | 基本 | 2 項目の比較・対比 | 左右に比較対象を並置 |
+| infographic | 基本 | カードグリッドによる情報整理 | `.ig-grid` / `.ig-card` を使う |
+| code-2col | 基本 | コードと解説を横並び | 左: コードブロック、右: 解説 |
+
+### modifier(単独使用不可)
+
+modifier は必ず基本 class と組み合わせて使用する。単独使用は不可。
+
+| class | 区分 | 用途 | 適用先 base class |
+|---|---|---|---|
+| profile | modifier | 登壇者プロフィール(右に写真、左に名前と実績) | single |
+| layers | modifier | グリッドを中央寄せにする重ね図向け調整 | infographic |
+| dual | modifier | バッジ重畳など 2 要素の重ね合わせ | visual-full 等 |
+| tag-takt | modifier | コンテキストタグ: TAKT デッキ識別 | 任意の基本 class |
+| tag-sdd | modifier | コンテキストタグ: SDD デッキ識別 | 任意の基本 class |
+| tag-ccsdd | modifier | コンテキストタグ: CC-SDD デッキ識別 | 任意の基本 class |
+| tag-* | modifier | コンテキストタグ(任意の識別子) | 任意の基本 class |
+
+## Build
+
+`package.json` の標準 script:
+
+```bash
+npm run preview:all
+npm run build
+npm run build:html -- <deck>
+npm run build:pdf -- <deck>
+npm run build:pptx -- <deck>
+```
+
+標準成果物は HTML と PDF である。PPTX は `brief.md` の `Deliverables` に `pptx` がある場合だけ生成する。
+
+当日プレゼンのpreviewは `marp -s slides/` で確認する。
+TAKT worker 内の build QA では、preview serverを短時間起動し、`http://localhost:8080/<deck>/SLIDES.md` が開けることを確認する。
+
+TAKT worker 内の build QA では、`Deliverables` に `pdf` がある場合は `npm run build:pdf -- <deck>` で `slides/<deck>/SLIDES.md` だけをPDF生成する。
+PPTXは `brief.md` の `Deliverables` に `pptx` がある場合だけ対象にする。
+
+## 入力の扱い
+
+`brief.md` が人間入力の正である。
+`brief.normalized.md` は TAKT が後段 workflow のために整理した作業用入力であり、意図を変更する場合は `brief.md` を更新して plan を再生成する。

package/templates/project/facets/output-contracts/takt-marp-ai-antipattern-fix.md

@@ -0,0 +1,48 @@
+MUST:
+- 先頭は必ず YAML front matter の `---` で始め、`remaining_context_count` の直後に閉じ `---` を置いてから Markdown body を書く。
+- front matter より前に説明文、警告、作業メモを書かない。
+- Markdown body を front matter に混ぜない。`# AI Antipattern Fix Report` は閉じ `---` の後に置く。
+- front matter は flat scalar のみを使う。nested object、multi-line array、finding detail は front matter に入れない。
+- `status` は `FIXED`、`NO_FIX_NEEDED`、`NEED_REPLAN`、`BLOCKED` のいずれかだけを使う。
+- `handled_finding_count` は Finding Decisions テーブルに記録した finding 行数と一致させる。
+- `changed_file_count` は Changed Files テーブルに記録した変更ファイル数と一致させる。変更がない場合は `0` とし、Changed Files には `none` を記録する。
+- `remaining_context_count` は Remaining Context テーブルに記録した未解決 context 行数と一致させる。
+- `NO_FIX_NEEDED` は、Finding Decisions のすべての行に finding-level evidence がある場合のみ有効とする。
+- `NEED_REPLAN` または `BLOCKED` の場合は、Remaining Context に command 境界内で安全に解決できない理由を必ず書く。
+
+```markdown
+---
+command: plan | compose | polish | deliver
+target: slides/<deck>
+generated_at: 2026-01-01T00:00:00.000Z
+workflow_run_id: takt-run-id
+step: ai_antipattern_fix
+cycle: 1
+status: FIXED | NO_FIX_NEEDED | NEED_REPLAN | BLOCKED
+handled_finding_count: 0
+changed_file_count: 0
+remaining_context_count: 0
+---
+
+# AI Antipattern Fix Report
+
+## Summary
+{AI antipattern finding の修正結果を1-2文で要約}
+
+## Finding Decisions
+| finding_id | decision | changed_files | validation | evidence |
+|------------|----------|---------------|------------|----------|
+
+## Changed Files
+| path | change_summary | evidence |
+|------|----------------|----------|
+| none | no file changes were required | {理由または finding-level evidence} |
+
+## Validation Evidence
+| command | result | evidence |
+|---------|--------|----------|
+
+## Remaining Context
+| finding_id | missing_context | required_replan_owner | evidence |
+|------------|-----------------|-----------------------|----------|
+```

package/templates/project/facets/output-contracts/takt-marp-ai-antipattern-review.md

@@ -0,0 +1,43 @@
+MUST:
+- 先頭は必ず YAML front matter の `---` で始め、`blocking_finding_count` の直後に閉じ `---` を置いてから Markdown body を書く。
+- front matter より前に説明文、警告、作業メモを書かない。
+- Markdown body を front matter に混ぜない。`# AI Antipattern Review Report` は閉じ `---` の後に置く。
+- front matter は flat scalar のみを使う。nested object、multi-line array、finding detail は front matter に入れない。
+- `finding_count` は AI Findings テーブルに記録した全 finding 行数と一致させる。
+- `blocking_finding_count` は通常 review / inspect / verify へ進めない AI finding 行数と一致させる。
+- finding がある場合は、各行に安定した `finding_id` と具体的な `evidence` を必ず書く。
+- `result: approved` かつ `finding_count: 0` の初回 no-issue review は、fix report なしで有効な gate evidence とする。
+
+```markdown
+---
+command: plan | compose | polish | deliver
+target: slides/<deck>
+generated_at: 2026-01-01T00:00:00.000Z
+workflow_run_id: takt-run-id
+step: ai_antipattern_review
+cycle: 1
+reviewed_scope: command-work-report | source-artifacts | render-evidence | delivery-artifacts
+result: approved | needs_fix | blocked
+finding_count: 0
+blocking_finding_count: 0
+---
+
+# AI Antipattern Review Report
+
+## Summary
+{AI antipattern review の結果を1-2文で要約}
+
+## Reviewed Scope
+| artifact | role | evidence |
+|----------|------|----------|
+
+## AI Findings
+| finding_id | family_tag | status | location | issue | required_change | evidence |
+|------------|------------|--------|----------|-------|-----------------|----------|
+
+## Non-AI Quality Notes
+- None / {通常の slide content、layout、render、delivery 品質に属するため AI finding として扱わなかった観察}
+
+## Blocking Issues
+- None / {target、command output、reviewed scope を特定できない理由}
+```

package/templates/project/facets/output-contracts/takt-marp-command-fix.md

@@ -0,0 +1,32 @@
+MUST:
+- 先頭は必ず YAML front matter の `---` で始め、`rejected_finding_count` の直後に閉じ `---` を置いてから Markdown body を書く。
+- front matter より前に説明文、警告、作業メモを書かない。
+- Markdown body を front matter に混ぜない。`# Command Fix Report` は閉じ `---` の後に置く。
+- `applied_finding_count` と `rejected_finding_count` は Finding Responses テーブルの decision と一致させる。
+
+```markdown
+---
+command: plan | compose | polish | deliver
+target: slides/<deck>
+generated_at: 2026-01-01T00:00:00.000Z
+workflow_run_id: takt-run-id
+step: fix
+cycle: 1
+state: fixed
+result: fixed | blocked
+applied_finding_count: 0
+rejected_finding_count: 0
+---
+
+# Command Fix Report
+
+## Summary
+{修正結果を要約}
+
+## Finding Responses
+| finding_id | decision | files_changed | reason | verification |
+|------------|----------|---------------|--------|--------------|
+
+## Blocking Issues
+- None / {安全に修正できない理由}
+```

package/templates/project/facets/output-contracts/takt-marp-command-review.md

@@ -0,0 +1,32 @@
+MUST:
+- 先頭は必ず YAML front matter の `---` で始め、`blocking_finding_count` の直後に閉じ `---` を置いてから Markdown body を書く。
+- front matter より前に説明文、警告、作業メモを書かない。
+- Markdown body を front matter に混ぜない。`# Command Review Report` は閉じ `---` の後に置く。
+- `finding_count` は Findings テーブルに記録した全 finding 行数と一致させる。info finding を表に載せる場合も数に含める。数に含めない観察は Findings ではなく Summary または別の非ブロッキングメモとして書く。
+
+```markdown
+---
+command: plan | compose | polish | deliver
+target: slides/<deck>
+generated_at: 2026-01-01T00:00:00.000Z
+workflow_run_id: takt-run-id
+step: review | inspect | verify
+cycle: 1
+state: reviewed | inspected | verified
+result: approved | needs_fix | blocked
+finding_count: 0
+blocking_finding_count: 0
+---
+
+# Command Review Report
+
+## Summary
+{レビュー結果を要約}
+
+## Findings
+| finding_id | severity | status | cycle | location | issue | required_change | evidence |
+|------------|----------|--------|-------|----------|-------|-----------------|----------|
+
+## Blocking Issues
+- None / {判断不能な入力不足}
+```

package/templates/project/facets/output-contracts/takt-marp-command-work.md

@@ -0,0 +1,42 @@
+MUST:
+- 先頭は必ず YAML front matter の `---` で始め、`source_artifact_count` の直後に閉じ `---` を置いてから Markdown body を書く。
+- front matter より前に説明文、警告、作業メモを書かない。
+- Markdown body を front matter に混ぜない。`# Command Work Report` は閉じ `---` の後に置く。
+
+```markdown
+---
+command: plan | compose | polish | deliver
+target: slides/<deck>
+generated_at: 2026-01-01T00:00:00.000Z
+workflow_run_id: takt-run-id
+step: work
+cycle: 1
+state: worked
+result: passed | needs_input | failed
+source_artifact_count: 0
+---
+
+# Command Work Report
+
+## Summary
+{1-2文で作業結果を要約}
+
+## Source Artifacts
+| File | State | Notes |
+|------|-------|-------|
+
+## Requested Deliverables
+- html
+- pdf
+- pptx
+
+## Machine Checks
+| Check | Result | Notes |
+|-------|--------|-------|
+
+## Human Review Points
+- None / {人間承認前に確認すべき判断}
+
+## Blocking Issues
+- None / {継続不能な不足}
+```