takt-marp 0.1.0

package/scripts/takt-marp-verify-delivery-artifacts.mjs

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+import {
+  formatError,
+  resolveDeckTarget,
+  SlideWorkflowError,
+} from "./lib/takt-marp-slide-workflow.mjs";
+
+const EXPECTED_ARTIFACTS = Object.freeze({
+  html: "SLIDES.html",
+  pdf: "SLIDES.pdf",
+  pptx: "SLIDES.pptx",
+});
+
+function usage() {
+  return [
+    "Usage: node scripts/takt-marp-verify-delivery-artifacts.mjs <work|verify> [target]",
+    "",
+    "When target is omitted, the newest matching deliver report under slides/*/review is used.",
+    "",
+    "Examples:",
+    "  node scripts/takt-marp-verify-delivery-artifacts.mjs work",
+    "  node scripts/takt-marp-verify-delivery-artifacts.mjs verify slides/my-talk",
+  ].join("\n");
+}
+
+function main() {
+  const [mode, target] = process.argv.slice(2);
+  if (mode === "--help" || mode === "-h") {
+    console.log(usage());
+    return;
+  }
+  if (!["work", "verify"].includes(mode)) {
+    throw new SlideWorkflowError(usage(), "INVALID_ARGS");
+  }
+
+  const currentTarget = target ? null : readCurrentWorkflowTarget();
+  const targetInfo = resolveDeckTarget(target ?? currentTarget?.target ?? inferTargetFromNewestReport(mode));
+  const requested = readRequestedDeliverables(targetInfo);
+  const shouldVerifyArtifacts = mode === "work"
+    ? verifyWorkReport(targetInfo, requested)
+    : verifyReviewReport(targetInfo, requested);
+  if (!shouldVerifyArtifacts) {
+    console.log(`delivery artifact verification skipped for non-successful ${mode} report: ${targetInfo.target}`);
+    return;
+  }
+
+  const artifacts = listOfficialArtifacts(targetInfo);
+  assertRequestedArtifacts(targetInfo, requested, artifacts);
+  assertNoUnrequestedArtifacts(requested, artifacts);
+  console.log(`delivery artifacts verified: ${targetInfo.target}`);
+}
+
+function readCurrentWorkflowTarget() {
+  const markerPath = path.join(process.cwd(), ".takt", "workflow-current-target.json");
+  if (!existsSync(markerPath)) return null;
+  const marker = JSON.parse(readFileSync(markerPath, "utf8"));
+  if (marker.command !== "deliver") return null;
+  assert(typeof marker.target === "string" && marker.target, "current workflow target missing");
+  return marker;
+}
+
+function inferTargetFromNewestReport(mode) {
+  const reportName = mode === "work" ? "deliver-work.md" : "deliver-verify.md";
+  const slidesRoot = path.join(process.cwd(), "slides");
+  const candidates = readdirSync(slidesRoot, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => path.join(slidesRoot, entry.name, "review", reportName))
+    .filter((reportPath) => existsSync(reportPath))
+    .map((reportPath) => Object.freeze({ reportPath, mtimeMs: statSync(reportPath).mtimeMs }))
+    .sort((left, right) => right.mtimeMs - left.mtimeMs);
+
+  if (candidates.length === 0) {
+    throw new SlideWorkflowError(`No ${reportName} found under slides/*/review`, "DELIVERY_REPORT_MISSING");
+  }
+  const deck = path.basename(path.dirname(path.dirname(candidates[0].reportPath)));
+  return `slides/${deck}`;
+}
+
+function readRequestedDeliverables(targetInfo) {
+  const plan = readText(path.join(targetInfo.deckPath, "plan.md"));
+  const match = plan.match(/deliverables\s*:\s*\[([^\]]*)\]/i);
+  assert(match, "plan.md deliverables field missing");
+  const requested = match[1]
+    .split(",")
+    .map((item) => item.trim().replace(/^['"]|['"]$/g, "").toLowerCase())
+    .filter(Boolean);
+  for (const item of requested) {
+    assert(EXPECTED_ARTIFACTS[item], `unsupported deliverable ${item}`);
+  }
+  return Object.freeze(requested);
+}
+
+function listOfficialArtifacts(targetInfo) {
+  const distPath = path.join(process.cwd(), "dist", targetInfo.deckName);
+  assert(existsSync(distPath), "dist/<deck> missing");
+  return Object.freeze(
+    readdirSync(distPath, { recursive: true })
+      .filter((file) => statSync(path.join(distPath, file)).isFile())
+      .map((file) => String(file).split(path.sep).join("/"))
+      .filter((file) => /\.(html|pdf|pptx)$/.test(file)),
+  );
+}
+
+function assertRequestedArtifacts(targetInfo, requested, artifacts) {
+  const distPath = path.join(process.cwd(), "dist", targetInfo.deckName);
+  for (const item of requested) {
+    const file = EXPECTED_ARTIFACTS[item];
+    assert(artifacts.includes(file), `requested artifact missing: ${file}`);
+    const stat = statSync(path.join(distPath, file));
+    assert(stat.size > 0, `empty artifact: ${file}`);
+  }
+}
+
+function assertNoUnrequestedArtifacts(requested, artifacts) {
+  for (const file of artifacts) {
+    const kind = Object.keys(EXPECTED_ARTIFACTS).find((key) => EXPECTED_ARTIFACTS[key] === file);
+    assert(kind && requested.includes(kind), `stale or unrequested official artifact exists: ${file}`);
+  }
+}
+
+function verifyWorkReport(targetInfo, requested) {
+  const work = readText(path.join(targetInfo.reviewPath, "deliver-work.md"));
+  const result = matchReportResult(work, ["passed", "needs_input", "failed"], "deliver-work.md");
+  if (result !== "passed") return false;
+
+  const cleaned = work.match(/Cleaned directory:\s*(.+)/i);
+  assert(
+    cleaned && cleaned[1].trim() && !/^\s*(?:no|false|not cleaned\b.*|not_cleaned\b.*|uncleaned\b.*)\s*$/i.test(cleaned[1]),
+    "deliver-work.md missing positive cleaned directory evidence",
+  );
+  assertReportReferences(work, requested, "deliver-work.md");
+  return true;
+}
+
+function verifyReviewReport(targetInfo, requested) {
+  const verify = readText(path.join(targetInfo.reviewPath, "deliver-verify.md"));
+  const result = matchReportResult(verify, ["approved", "needs_fix", "blocked"], "deliver-verify.md");
+  if (result !== "approved") return false;
+
+  const work = readText(path.join(targetInfo.reviewPath, "deliver-work.md"));
+  assertReportReferences(work, requested, "deliver-work.md");
+  assertReportReferences(verify, requested, "deliver-verify.md");
+  return true;
+}
+
+function assertReportReferences(report, requested, reportName) {
+  for (const item of requested) {
+    const file = EXPECTED_ARTIFACTS[item];
+    assert(report.includes(file), `${reportName} missing artifact reference: ${file}`);
+  }
+}
+
+function matchReportResult(report, values, reportName) {
+  const pattern = values.join("|");
+  const result = report.match(new RegExp(`^result:\\s*(${pattern})\\s*$`, "m")) ??
+    report.match(new RegExp(`^-\\s*Result:\\s*(${pattern})\\s*$`, "im"));
+  assert(result, `${reportName} result missing`);
+  return result[1];
+}
+
+function readText(filePath) {
+  if (!existsSync(filePath)) {
+    throw new SlideWorkflowError(`Missing file: ${path.relative(process.cwd(), filePath)}`, "FILE_MISSING");
+  }
+  return readFileSync(filePath, "utf8");
+}
+
+function assert(condition, message) {
+  if (!condition) {
+    throw new SlideWorkflowError(message, "DELIVERY_ARTIFACT_INVALID");
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(formatError(error));
+  process.exit(1);
+}

package/scripts/takt-marp-verify-render-evidence-metadata.mjs

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+import {
+  formatError,
+  parseArgs,
+  resolveDeckTarget,
+  SlideWorkflowError,
+} from "./lib/takt-marp-slide-workflow.mjs";
+
+function usage() {
+  return [
+    "Usage: node scripts/takt-marp-verify-render-evidence-metadata.mjs [target] [--cycle <n>]",
+    "",
+    "When target is omitted, .takt/render/latest-render-evidence.json is used.",
+    "",
+    "Examples:",
+    "  node scripts/takt-marp-verify-render-evidence-metadata.mjs",
+    "  node scripts/takt-marp-verify-render-evidence-metadata.mjs slides/my-talk --cycle 1",
+  ].join("\n");
+}
+
+function main() {
+  const { positional, flags } = parseArgs(process.argv.slice(2));
+  if (flags.help) {
+    console.log(usage());
+    return;
+  }
+
+  const currentTarget = positional[0] ? null : readCurrentWorkflowTarget();
+  const marker = positional[0] ? null : readLatestMarker();
+  if (currentTarget) {
+    assert(marker.target === currentTarget.target, `latest render evidence target mismatch: ${marker.target}`);
+  }
+  const targetInfo = resolveDeckTarget(positional[0] ?? currentTarget?.target ?? marker.target);
+  const cycle = Number(flags.cycle ?? marker?.cycle ?? 1);
+  if (!Number.isInteger(cycle) || cycle < 1) {
+    throw new SlideWorkflowError(`Invalid cycle '${flags.cycle}'. Expected positive integer.`, "INVALID_ARGS");
+  }
+
+  const root = path.join(process.cwd(), ".takt", "render", targetInfo.deckName, `cycle-${cycle}`);
+  const metadataPath = path.join(root, "metadata.json");
+  const data = readJson(metadataPath);
+
+  assert(data.target === targetInfo.target, `metadata target mismatch: ${data.target}`);
+  assert(data.cycle === cycle, `metadata cycle mismatch: ${data.cycle}`);
+  assertUsableStatus("html_png", data.html_png);
+  assertArrayFiles(root, "html_png", data.html_png.files);
+  assertUsableStatus("pdf", data.pdf);
+  assertFile(root, "pdf", data.pdf.file);
+
+  if (assertReasonedNonUsable("pdf_raster", data.pdf_raster)) {
+    assertArrayFiles(root, "pdf_raster", data.pdf_raster.files);
+  }
+
+  console.log(`render evidence metadata verified: ${path.relative(process.cwd(), metadataPath)}`);
+}
+
+function readLatestMarker() {
+  const markerPath = path.join(process.cwd(), ".takt", "render", "latest-render-evidence.json");
+  const marker = readJson(markerPath);
+  assert(typeof marker.target === "string" && marker.target, "latest render evidence marker target missing");
+  assert(Number.isInteger(marker.cycle), "latest render evidence marker cycle missing");
+  return marker;
+}
+
+function readCurrentWorkflowTarget() {
+  const markerPath = path.join(process.cwd(), ".takt", "workflow-current-target.json");
+  if (!existsSync(markerPath)) return null;
+  const marker = readJson(markerPath);
+  if (marker.command !== "polish") return null;
+  assert(typeof marker.target === "string" && marker.target, "current workflow target missing");
+  return marker;
+}
+
+function readJson(filePath) {
+  if (!existsSync(filePath)) {
+    throw new SlideWorkflowError(`Missing file: ${path.relative(process.cwd(), filePath)}`, "FILE_MISSING");
+  }
+  return JSON.parse(readFileSync(filePath, "utf8"));
+}
+
+function assertUsableStatus(key, item) {
+  assert(item && typeof item.status === "string", `${key} status missing`);
+  assert(!["pending", "failed", "degraded", "skipped"].includes(item.status), `${key} status not usable: ${item.status}`);
+}
+
+function assertReasonedNonUsable(key, item) {
+  assert(item && typeof item.status === "string", `${key} status missing`);
+  assert(!["pending", "failed"].includes(item.status), `${key} status not usable: ${item.status}`);
+  if (["degraded", "skipped"].includes(item.status)) {
+    assert(typeof item.reason === "string" && item.reason.trim(), `${key} reason missing for ${item.status}`);
+    return false;
+  }
+  return true;
+}
+
+function assertArrayFiles(root, key, files) {
+  assert(Array.isArray(files) && files.length > 0, `${key} files missing`);
+  files.forEach((file, index) => assertFile(root, `${key}[${index}]`, file));
+}
+
+function assertFile(root, label, value) {
+  assert(typeof value === "string" && value.trim(), `${label} path missing`);
+  const filePath = resolveEvidenceFile(root, value);
+  assert(existsSync(filePath), `${label} file missing: ${value}`);
+  const stat = statSync(filePath);
+  assert(stat.isFile() && stat.size > 0, `${label} file missing or empty: ${value}`);
+}
+
+function resolveEvidenceFile(root, value) {
+  if (path.isAbsolute(value)) {
+    return value;
+  }
+  const rootRelativePath = path.join(root, value);
+  if (existsSync(rootRelativePath)) {
+    return rootRelativePath;
+  }
+  return path.join(process.cwd(), value);
+}
+
+function assert(condition, message) {
+  if (!condition) {
+    throw new SlideWorkflowError(message, "RENDER_EVIDENCE_INVALID");
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(formatError(error));
+  process.exit(1);
+}

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

@@ -0,0 +1,47 @@
+{extends:fix}
+
+AI antipattern review の finding を、current command 境界内で安全に直せる場合だけ修正してください。
+
+**やること:**
+1. `.takt/workflow-current-target.json` を読み、`target: slides/<deck>` と `command: plan | compose | polish | deliver` を特定してください。
+2. `review/<command>-ai-antipattern-review.md` を読み、同じ `target`、`command`、`workflow_run_id` の current review report であることを確認してください。deck-local report が存在しない場合は、現在の `Report Directory` にある `ai-antipattern-review.md`、または同じ subworkflow reports directory の review report を読んでください。
+3. AI Findings の全 finding を扱い、各 finding について current command 境界内で安全に修正できるか判断してください。
+4. 修正できる finding だけを command-local source artifact に反映してください。
+   - `plan`: `plan.md`、`brief.normalized.md` など plan source artifact の範囲。deck-local が未同期の場合は、現在の `Report Directory` から親 command reports directory を特定し、そこにある `plan.md` / `brief.normalized.md` を正本として修正してください。`Report Directory` が `.../reports/subworkflows/...` の場合、`subworkflows` より前の `.../reports` が親 command reports directory です。
+   - `compose`: `SLIDES.md` と compose に必要な deck-local source artifact の範囲
+   - `polish`: `design-system.md`、`SLIDES.md`、`images/*.svg` など visual / layout / render / design-token 修正の範囲
+   - `deliver`: delivery artifact の存在、path、readability、unrequested artifact、必要な clean / rebuild の範囲
+5. current command 境界内で安全に直せない finding は `NEED_REPLAN` とし、必要な owning command と理由を Remaining Context に記録してください。
+6. 必要情報が足りず判断または修正できない finding は `BLOCKED` とし、不足 context と evidence を Remaining Context に記録してください。
+7. `review/<command>-ai-antipattern-fix.md` に finding ごとの decision、changed files、validation evidence、remaining context を記録してください。
+
+**境界:**
+- approval file を生成、上書き、削除しないでください。`review/*-approval.md` は人間操作の記録です。
+- git commit、push、branch 操作、PR 操作、TAKT 再起動、workflow orchestration を行わないでください。
+- AI review report にない通常品質 finding を追加修正しないでください。
+- `polish` を plan redesign、中心メッセージ変更、deliverables 変更へ広げないでください。
+- `deliver` を visual / layout / content / design-token inspection へ広げないでください。該当する問題は `NEED_REPLAN` または `BLOCKED` の context として記録してください。
+- external web access を標準の成功条件にしないでください。明示 source material と repository evidence だけを根拠にしてください。
+
+**判定基準:**
+- 全 finding を current command 境界内で修正でき、validation evidence を記録できた場合は `FIXED` としてください。
+- 修正不要と判断する場合は `NO_FIX_NEEDED` とし、すべての finding に finding-level evidence を記録してください。
+- current command 境界外の作業、上流 artifact の再設計、人間判断が必要な場合は `NEED_REPLAN` としてください。
+- report、target、command、workflow_run_id、source artifact、必要 context のいずれかを確認できない場合は `BLOCKED` としてください。
+- plan command では、deck-local `brief.normalized.md` / `plan.md` がまだ存在しないことだけを `NEED_REPLAN` または `BLOCKED` 理由にしないでください。親 command reports directory の source artifact が読め、finding を current command 境界内で修正できる場合はその report artifact を更新してください。
+
+**report file format:**
+- `review/<command>-ai-antipattern-fix.md` は `.takt/facets/output-contracts/takt-marp-ai-antipattern-fix.md` に従ってください。
+- YAML front matter は flat scalar のみとし、`command`、`target`、`generated_at`、`workflow_run_id`、`step: ai_antipattern_fix`、`cycle`、`status`、`handled_finding_count`、`changed_file_count`、`remaining_context_count` を含めてください。
+- `status` は `FIXED`、`NO_FIX_NEEDED`、`NEED_REPLAN`、`BLOCKED` のいずれかだけを使ってください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## AI Antipattern Fix
+- Status: FIXED / NO_FIX_NEEDED / NEED_REPLAN / BLOCKED
+- Reviewed target:
+- Reviewed command:
+- Handled findings:
+- Changed files:
+- Validation evidence:
+- Remaining context:

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

@@ -0,0 +1,37 @@
+command work output を通常 review / inspect / verify に渡す前に、AI 固有の antipattern だけをレビューしてください。
+
+**やること:**
+1. `.takt/workflow-current-target.json` を読み、`target: slides/<deck>` と `command: plan | compose | polish | deliver` を特定してください。
+2. 対象 deck の `review/<command>-work.md` を読み、front matter と本文から同じ `target`、`command`、`workflow_run_id`、work 成果物の範囲を確認してください。deck-local report が存在しない場合は、現在の `Report Directory` から親 command の reports directory を特定し、そこにある `<command>-work.md` を読んでください。`Report Directory` が `.../reports/subworkflows/...` の場合、`subworkflows` より前の `.../reports` が親 command の reports directory です。
+3. command に応じて reviewed scope を特定してください。`plan` と `compose` は `command-work-report` と source artifacts、`polish` は `render-evidence`、`deliver` は `delivery-artifacts` を主範囲にしてください。`plan` の source artifacts は deck-local が未同期なら親 command reports directory の `brief.normalized.md` と `plan.md` を正本として照合してください。
+4. 以下だけを AI-specific finding として分類してください。
+   - hallucinated path/tool/API: 存在しない path、利用できない tool、実在確認できない API を前提にした出力
+   - unsupported claim: 入力 source artifact、work report、render/delivery evidence にない主張
+   - unrequested compatibility: 指示されていない後方互換、代替形式、余分な fallback behavior
+   - overbroad abstraction: command 境界を超える抽象化、汎用化、再設計
+   - unused generated artifact: workflow の要求や deliverables に紐づかない生成物
+5. finding がある場合は `review/<command>-ai-antipattern-review.md` に stable `finding_id`、`family_tag`、location、required change、具体的 evidence を記録してください。
+6. ordinary slide content、layout、render、delivery quality finding は、AI-specific fabrication または unsupported assumption に由来する場合だけ AI finding として扱ってください。通常品質だけの観察は `Non-AI Quality Notes` に分離してください。
+
+**判定基準:**
+- target、command、reviewed scope が特定でき、AI-specific finding がなければ `approved` としてください。
+- current command 境界内で修正可能な AI-specific finding がある場合は `needs_fix` としてください。
+- `.takt/workflow-current-target.json`、`review/<command>-work.md`、target、command、workflow_run_id、reviewed scope のいずれかを特定または照合できない場合は `blocked` とし、通常 review / inspect / verify に進めない outcome にしてください。
+- plan command では、deck-local `brief.normalized.md` / `plan.md` がまだ存在しないことだけを `blocked` 理由にしないでください。親 command reports directory の `brief.normalized.md` / `plan.md` が読め、work report と照合できる場合は reviewed scope を確認済みとして扱ってください。
+- 通常の content、layout、render、delivery artifact 品質だけを理由に `needs_fix` にしないでください。
+- external web access を標準の成功条件にしないでください。明示 source material と repository evidence だけを根拠にしてください。
+
+**report file format:**
+- `review/<command>-ai-antipattern-review.md` は `.takt/facets/output-contracts/takt-marp-ai-antipattern-review.md` に従ってください。
+- YAML front matter は flat scalar のみとし、`command`、`target`、`generated_at`、`workflow_run_id`、`step: ai_antipattern_review`、`cycle`、`reviewed_scope`、`result`、`finding_count`、`blocking_finding_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## AI Antipattern Review
+- Result: approved / needs_fix / blocked
+- Reviewed target:
+- Reviewed command:
+- Reviewed scope:
+- AI findings:
+- Non-AI quality notes:
+- Blocking issues:

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

@@ -0,0 +1,25 @@
+{extends:fix}
+
+compose review の finding を精査し、妥当な修正だけを compose source artifacts に反映してください。
+
+**やること:**
+1. `review/compose-review.md` の finding を読み、`plan.md` と `design-system.md` に照らして妥当性を判断してください。
+2. 妥当な finding は `design-system.md`、`SLIDES.md`、`images/*.svg` に反映してください。
+3. plan-level content 変更が必要な finding は反映せず、理由を記録してください。
+4. `review/compose-fix.md` に finding ごとの対応結果を書いてください。
+
+**判定基準:**
+- 妥当な finding をすべて反映または理由付きで非対応にした場合は `fixed` としてください。
+- 安全に修正できない場合は `blocked` としてください。
+
+**report file format:**
+- `review/compose-fix.md` は YAML front matter で開始し、`command: compose`、`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 より前に本文を書いてはいけません。
+
+**必須出力**
+## Compose Fix
+- Result: fixed / blocked
+- Applied findings:
+- Rejected findings:
+- Files changed:
+- Blocking issues:

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

@@ -0,0 +1,30 @@
+compose command の成果物をレビューしてください。
+
+**やること:**
+1. `brief.normalized.md`、`plan.md`、`design-system.md`、`SLIDES.md`、`images/*.svg`、`review/compose-work.md` を読んでください。
+2. content、flow、visual source、Marp source artifact 境界の観点で確認してください。
+3. 以下の追加観点で確認してください。
+   - (a) **style 定義・文書化の存在照合**: plan の各 Layout(custom 句含む)と `SLIDES.md` の各 `_class:` に対応する style 定義(front matter CSS)が存在するか確認してください。`custom:` 句で新設された class については、加えて deck-local `design-system.md` の文書化(`takt-marp-design-system` の文書化規約: class 名・用途・構造・使用スライド番号)が存在するか確認してください。style 定義の欠落、および新設 class の文書化欠落は **blocker** です(基本語彙の class に 4 項目文書化は要求しません)。
+   - (b) **inline SVG の規約適合**: `policy takt-marp-svg-first-visual` の inline SVG 規約(フォントスタック・containment・長文禁止)への適合を確認してください。長文流し込みは **major**、フォントスタック・containment 不適合は **major** です。
+   - (c) **尺マーカーの累計整合と捏造検出**: `brief.normalized.md` の `Event Context` の `Duration` が分単位の数値である場合、各スライドの speaker notes に尺マーカー `【N分 / 累計 M:SS】` が存在するか確認し、欠落しているスライドがあれば **major** として報告してください。尺マーカーが存在する場合、最終スライドの累計が `Duration` と整合するか確認してください。不整合は **major** です。また、`Duration` が「未指定」なのにマーカーが存在する場合も **major** として報告してください。
+   - (d) **先鋭度・密度**: `policy takt-marp-general-slide-quality` の先鋭度・密度基準に従い、汎用タイトル・リード文は **major**、置換可能な低密度 bullet 列挙は **minor**(可読性に明確な悪影響がある場合は **major**)として判定してください。好みだけの指摘は finding にしないでください。
+   - (e) **`html: true` 欠落と font path 解決不能**: `SLIDES.md` に HTML 要素(inline SVG 含む)があるのに front matter に `html: true` がない場合は **blocker** です。`@font-face` を宣言しているが path が `SLIDES.md` からの相対 path として解決不能な場合は **major** です(フォールバックスタックで描画は維持されるため blocker としない)。
+4. render output の有無や表示崩れは polish command の範囲として扱い、この review の成功条件にしないでください。
+5. 修正が必要な finding だけを stable `finding_id` 付きで `review/compose-review.md` に記録してください。
+6. 既定 severity から逸脱する場合は、finding の evidence に理由を記してください。
+
+**判定基準:**
+- compose source artifact の修正が不要なら `approved` としてください。
+- `design-system.md`、`SLIDES.md`、`images/*.svg` の修正で解消できる問題がある場合は `needs_fix` としてください。
+- plan の変更が必要な問題は source artifact を勝手に直さず `blocked` としてください。
+
+**report file format:**
+- `review/compose-review.md` は YAML front matter で開始し、`command: compose`、`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 より前に本文を書いてはいけません。
+
+**必須出力**
+## Compose Review
+- Result: approved / needs_fix / blocked
+- Findings:
+- Out-of-scope findings:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-compose-slides.md

@@ -0,0 +1,35 @@
+承認済みのplanに沿ってMarp Markdownをcomposeしてください。
+
+**やること:**
+1. `brief.normalized.md`、`plan.md`、`design-system.md`を読んでください。
+2. `SLIDES.md`をMarp形式で作成または更新してください。
+3. 各スライドにspeaker notesを付けてください。`brief.normalized.md` の `Event Context` の `Duration` の値が「未指定」以外(分単位の数値)の場合は、各スライドのspeaker notes冒頭行に尺マーカー `【N分 / 累計 M:SS】` を書き、最終スライドの累計を発表時間と整合させてください。`Duration` が「未指定」の場合はマーカーを書かず、推測した時間を記載してはなりません。各スライドのspeaker notesには、聴衆に最も伝えるべき1点(強調点)を含めてください。
+4. visual予定があるスライドには、planの `Visual:` 値に対応する placeholder(例: `<!-- Visual: svg: <ファイル名またはテーマ> -->`、`<!-- Visual: existing: <パス> -->`)を配置してください。SVG markup と画像参照の挿入(外部ファイル・inline・既存画像のすべて)は generate_visuals が所有します。
+5. planの `Layout` と `design-system.md` に従い、Marp classとCSS tokenで表現してください。
+6. `SLIDES.md` のCSSは `design-system.md` のtokenに揃え、スライドごとの個別 `font-size`、`line-height`、`margin`、`padding` の追加を避けてください。
+7. render output の生成や品質判定は行わず、source artifact の作成に集中してください。
+
+**コンテキスト反映規約:**
+- `brief.normalized.md` の `Event Context` の `Name`(イベント名)の値が「未指定」以外の場合は、タイトルスライドに反映してください。
+- `Speaker Profile` 節の内容が「未指定」以外の場合は、自己紹介相当スライドに反映してください。
+- 値が「未指定」の項目・節は反映せず、値を捏造・補完してはなりません(節自体は contract 上常に存在します)。
+
+**機械規約適合:**
+- `SLIDES.md` 本文にHTML要素(inline SVG含む)を使う場合は、front matterに `html: true` を設定してください。
+- fontには日本語優先フォールバックスタック(例: `"Noto Sans JP", "Hiragino Sans", "Yu Gothic", sans-serif`)を必ず指定してください。`@font-face` を宣言する場合は、`SLIDES.md` からの相対pathが実在するファイルのみを参照してください。pathが存在しない環境では `@font-face` を省略し、フォールバックスタックのみで描画してください。
+
+**禁止事項**
+- planの中心メッセージを変更しないでください。
+- official delivery artifact や `.takt/render/` を成功条件にしないでください。
+- approval file を生成しないでください。
+- SVG markup(外部ファイル・inline両形式)を書かないでください(generate_visualsが所有)。
+- 発表時間・イベント名・登壇者情報が「未指定」の場合、値を推測・捏造・補完しないでください。
+
+**必須出力**
+## Compose Slides Result
+- Status: composed / needs_input
+- Files changed:
+- SVG placeholders:
+- Layout decisions:
+- Design system usage:
+- Human review points:

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

@@ -0,0 +1,23 @@
+compose command の work 結果を、後続の review/fix/supervision が読める形で要約してください。
+
+**やること:**
+1. `design-system.md`、`SLIDES.md`、`images/*.svg` の存在と変更状況を確認してください。
+2. compose source artifacts が `plan.md` と `design-system.md` の範囲に収まっているか確認してください。
+3. render output を成功条件に含めず、source artifact の作成・変更だけを整理してください。
+4. `review/compose-work.md` に work summary を書いてください。
+
+**判定基準:**
+- `design-system.md`、`SLIDES.md`、必要な `images/*.svg` が確認できる場合は `passed` としてください。
+- compose source artifact が不足する場合は `needs_input` としてください。
+
+**report file format:**
+- `review/compose-work.md` は YAML front matter で開始し、`command: compose`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: work`、`cycle`、`state: worked`、`result`、`source_artifact_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Compose Work Summary
+- Result: passed / needs_input
+- Source artifacts:
+- Created or changed artifacts:
+- Human review points:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-deliver-build.md

@@ -0,0 +1,30 @@
+official delivery artifact を build してください。
+
+**やること:**
+1. `plan.md` の `deliverables: [html, pdf, pptx]` を authoritative delivery request として読んでください。
+2. export 前に `dist/<deck>/` を削除または空にしてください。
+3. `html` が requested の場合は `npm run build:html -- <deck>` で生成してください。
+4. `pdf` が requested の場合は `npm run build:pdf -- <deck>` で生成してください。
+5. `pptx` が requested の場合だけ `npm run build:pptx -- <deck>` で生成してください。
+6. `review/deliver-work.md` に `Cleaned directory:` として export 前に `dist/<deck>/` を削除または空にした evidence を記録し、clean/build 結果と生成 artifact を記録してください。
+
+**判定基準:**
+- requested deliverables に対応する `SLIDES.html` / `SLIDES.pdf` / `SLIDES.pptx` だけが `dist/<deck>/` に存在する場合は `passed` としてください。
+- `dist/<deck>/` に stale artifact が混ざる場合、または requested artifact が作れない場合は `failed` としてください。
+
+**禁止事項**
+- visual/layout inspection を行わないでください。
+- `design-system.md`、`SLIDES.md`、`images/*.svg` の visual polish を広げないでください。
+- `brief.md` の自由記述から deliverable 種別を追加しないでください。
+
+**report file format:**
+- `review/deliver-work.md` は YAML front matter で開始し、`command: deliver`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: work`、`cycle`、`state: worked`、`result`、`source_artifact_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Delivery Build
+- Result: passed / failed
+- Cleaned directory:
+- Requested deliverables:
+- Generated artifacts:
+- Blocking issues:

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

@@ -0,0 +1,25 @@
+{extends:fix}
+
+delivery verification finding だけを修正してください。
+
+**やること:**
+1. `review/deliver-verify.md` の finding を読み、delivery artifact の存在、path、readability、unrequested artifact の問題だけを扱ってください。
+2. 必要に応じて `dist/<deck>/` の clean と再buildを行ってください。
+3. visual/layout/content/design-token の問題は修正せず、polish command の範囲として記録してください。
+4. `review/deliver-fix.md` に finding ごとの対応結果を書いてください。
+
+**判定基準:**
+- delivery finding をすべて反映または理由付きで非対応にした場合は `fixed` としてください。
+- 安全に修正できない場合は `blocked` としてください。
+
+**report file format:**
+- `review/deliver-fix.md` は YAML front matter で開始し、`command: deliver`、`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 より前に本文を書いてはいけません。
+
+**必須出力**
+## Delivery Fix
+- Result: fixed / blocked
+- Applied findings:
+- Rejected findings:
+- Files changed:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-deliver-verify.md

@@ -0,0 +1,25 @@
+official delivery artifact の completeness を検証してください。
+
+**やること:**
+1. `plan.md` の `deliverables` と `dist/<deck>/` の official artifacts を照合してください。
+2. requested artifact が `SLIDES.html` / `SLIDES.pdf` / `SLIDES.pptx` として存在し、読み取り可能であることを確認してください。
+3. unrequested official artifact または余分な同種 artifact が混ざっていないことを確認してください。
+4. `review/deliver-work.md` と `review/deliver-verify.md` が artifact path と requested deliverables を同じ名前で記録していることを確認してください。
+5. `review/deliver-verify.md` に delivery verification finding を記録してください。
+
+**判定基準:**
+- requested artifact が存在し、不要 artifact がなければ `approved` としてください。
+- delivery artifact の再生成や path 修正で解消できる問題があれば `needs_fix` としてください。
+- visual/layout の再評価が必要な問題は scope 外として扱い、delivery finding にしないでください。
+
+**report file format:**
+- `review/deliver-verify.md` は YAML front matter で開始し、`command: deliver`、`target: slides/<deck>`、`generated_at`、`workflow_run_id`、`step: verify`、`cycle`、`state: verified`、`result`、`finding_count`、`blocking_finding_count` を含めてください。
+- front matter を閉じる `---` の後に Markdown body を書いてください。front matter より前に本文を書いてはいけません。
+
+**必須出力**
+## Delivery Verify
+- Result: approved / needs_fix / blocked
+- Artifact checks:
+- Unrequested artifacts:
+- Findings:
+- Blocking issues:

package/templates/project/facets/instructions/takt-marp-design-system.md

@@ -0,0 +1,37 @@
+承認済みのplanからdeck-localな軽量デザインシステムを作成してください。
+
+**やること:**
+1. `brief.normalized.md`、`plan.md`、既存の `SLIDES.md` があれば確認してください。
+2. `slides/<deck>/design-system.md` を作成または更新してください。
+3. typography、spacing、layout、visual、color、QA rules をdeck単位のtokenとして定義してください。
+4. tokenは `SLIDES.md` のfront matter CSSに転記しやすい名前にしてください。
+5. スライドごとの個別調整ではなく、classとCSS変数で一括制御できる設計にしてください。
+6. planの `Layout` に対応する class の使い分けを、knowledge `takt-marp-repo-conventions` の「Layout 語彙」表に従って定義してください。
+7. planの `Layout` に `custom: <class名> — <用途>` 句がある場合、同名 class を新規定義してください。命名は kebab-case とし、deck の既存 token 体系(CSS 変数・class 命名)と整合させてください。
+8. 新規定義した class(および使用する modifier の組み合わせ)を deck-local `design-system.md` に以下の項目で文書化してください。後続の review / fix がその class を識別できる記述にしてください。
+   - class 名
+   - 用途(1行)
+   - 構造(CSS レイアウト・HTML 構造の概要)
+   - 使用スライド番号
+
+**必須項目**
+- Typography tokens: font family、letter-spacing、H1、lead、bullet、code label、line-height
+- Spacing tokens: section padding、column gap、list gap、image margins
+- Layout tokens: 1列/2列のclass、列比率、align-items、画像最大高
+- Visual tokens: SVG viewBox、外周余白、図形内余白、SVG text size
+- Color tokens: text、muted、accent、success、warning、border、surface
+- QA rules: token外の個別値、負のletter-spacing、過度な上/左寄り、図の過小を検出する基準
+
+**禁止事項**
+- deck全体で使わないtokenを大量に増やさないでください。
+- スライドごとの個別CSSを前提にしないでください。
+- `brief.md` や `plan.md` の中心メッセージを変更しないでください。
+
+**必須出力**
+## Design System Result
+- Status: designed / needs_input
+- Design system file:
+- Token groups:
+- Layout classes:
+- QA rules:
+- Files changed: