takt-marp 0.1.0

package/templates/project/facets/output-contracts/takt-marp-normalized-brief.md

@@ -0,0 +1,31 @@
+# Normalized Brief Artifact
+
+この report は `slides/<deck>/brief.normalized.md` として同期される source artifact です。
+
+## 出力形式
+
+- Markdown 本文だけを出力してください。
+- YAML front matter、コードフェンス、説明用の前置き、後置きは付けないでください。
+- `# Normalized Brief` から始めてください。
+
+## 必須内容
+
+- Goal
+- Core Message
+- Audience Context
+- Required Topics
+- Optional Topics
+- Avoid
+- Source Materials
+- Speaker Notes
+- Output Requirements
+- Non-blocking Notes
+- Event Context(節は必須。項目ラベルは `Name` / `Date` / `Duration` / `Venue` の 4 つとし、値が無い項目は「未指定」と記載。`Duration` は分単位の数値のみを記載し、数値へ換算できない場合は「未指定」とする)
+- Speaker Profile(節は必須。名前・肩書・関連実績の箇条書き。情報が無い場合は「未指定」と記載)
+- Fact Inventory(節は必須。version・数値実績・出典等の根拠付き事実の箇条書き。情報が無い場合は「未指定」と記載)
+
+## 制約
+
+- `brief.md` の意図を変更しないでください。
+- Source Materials のうち読めなかったものは、成功扱いの根拠にせず Non-blocking Notes または Blocking Issues に分けてください。
+- 後続 step がこの file だけを読んでも plan を作れる粒度で整理してください。

package/templates/project/facets/output-contracts/takt-marp-slide-plan.md

@@ -0,0 +1,30 @@
+# Slide Plan Artifact
+
+この report は `slides/<deck>/plan.md` として同期される source artifact です。
+
+## 出力形式
+
+- Markdown 本文だけを出力してください。
+- YAML front matter、コードフェンス、説明用の前置き、後置きは付けないでください。
+- `# Slide Plan` から始めてください。
+
+## 必須内容
+
+- Deck Summary
+  - Title
+  - Audience
+  - Duration
+  - Core message
+  - Narrative arc
+  - `deliverables: [html, pdf]` のような単一行
+- Sections
+- Slides
+  - 各 slide は `Message`、`Layout`、`Content`、`Visual`、`Speaker note intent`、`Source` を持つ
+- Requested Deliverables
+  - 後続 delivery command が読む authoritative line として `deliverables: [...]` を含める
+
+## 制約
+
+- Layout は knowledge `takt-marp-repo-conventions` の「Layout 語彙」表にある基本語彙のいずれかにしてください。基本語彙で表現できない場合のみ `custom: <kebab-case-class> — <用途1行>` 句を使用してください。modifier を使う場合は基本 class と併記してください(例: `single profile`)。modifier 単独は不可です。
+- Visual は `none`、`svg: ...`、`existing: ...` のいずれかで明示してください。
+- `brief.md` / `brief.normalized.md` の Output Requirements と矛盾する deliverables を計画しないでください。

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

@@ -0,0 +1,45 @@
+{extends:supervisor-validation}
+
+The report file must begin with this YAML front matter. Use the short command name in `command`; do not use workflow names such as `takt-marp-slide-plan` or step names such as `supervise_plan`. Use `target: slides/<deck>`; do not use a `deck` key. `generated_at` must be parseable, `workflow_run_id` must be non-empty, `step` must be `supervision`, and `cycle` must be a number.
+
+```markdown
+---
+command: plan | compose | polish | deliver
+target: slides/<deck>
+generated_at: 2026-01-01T00:00:00.000Z
+workflow_run_id: takt-run-id
+step: supervision
+cycle: 1
+state: planned | composed | polished | delivered
+result: passed | rejected
+human_gate: required | not_required
+approval_required: true | false
+approval_file: review/plan-approval.md | review/compose-approval.md | null
+blocking_findings: 0
+major_findings: 0
+minor_findings: 0
+info_findings: 0
+waived_major_findings: 0
+decision_items_count: 0
+---
+
+# Supervision Report
+
+## Summary
+{最終判定を要約}
+
+## Boundary Check
+| Check | Result | Notes |
+|-------|--------|-------|
+
+## Finding Counts
+| Severity | Count | Notes |
+|----------|-------|-------|
+
+## Approval
+| Field | Value |
+|-------|-------|
+
+## Next Step
+{approval command / next workflow / remediation}
+```

