# ガイド（/guide）の書き方とサムネイルの決まり

最終更新: 2026-11-15（ガイドの区分を作った日。エイイチの指示で、毎回同じ質で作れるようにまとめた）

ガイドを作る・直す・サムネイルを作るときは、最初にこの文書を読む。記事（LOG）の決まりは article_rules.md が正で、ここはガイドだけの決まり。

---

## 1. ガイドとは何か（LOG との違い）

| | LOG（記録） | ガイド |
|---|---|---|
| 目的 | その日にやったことの記録。AI が読む前提で全量を残す | 検索から初めて来た人が、始め方・費用・つまずきを結論から読む |
| 住所 | `/record/{slug}` | `/guide/{slug}`（一覧は `/guide`） |
| 番号 | LOG番号あり | **付けない**。記録の一覧にも並べない |
| 書き換え | しない（日付つきの記録） | **版や数字が変わったら書き直す**。`updated` を更新し、末尾の「このページの更新」の表に1行足す |
| 中身の根拠 | それ自体が一次資料 | LOG。数字や事実には必ず出どころの LOG へのリンクを付ける |

- いわゆる SEO 記事。キーワードを決めてから書く
- 公開後は住所（slug）を変えない。変えるときは 301 の転送を足し、公開前に codex のレビューを挟む（MASTER）
- LOG を書き直したくなったら、LOG は直さず、ガイドを新しく作るか書き足す（2026-11-15）
- トップのシリーズのカードに「ガイド | Guide」（→ `/guide`）がある。ガイドはシリーズではない

## 2. 作る前の調べ

1. **キーワード**：Google キーワードプランナー（月の検索回数・前年比）と Search Console（旧アドレス adaptdesign.jp の6か月の表示も）で語を選ぶ。結果は `research/keyword_planner_{日付}_{用途}.md` に残す
2. **重なりの確認**：同じ人・同じ語を狙うページ（LP・入口ページ・ほかのガイド）がないか見る。あれば1枚にまとめる（2026-11-15「再現の入口」と π0.5 のガイドを1枚にした）
3. **中身はすべて LOG から**：数字は LOG の本文・測定データで確かめ直す（要約やメモリの数字をそのまま使わない）。最新の数字は元データから数え直す（例：推論の判定 CSV）
4. **ログにない値は作らない**：版・型番など記録にない物は「ログにない」と書き、表に残す

## 3. 書き方

### 先頭の項目（`src/content/guides/{slug}.md`）
```
---
title: "{答えになる題} ― {キーワードを含む副題}"
slug: {英語の短い名前}
published: YYYY-MM-DD
updated: YYYY-MM-DD
meta_description: "{冒頭の答え＋数字。120字前後}"
tags: [狙う語を並べる]
thumb: /site/guides/{slug}.webp
---
```
- LOG から移したものは `former_log: {番号}` を足す

### 本文の型
1. **最初の太字の1文が答え**（例：「π0.5 は、GPU を持っていない個人でも、借りた GPU で追加学習して動かせる。」）。続けて決め手の数字と出どころの LOG
2. 「このページは〜をまとめた手順書です。版や数字が変わったら書き直します」と1段落で役割を書く
3. 「このページで分かること」を3〜4項目
4. 用語の説明の節（初めての人向け。例：VLA とは）
5. 環境・条件の表（項目／記録にある値／出どころ）。記録にない物は「ログにない」
6. 手順（手順1〜5 のように始める順）。各段に時間・費用・つまずき・出どころ
7. **よく検索される問いの形の見出し**（例：「アームへの指令が1回1.6秒もかかる」）＋答え＋出どころ
8. 今の到達点（数字はどの条件の数かを書く）
9. 足りない情報（ログにない物）
10. 試した人からの連絡の案内（/message へ。書いてほしい4項目）
11. 「このページの更新」の表（日付・変えたこと）

### 言葉
- language_rules.md に従う。初めて来た人が分かる言葉にする。「LOG」「答えから先に」「根拠としてリンク」のような内輪の言葉は、一覧の説明文や冒頭には出さない（2026-11-15）
- 数字は出どころの LOG と同じ値・同じ単位。費用は円（ドルは併記）

## 4. サムネイル（ガイドのイラストの決まり）

### 作り方（役割分担）
- **絵は ChatGPT に描かせる**（エイイチの Chrome の ChatGPT。文字なし）
- **日本語の題は Claude が組む**（絵を作る AI は日本語を崩すため。サイトの書体で組む。2026-11-15 エイイチ了承）
- 置き場所：サイト用は p2m-site の `public/site/guides/{slug}.webp`（表示用）と `.jpg`（SNS・検索用）。元の絵と題を組んだ HTML は iCloud の `デジタルツイン学習R2R2R/ガイド/_card/`

### ChatGPT への共通の指示（毎回この文をそのまま使う）
> 画像を1枚作ってください。横長 16:9（1920×1080）。文字・数字・ロゴは一切入れない。共通のスタイル：背景は黒（#0d0d0d）一色の面。フラットで面の構成のシンプルなイラスト（白・オフホワイト・グレーの面、細い線は使わない）。差し色は赤を1か所だけ。床は濃いグレーの方眼のマットを面で表現。主役は画面の右側55%に収め、左側45%は黒い余白のまま空けておく（あとで文字を置くため）。写真風・3DCG風・グラデーション・人物の顔は入れない。主題：{記事の主題を1文}。{何をどこに置くかを具体的に}

- 主題は記事を読み直して、いちばん伝えたいこと1つを絵にする（例：借りた GPU → 雲の中のサーバーとアームを点線でつなぐ／ワンショット学習 → 人の手の手本をアームがまねる／買うか借りるか → 天秤に PC と赤い札付きの GPU）
- 観葉植物・ペン立て・本などの小物は入れない（明るい版で既製の素材っぽくなった）
- 記号的すぎる物（雲＋砂時計など）は弱い。物そのもの（GPU の基板など）で表す（2026-11-15 エイイチ「これだけイマイチ」）
- 絵がよくなければ、その1枚だけ作り直す

### 題の組み方
- 1920×1080。左上（または下の構図の位置）に3段：
  - 小さなラベル `GUIDE`（Inter 700・30px・字間 .3em・#9a9a9a）
  - 題（Noto Sans CJK JP 900・80〜104px・行間 1.18・#f3f1ec）。2〜3行。絵にかからない大きさにする
  - 副題（500・40px・#c9c7c1）。記事の決め手の数字か名前（例：借りたGPUで学習・約579円）
- HTML は `<html lang="ja">`（日本の字形にする）。Playwright で書き出す
- **構図は並べたときにそろえない**（2026-11-15 エイイチ「全部同じ構図」）：題の位置を左上・右上・左下などで変える。右に置くときは絵を左右反転してよい（文字のない絵に限る）。作る前に `/guide` の一覧を見て、隣と同じ位置が続かないようにする
- トップのカード用（3:2、1800×1200）も同じ作り方（`public/site/guide-card.webp`）

### 出す前の確かめ
- 一覧（`/guide`）で3枚並べた画像を作って見る。字が絵にかかっていないか、構図が続いていないか
- ガイドのページの上と、SNS の画像（`og:image` が `.jpg`）に出るか

## 5. 公開の流れ

1. p2m-site の作業ブランチで作る → `npm run build` → 手元で画面を確かめる
2. 住所・転送を変えるときは codex のレビュー（依頼箱）を挟む
3. エイイチの「公開して」で main に入れる（Claude が勝手に main に入れない）
4. 本番で `/guide`・各ページ・転送・SNS の画像を確かめて報告する
5. 作った記録は、エイイチに番号とシリーズを確かめてから LOG（ひとり研究所の裏側）にする
