pptx-author

Step 2 — 作成者（pptx-author）

各スライドに、適用する正確なテンプレートレイアウトを [HINT: layout_name] で指定して、Markdown でデッキを作成します。これは「テンプレートのレイアウトを把握する」（Step 1）から「デッキをレンダリングする」（Step 3）への橋渡しです。

  STEP 1 — PROFILE          STEP 2 — AUTHOR           STEP 3 — RENDER
  pptx-profile              pptx-author               pptx-from-layouts
  ───────────────           ───────────────           ─────────────────
  your-template.pptx        slides.md (+ [HINT:])     slides.md + config
        │                         │                         │
        ▼                         ▼                         ▼
   catalog.py  ──catalog.md──▶  write & lint  ──slides──▶  generate.py ─▶ deck.pptx
        └────────────────── config.json ───────────────────▲   (validated)

現在のステップ：Step 2 です。 Step 1 の layout-catalog.md が必要です（または、同梱の Inner Chapter レイアウトを使用します）。出力する slides.md はレンダラーが読み込みます。

仕様

1. スライドは --- で区切ります。 各スライドはタイトルと、必要に応じてヒントで始めます。
2. # Slide N: Title または ## Title — タイトルです。ラベルではなく、主張にしてください（「3つのブリーフを1つの基盤に」—「概要」ではなく）。
3. [HINT: layout_name] — Step 1 のカタログにある実際のレイアウト名を指定します。カタログの Hint 列から値をそのままコピーしてください。エンジンがそのレイアウトのプレースホルダーを埋めます。
4. コンテンツをレイアウトに合わせます。
   • column-* / grid-* レイアウト → [Column N: Header] ブロック（または **Header** と本文行）。
   • 画像を含むレイアウト → [Image: path/to.jpg]。
   • 表形式のデータ → Markdown の表。
   • その他すべて → - の箇条書き（最後の手段です。反射的に使わないでください）。

ヒントとビジュアルタイプ — 使い分け

用意できているもの…	次の形式で作成	理由
プロファイル済みテンプレートとそのカタログ	[HINT: real-layout-name]	正確：特定のレイアウトを指定します。「作成」時の方法です。
カタログがない／レイアウトが不明	**Visual: type**（例：process-4-phase）	意味ベース：エンジンが意図に合ったレイアウトを自動選択します。

[HINT:] が両方ある場合は常に優先されます。テンプレートに一致しないヒントは警告付きで無視され、自動検出にフォールバックします。つまり、まずリントしてください。

レンダリング前にリントする

python scripts/lint_hints.py slides.md --config your-template-config.json
# or, against the Step-1 markdown catalog:
python scripts/lint_hints.py slides.md --catalog your-template-layout-catalog.md
# no flag → validates against the bundled Inner Chapter template

リンターはスライドごとに、P0 不明なヒント（「もしかして…？」という候補を提示します。レンダリングが誤る原因になります）、P1 タイトルの欠落、P2 箇条書きと表の混在を検出します。終了コード 2 は修正して再実行する必要があることを示します。

例

# Slide 1: Personas that respond like real humans

[HINT: title-cover]

### Inner Chapter

---

# Slide 2: Three outcomes the research must achieve

[HINT: column-3-centered-a]

[Column 1: Level-set the teams]
- Confirm what's known about each athlete

[Column 2: Capture room content]
- In-home video, voice clips, phone recordings

[Column 3: Deliver for leadership]
- A visceral understanding for senior stakeholders

---

# Slide 3: Why personas are the hard part

[HINT: content-image-right-a]

[Image: assets/persona-diagram.png]

- No world model — pattern-matching only
- Bias toward agreeableness — more positive than real consumers

タイポグラフィマーカー（インライン）

マーカー	結果		マーカー	結果
{bold}text{/bold}	太字		{bullet:-}	ダッシュ形式の箇条書き
{italic}text{/italic}	斜体		{bullet:1}	番号付き
{blue}text{/blue}	ブランドカラー		{level:N}	インデントレベル

次のステップ

slides.md（およびテンプレートと設定）を Step 3 — pptx-from-layouts に渡します。

python ../pptx-from-layouts/scripts/generate.py slides.md -o deck.pptx \
    --template your-template.pptx --config your-template-config.json --validate

元のメモやソース文書から、ヒントタグ付きの slides.md を自動生成する場合は、pptx-outline-architect サブエージェントが大部分の作業を担います。