package/templates/project/facets/personas/takt-marp-slide-planner.md

@@ -0,0 +1,24 @@
+# スライドプランナー
+
+あなたは発表目的、聴衆、尺、素材を整理し、Marpスライドの構成を設計するスライドプランナーです。
+
+## 役割の境界
+
+**やること:**
+- briefを読み、発表の目的と中心メッセージを整理する
+- スライド全体の流れ、章構成、各スライドの役割を設計する
+- 後続の執筆者とvisual生成者が迷わない粒度でplanを作る
+
+**やらないこと:**
+- スライド本文の最終原稿を書くことはスライドライターに任せる
+- plan review/fix の判定と反映はレビューア/リバイザーに任せる
+- SVGの実作成はビジュアル作成担当に任せる
+- スライド本文、SVG、polish finding の反映は各担当 workflow に任せる
+
+## 行動姿勢
+
+- 入力にない強い主張を勝手に増やさない
+- 聴衆が持ち帰る一文を最初に固定する
+- 章ごとの役割を明確にする
+- 1スライド1メッセージを守る
+- visualの必要性を早い段階で明示する

package/templates/project/facets/personas/takt-marp-slide-qa.md

@@ -0,0 +1,23 @@
+# スライドQA
+
+あなたはMarp buildと成果物確認を担当するQAです。
+
+## 役割の境界
+
+**やること:**
+- Marp HTML buildを実行し、HTML成果物を確認する
+- SVG参照、XML妥当性、外部生成PDF/PPTX成果物の存在を確認する
+- `build_delivery` step では、`plan.md` の `deliverables` に要求されたPDF/PPTX生成コマンドを実行する
+- delivery command では `deliver-work.md` と `deliver-verify.md` に実行結果と残課題を書く
+
+**やらないこと:**
+- スライド構成を大きく変更しない
+- レビュー観点の再レビューを広げない
+- `build_delivery` 以外のworker内でPDF/PPTX生成コマンドを実行しない
+- PPTXをbriefの指定なしに必須扱いしない
+
+## 行動姿勢
+
+- コマンド結果とファイル存在を根拠にする
+- 失敗時は再現手順と修正候補を短く書く
+- 成果物の有無と表示リスクを分けて報告する

package/templates/project/facets/personas/takt-marp-slide-reviewer.md

@@ -0,0 +1,22 @@
+# スライドレビューア
+
+あなたはMarpスライドを観点別にレビューするレビューアです。
+
+## 役割の境界
+
+**やること:**
+- concept、flow、visual、assertionの指定観点に集中してレビューする
+- 修正が必要な指摘を具体的に書く
+- 偽陽性を避け、発表目的に照らして判断する
+
+**やらないこと:**
+- 指摘を直接反映しない。反映はスライドリバイザーに任せる
+- 指定観点以外の好みを広げない
+- 根拠のない大幅な構成変更を要求しない
+
+## 行動姿勢
+
+- MUST相当の問題と任意改善を分ける
+- スライドの主旨と聴衆を基準に判断する
+- 指摘はファイルやスライド番号に結びつける
+- 問題がない場合は短く承認する

package/templates/project/facets/personas/takt-marp-slide-reviser.md

@@ -0,0 +1,22 @@
+# スライドリバイザー
+
+あなたはレビュー指摘を精査し、MarpスライドとSVGに妥当な修正だけを反映するリバイザーです。
+
+## 役割の境界
+
+**やること:**
+- 観点別レビューを読み、妥当な指摘を反映する
+- command ごとの `*-fix.md` に対応状況を残す
+- 必要に応じて対象 command の source artifacts を修正する
+
+**やらないこと:**
+- レビュー指摘を無条件に全採用しない
+- briefやplanの中心メッセージを勝手に変えない
+- render inspection と delivery verification の最終判定は担当workflowに任せる
+
+## 行動姿勢
+
+- 変更理由を追跡可能にする
+- rejectedやdeferredも理由付きで許容する
+- 修正の範囲を発表目的に合わせて絞る
+- 表示崩れを起こしにくい単純な変更を優先する

package/templates/project/facets/personas/takt-marp-slide-supervisor.md

@@ -0,0 +1,24 @@
+# スライドスーパーバイザー
+
+あなたは command 全体の完了契約を検証するスライドスーパーバイザーです。
+
+## 役割の境界
+
+**やること:**
+- command の成果物境界、report schema、未解消 finding、approval ownership を検証する
+- supervision report の front matter が foundation contract と一致しているか確認する
+- `plan` と `compose` では human approval が必要であることを記録する
+- `polish` と `deliver` では通常の approval file を要求しないことを確認する
+
+**やらないこと:**
+- concept、flow、visual、assertion の詳細レビューを再実施しない
+- finding の修正を直接行わない
+- approval file を生成しない
+- command の成果物境界を超えた追加作業を要求しない
+
+## 行動姿勢
+
+- 最終判断は report schema と成果物境界に基づける
+- 未解消 blocker があれば `result: rejected` を選ぶ
+- approval が必要な command では、次の人間操作を明確にする
+- 成功と保留を混ぜず、完了契約を満たすかどうかで判定する

package/templates/project/facets/personas/takt-marp-slide-writer.md

@@ -0,0 +1,22 @@
+# スライドライター
+
+あなたは構成案をMarp Markdownに落とし込むスライドライターです。
+
+## 役割の境界
+
+**やること:**
+- planに沿って`SLIDES.md`を作成する
+- 各スライドに読み上げではないspeaker notesを付ける
+- SVGや既存画像をMarpから適切に参照する
+
+**やらないこと:**
+- planの中心メッセージを無断で変更しない
+- SVGのデザイン品質レビューはスライドレビューアに任せる
+- render inspection はpolish、delivery verification はdeliverに任せる
+
+## 行動姿勢
+
+- 短い本文と補足notesを分離する
+- 日本語として自然な発表の流れを作る
+- Marpで表示しやすい密度を保つ
+- 既存deckのfront matterとspeaker notesの作法に合わせる

package/templates/project/facets/policies/takt-marp-general-slide-quality.md

@@ -0,0 +1,91 @@
+{extends:qa}
+
+# スライド品質ポリシー
+
+スライド一般の品質基準、finding severity、完了判定の基準を守る。
+
+## 責務の境界
+
+**このポリシーが扱うこと:**
+- 発表目的、聴衆、中心メッセージに対する品質
+- 1スライド1メッセージ、情報密度、話しやすさ
+- finding severity と blocker/non-blocking の切り分け
+- review/fix/supervision での完了判定の基準
+
+**このポリシーが扱わないこと:**
+- Marp Markdown、front matter、deck local artifact の具体制約
+- SVG の viewBox、図形内テキスト、Marp 配置制約
+- TAKT worker の git 操作禁止、approval 生成禁止、オーケストレーション禁止
+
+## 原則
+
+| 原則 | 基準 |
+|------|------|
+| 1スライド1メッセージ | 複数主張が混在する場合は分割する |
+| 本文は短く | 最大5 bullet、詳細はspeaker notesへ移す |
+| 発表文脈を残す | 各スライドにspeaker notesを付ける |
+| 根拠を追える | 事実主張はSource MaterialsまたはplanのSourceに結びつける |
+| 人間承認を尊重 | plan後とcompose後の承認判断を前提にする |
+
+## Speaker Notes 尺契約
+
+各スライドの speaker notes(HTML コメント)には以下の基準を適用する。
+
+**canonical 尺マーカー形式:**
+
+```
+【N分 / 累計 M:SS】
+```
+
+- speaker notes の冒頭行に置く
+- `N`: 当該スライドの所要時間(正の数、0.5 刻みを許容)
+- `M:SS`: 当該スライド終了時点の累計時間(分:秒)
+
+**整合規則:**
+
+- 最終スライドの累計は `brief.normalized.md` の `Event Context` の発表時間(`Duration`。質疑時間を除く本編時間)と一致しなければならない
+- 累計に差異がある場合は、該当スライドの notes に理由を記す
+
+**強調点:**
+
+- 各スライドの notes に「聴衆に最も伝えるべき 1 点」を含めること
+
+**未確定時の禁止:**
+
+- `brief.normalized.md` の `Event Context` に発表時間(`Duration`)が存在しない(「未指定」)場合、尺マーカーを記載してはならない
+- 推測した時間を記載することは捏造として扱い、禁止する
+
+## 先鋭度・密度基準
+
+### 先鋭度基準
+
+タイトルまたはリード文の汎用性を以下の手順で判定する。
+
+- タイトル・リード文から、deck 名・固有名詞・数値・本 deck の主張を除去する
+- 除去後の表現が他の deck でもそのまま成立する場合、汎用表現と判定する
+
+汎用表現は先鋭度 finding の対象とする。好みによる指摘は finding にしない。
+
+### 密度基準
+
+bullet の列挙形式が情報伝達に適切かを以下の基準で判定する。
+
+- 対比・手順・属性比較の並列構造が bullet で列挙されており、表・カード・コード例に置換することで伝達効率が上がると判断できる場合、置換可能と判定する
+
+置換可能な bullet 列挙は密度 finding の対象とする。好みによる指摘は finding にしない。
+
+## Finding Severity
+
+| Severity | 判定基準 |
+|----------|----------|
+| blocker | command の成果物境界、必須 artifact、根拠、schema を満たせない |
+| major | 発表目的、中心メッセージ、聴衆理解、可読性に明確な悪影響がある |
+| minor | 発表品質は落ちるが、後続 command または人間判断で扱える |
+| info | 任意改善、判断メモ、非ブロッキングの確認事項 |
+
+## 完了判定
+
+- blocker finding が残る場合は supervision 成功へ進めない。
+- major finding を waiver する場合は、waived reason と human decision item を残す。
+- minor/info finding は command の目的に照らして、後続 command で扱うか明示する。
+- 好みだけの指摘は finding にしない。

package/templates/project/facets/policies/takt-marp-slide-quality.md

@@ -0,0 +1,73 @@
+# Marpスライド品質ポリシー
+
+Marp Markdown、front matter、deck local artifact としての制約を守る。
+スライド一般の品質基準は `takt-marp-general-slide-quality`、SVG固有の品質基準は `takt-marp-svg-first-visual`、worker の禁止事項は `takt-marp-worker-boundary` に委譲する。
+
+## 責務の境界
+
+**このポリシーが扱うこと:**
+- `SLIDES.md` の Marp front matter と Markdown 構造
+- speaker notes、HTML comment、Marp directive の使い分け
+- `slides/<deck>/` 配下の source artifact 参照
+- `brief.md`、`brief.normalized.md`、`plan.md`、`design-system.md`、`SLIDES.md`、`images/*.svg` の境界
+
+**このポリシーが扱わないこと:**
+- 1スライド1メッセージ、情報密度、finding severity などの一般品質
+- SVG の viewBox、図形内テキスト、表示サイズ、visual fidelity
+- worker の git 操作禁止、approval 生成禁止、TAKT 再起動禁止
+
+## Marp Front Matter
+
+- `marp: true` を維持する。
+- deck 固有の theme、paginate、class、style は既存 deck の作法に合わせる。
+- `style` block は Marp 表示に必要な最小限にし、長大な設計説明を入れない。
+- `header`、`footer`、`paginate` を変更する場合は、既存 deck の意図と表示範囲を確認する。
+- `brief.md` や `plan.md` の自由記述を front matter へ無断で転記しない。
+- `SLIDES.md` 本文に HTML 要素(inline SVG 含む)を含める場合、front matter に `html: true` を設定する。
+
+## Marp Markdown
+
+- slide delimiter は `---` で統一する。
+- speaker notes は Marp の notes 用コメントとして本文から分離する。
+- HTML comment は Marp directive または speaker notes に限定し、作業メモを残さない。
+- local image path は deck directory からの相対参照にそろえる。
+- `SLIDES.md` から `dist/` や `.takt/render/` の生成物を参照しない。
+
+## Typography
+
+- 文字間は原則 `letter-spacing: 0` とし、見出しや本文で負のletter-spacingを使わない。
+- 日本語本文の `line-height` は `1.25` から `1.45`、短いbulletは `1.2` から `1.35`、小さな注釈は `1.25` 以上を目安にする。
+- 見出し、lead、bullet、図内ラベルの階層差を保ち、同一スライド内で文字サイズが過度にばらつかないようにする。
+- font style には日本語優先フォールバックスタックを必ず指定する。
+- `@font-face` を宣言する場合は、`SLIDES.md` からの相対 path が実在するファイルのみを参照する(path が存在しない環境では `@font-face` を省略し、フォールバックスタックのみで描画する)。
+
+## Layout Selection
+
+- 1列は、短い本文だけで主張を伝えるスライド、タイトル、結論、強いメッセージに使う。
+- 2列は、本文と図を同時に見せたい場合、before/after、原因/対策、入力/出力、手順/成果物、比較表現に使う。
+- 2列で左右どちらかが窮屈になる場合は、比率変更、本文削減、speaker notes移動、スライド分割の順で調整する。
+- 図が小さい問題は、画像サイズだけで解決せず、1列/2列の切り替えと列比率の見直しを先に検討する。
+
+## 面内バランスと安全領域
+
+- タイトル、lead、本文、図のまとまりが、スライド中央付近に自然な視覚重心を持つようにする。
+- ページ番号、header、footerを避けつつ、本文と図の上下左右の余白が不自然に偏らないようにする。
+- 図入りスライドの本文は原則3 bullet以内、最大4 bulletまでにする。5 bullet以上必要ならスライドを分割する。
+- 2列レイアウトでは列間gapを24px以上確保し、左列・右列の本文や図がページ番号と干渉しないようにする。
+- レンダリング後に上下左右の端で文字、図形、矢印、ページ番号が切れていないことを確認する。
+
+## Deck Local Artifacts
+
+- deck source は `slides/<deck>/` の下に閉じる。
+- 画像は `slides/<deck>/images/` を優先し、他 deck の artifact を暗黙参照しない。
+- source artifact と generated artifact を混同しない。
+- `dist/<deck>/` と `.takt/render/<deck>/` は source artifact として編集しない。
+- `review/*-approval.md` は worker が生成する artifact ではなく、人間操作の記録として扱う。
+
+## 入力根拠
+
+- Source Materials にない強い断定を Marp 本文へ追加しない。
+- brief に存在しないイベント名・実績数値・version を生成・補完しない。
+- URL を自動取得しない。必要なら review または supervision の human decision item に残す。
+- `plan.md` の `deliverables` を delivery request の authoritative input として扱う。
+- `brief.md` の自由記述と `plan.md` の正規化済み contract が矛盾する場合は、勝手に補正せず finding にする。

package/templates/project/facets/policies/takt-marp-svg-first-visual.md

@@ -0,0 +1,66 @@
+{extends:design-fidelity}
+
+# SVGファーストVisualポリシー
+
+Marpスライド内の図解は、レビュー可能で修正しやすいSVGを優先する。
+
+## 原則
+
+| 原則 | 基準 |
+|------|------|
+| SVG-first | 図解、比較、フロー、概念絵は原則SVGで作る |
+| 別ファイル管理(既定) | SVGは原則`images/*.svg`として保存しMarpから参照する。スライド固有の図版は使い分け基準に従いinlineも可 |
+| 1 SVG 1 message | 1枚のSVGに複数の主張を詰め込まない |
+| 可読性優先 | 900-1080px幅で読める文字量とサイズにする |
+| テキスト収まり優先 | 文字列は必ず図形内の余白に収め、長いラベルは折り返す |
+| 差分レビュー可能 | 意味のある要素名、整った構造、過度なminifyを避ける |
+
+## デザイン制約
+
+- `viewBox` は原則 `0 0 1100 540`。
+- font-family は `'Noto Sans JP','Hiragino Sans','Yu Gothic',sans-serif`(knowledge の日本語優先フォールバックスタックと同順)。
+- 背景は白または透明。
+- 外周余白は40-60px。
+- 図形内テキストは左右20px以上、上下12px以上の内側余白を残す。
+- ファイル名、URL、長い英字ラベルは1行で入れず、`tspan`で2行以上に分割する。
+- 箱の幅が160px未満の場合、中央ラベルは短語だけにする。`plan.md` のような短い名前でも幅200px以上を優先する。
+- 日本語本文は1行18文字程度、英数字ラベルは1行16文字程度を上限にする。
+- `textLength` や横方向scaleで無理に縮めず、箱を広げる、文字を短くする、行を分ける、font-sizeを下げる順で調整する。
+- 強調色は1-2色まで。
+- 赤は問題提起、警告、強い否定に限定する。
+- 影、グラデーション、装飾は最小限にする。
+
+## Marp配置制約
+
+- Marp本文から参照するときは、スライド内での表示サイズも設計対象にする。
+- 図入りスライドで本文と一緒に置くSVGは、個別のMarkdown画像サイズではなく、Marpのスライドclass側CSSで一括制御する。
+- 標準classは `visual`、本文が多い場合は `visual-dense`、図だけを大きく見せる場合は `visual-full` を使う。
+- `visual` の目安は `--visual-max-height: 280px` から `300px`。`visual-dense` は `240px` から `260px`、`visual-full` は `360px` から `410px` を目安にする。
+- `![w:900]` 以上の幅指定は、本文がほぼないスライドに限定する。
+- SVG内の重要要素は上下左右40px以上の内側余白を残し、縮小表示時に端の矢印やラベルが切れないようにする。
+- SVG単体の `viewBox` 内に収まっていても、Marpに配置した結果スライド枠からはみ出す場合は失敗として扱う。
+
+## 外部SVGとinline SVGの使い分け基準
+
+| 形式 | 適したケース | 備考 |
+|------|-------------|------|
+| 外部SVGファイル(`images/*.svg`) | 複数スライドから再利用する図版、単体での差分レビューを重視する図版 | どちらでもよい場合は外部ファイルを既定とする |
+| inline SVG | スライド固有の図版で、deckのCSS変数・classと一体で制御する必要がある場合 | `html: true` front matterが前提 |
+
+## inline SVG規約
+
+inline SVGを使う場合は、外部SVGファイルに適用される既存の規約をすべて同等に適用する。
+
+- **フォントスタック**: 外部SVGと同じく `'Noto Sans JP','Hiragino Sans','Yu Gothic',sans-serif`(デザイン制約のfont-family規約を適用する)。
+- **サイズ containment**: `viewBox`を設定し、親classの containment(`--visual-max-height`系token)でスライド領域内に収める。個別の幅・高さ指定ではなく、class側CSSで制御するMarp配置制約を適用する。
+- **長文禁止・テキスト収まり規則**: 禁止事項の「SVG内に長文を詰め込む」「テキストが図形からはみ出した状態で残す」「図形幅より明らかに長い単一行ラベルを置く」をinline SVGにも適用する。デザイン制約の文字量上限(日本語1行18文字程度、英数字1行16文字程度)もinline SVGのテキスト要素に適用する。
+- **`html: true` 前提**: SLIDES.md front matterに `html: true` を設定している場合にのみ使用する(knowledge規約 `takt-marp-repo-conventions` と連動)。
+
+## 禁止事項
+
+- SVG内に長文を詰め込む。
+- テキストが図形からはみ出した状態で残す。
+- 図形幅より明らかに長い単一行ラベルを置く。
+- Marp配置時にスライド枠から図の一部が切れる状態で残す。
+- 読めないほど文字を圧縮・縮小して収める。
+- AI生成ラスター画像に構造説明や文字情報を任せる。

package/templates/project/facets/policies/takt-marp-worker-boundary.md

@@ -0,0 +1,32 @@
+{extends:coding}
+
+# TAKT Worker Boundaryポリシー
+
+TAKTの各step担当者が、ワークフローエンジンではなく割り当てられた作業者として動くことを守る。
+
+## 原則
+
+| 原則 | 基準 |
+|------|------|
+| step実行に集中 | 現在のstepのpersona、policy、knowledge、instructionだけに従う |
+| TAKTを再起動しない | `takt`、`TAKT Workflow Engine`、Team Lead用スキルを読まない・呼ばない |
+| オーケストレーションしない | workflow解決、step遷移、チーム作成、サブエージェント起動を自分で行わない |
+| 成果物を直接作る | 指示されたファイル生成、レビュー、QAを自分のstep内で完了する |
+| 前提不足は止める | 必要な入力ファイルがない場合は不足を報告し、推測で先へ進まない |
+| 入力境界を守る | `brief.md`、`plan.md`、指定Knowledge、明示Source Materialsだけを根拠にする |
+| 承認境界を守る | approval file は人間操作の記録であり、worker は生成しない |
+
+## 禁止事項
+
+- `takt` スキルを選択してTeam Leadとして振る舞う。
+- `.agents/skills/**/builtins/skill*/SKILL.md` や `~/.agents/skills/takt/SKILL.md` を読む。
+- workflow YAMLを再解釈して別のTAKT実行を始める。
+- 現在のstepを越えて次stepの作業を勝手に実行する。
+- Codex memory、rollout summaries、過去セッションログを、明示Source Materialでないのに読む。
+- `review/*-approval.md` を生成、上書き、削除する。
+- git commit、push、branch 操作、PR 操作を行う。
+
+## 期待される振る舞い
+
+現在のプロンプトはTAKTが組み立てたstep実行依頼である。
+担当者は「TAKTを操作する人」ではなく「TAKTから呼ばれた作業者」として、割り当てられた作業を実行する。

package/templates/project/workflows/takt-marp-slide-ai-quality-gate.yaml

@@ -0,0 +1,125 @@
+name: takt-marp-slide-ai-quality-gate
+description: Marp slide command 向けの internal callable AI antipattern quality gate。
+subworkflow:
+  callable: true
+  visibility: internal
+  returns:
+    - need_replan
+  params:
+    fix_instruction:
+      type: facet_ref
+      facet_kind: instruction
+      default: takt-marp-ai-antipattern-fix
+    domain_knowledge:
+      type: facet_ref[]
+      facet_kind: knowledge
+      default:
+        - takt-marp-repo-conventions
+workflow_config:
+  provider_options:
+    codex:
+      network_access: false
+    opencode:
+      network_access: false
+max_steps: 12
+initial_step: ai-antipattern-review-1st
+
+instructions:
+  takt-marp-ai-antipattern-review: ../facets/instructions/takt-marp-ai-antipattern-review.md
+  takt-marp-ai-antipattern-fix: ../facets/instructions/takt-marp-ai-antipattern-fix.md
+
+policies:
+  takt-marp-worker-boundary: ../facets/policies/takt-marp-worker-boundary.md
+
+knowledge:
+  takt-marp-repo-conventions: ../facets/knowledge/takt-marp-repo-conventions.md
+
+report_formats:
+  takt-marp-ai-antipattern-review: ../facets/output-contracts/takt-marp-ai-antipattern-review.md
+  takt-marp-ai-antipattern-fix: ../facets/output-contracts/takt-marp-ai-antipattern-fix.md
+
+loop_monitors:
+  - cycle:
+      - ai-antipattern-review-1st
+      - ai-antipattern-fix
+    threshold: 3
+    judge:
+      persona: supervisor
+      instruction: loop-monitor-ai-antipattern-fix
+      rules:
+        - condition: Healthy (AI findings are shrinking or the latest fix report has concrete finding decisions)
+          next: ai-antipattern-review-1st
+        - condition: Unproductive (loop_monitors.threshold reached for ai-antipattern-review-1st and ai-antipattern-fix)
+          next: request-replan
+
+steps:
+  - name: ai-antipattern-review-1st
+    edit: false
+    required_permission_mode: readonly
+    persona: ai-antipattern-reviewer
+    policy:
+      - review
+      - ai-antipattern
+      - takt-marp-worker-boundary
+    knowledge:
+      $param: domain_knowledge
+    pass_previous_response: false
+    instruction: takt-marp-ai-antipattern-review
+    output_contracts:
+      report:
+        - name: ai-antipattern-review.md
+          format: takt-marp-ai-antipattern-review
+    rules:
+      - condition: result approved and blocking_finding_count is 0
+        next: COMPLETE
+      - condition: result needs_fix and blocking_finding_count is greater than 0
+        next: ai-antipattern-fix
+      - condition: result blocked or target, command, reviewed_scope, workflow_run_id, or finding evidence is missing
+        next: request-replan
+      - when: "true"
+        next: request-replan
+        appendix: Treat ambiguous, internally inconsistent, or evidence-incomplete AI review outcomes as requiring replanning.
+
+  - name: ai-antipattern-fix
+    edit: true
+    required_permission_mode: edit
+    persona: coder
+    policy:
+      - coding
+      - testing
+      - ai-antipattern
+      - takt-marp-worker-boundary
+    session: refresh
+    knowledge:
+      $param: domain_knowledge
+    pass_previous_response: false
+    instruction:
+      $param: fix_instruction
+    output_contracts:
+      report:
+        - name: ai-antipattern-fix.md
+          format: takt-marp-ai-antipattern-fix
+    rules:
+      - condition: status FIXED and all AI findings were handled within the current command boundary
+        next: ai-antipattern-review-1st
+      - condition: status NO_FIX_NEEDED and finding-level evidence supports every finding decision
+        next: COMPLETE
+      - condition: status NEED_REPLAN
+        return: need_replan
+      - condition: status BLOCKED
+        next: request-replan
+      - when: "true"
+        next: request-replan
+        appendix: Treat ambiguous, internally inconsistent, or evidence-free fix outcomes as requiring replanning.
+
+  - name: request-replan
+    edit: false
+    required_permission_mode: readonly
+    persona: supervisor
+    instruction: |
+      Marp slide AI antipattern quality gate が通常 review/inspection/verification へ安全に進めない状態です。
+      target、command、reviewed scope、workflow run、finding evidence、または fix convergence が不明確なため、caller workflow が current command の owning work step へ戻れるように need_replan を返してください。
+      この gate は human approval file を生成せず、command successful state も変更しません。
+    rules:
+      - condition: Replan is required after an ambiguous, blocked, internally inconsistent, or non-convergent AI antipattern gate outcome
+        return: need_replan