2026-10-22-01（Build mainly with Claude Code： 茶々入れ 2026-5）

案であって決定ではない。材料は台本第二稿・聞き取り02 の三本（本文と記録二本）・聞き取り01 メモの二節・refs/README・imozuru の印と見本・引き継ぎの未決と段取り 2-2。新しく探していない。「要相談」は決めずに両案を置いた所で、「寄り」はコードさんの傾き。

1. フォルダ構成

<置き場>/
  manuals/       … マニュアル本文。1 ファイル＝1 題材（聞き取り一本の出来上がり）
    <題名>.md
  records/       … 聞き取りの記録。1 ファイル＝1 回（弾）。索引は読まない
    <題名>/<日付>-<弾>.md
  reactions.md   … 引いた答えへの反応・渡す時の一言（追記のみ。§7）
  reader.html    … 読む側の 1 枚（生成物。手で直さない）

• 索引のコードに渡すのは <置き場> のパスだけ。読むのは manuals/*.md。フォルダ名は使う人が変えてよい（コードの引数にする。パスを決め打ちしない）
• 単位: ファイル＝題材、節＝索引の単位。ファイルは人が開く単位、節は検索が落とす単位（DITA の一話題一単位と OHMS の区切りごとの索引の折衷）
• 索引の生成物は reader.html に埋め込む（file:// で別置き JSON を読めないことが多い）。要相談: 人が読める中間物 index.json も並べて出すか。寄り: 最初は埋め込みだけ
• 記録は索引に入れない。記録には言い間違い・〔聞き手の整理〕・未確認がそのまま残っていて、検索に出すと答えに混ざる。記録へは本文から辿る（§5）

2. 設定欄（frontmatter）

台本の 6 項目を芯にして 3 つ足す。

---
title: 題名（話し手の言葉から。ファイル名と同じ）
created: 2026-10-19
updated: 2026-10-19
summary: 一文の要約
aliases: [別名, 読み手の言い方, 画面の文字]
questions: [こう聞かれたらこれを出す, …]
readers: [誰が読むか]
series: 一段大きいまとまりの名前
related: [似ているけど別の物の題名, …]
---

• 足した理由: series・related は締めの札「一段大きいまとまりは？」「似ているけど別の物は？」の答えの置き場。本文の節に書くだけでは機械で束ねられない
• 足さなかった物: 型（手順／仕組み／心得）… 混ざる題材が多く、索引が使わない／状態（下書き等）… 空欄の節（§3）で分かる／話し手名… 公開の可能性があるので既定にしない
• 独自ルールの余地: 上の項目以外は索引が無視する。使う人は好きな項目を足してよい（例: Obsidian の tags:。聞き取りの記録が既にそうなっている）。既定の項目の意味は変えない
• 書き方の縛り（§6 のため）: 1 行 1 項目、値は 1 行、一覧は [a, b]。項目の中に , を使わない（読点は 、）。- の箇条書きも許す（questions が 10 を超えると 1 行は読みにくい。1回目のネタは 11、再起動は 10。二号で採用・10-20 確定）

3. 本文の決まり

• # 題名 を 1 つ。節は ## 番号. 見出し。節の中の ### は許すが索引の単位にしない
• 節の粒度: 検索から直接飛び込まれて、前の節を読まずに分かる大きさ。手順なら一つの段、仕組みなら一つの部品、心得なら一つの教え
• 番号は改訂しても変えない。番号は順番ではなく名前（読む側の記録と反応が「題名＋節番号」でつながる前提）
  • 足す時: 未使用の次の番号。並びは番号順でなくてよい（途中に挟んでよい）
  • 消す時: 見出しを残して「（廃止。節 N へ）」の一行。番号を使い回さない
  • 割る時: 元の番号は片方が引き継ぎ、もう片方は新番号
• 節 0 は前提（推奨・番号固定）: 誰が読むか・いつ読むか・入口と出口・揃っている物（環境・道具・権限）・やらない条件（人に戻す所）・「分からなければ止まって聞く」の一文（読み手が本人なら「次にやる時に照らして直す」）。読み手に LLM が入る時は必須（台本 芯 5）。全体の流れ（段の一覧・順番の揺れ・依存）は節 0 の中に ### で含めてよい。手順の型ではそうして、段 N ＝ 節 N に揃える（聞き取りで呼んだ番号と本文の番号がずれない。10-20 二号）
• 最後の節は「空欄」（見出しの語を固定）: 埋まらなかった所の一覧。各行に節番号を添える。「後で埋める／空けたまま」の答えもここに
• 手順の節の中の順: 注意 → 指示 → 補足 → 済んだ合図（DITA・台本 芯 4）。行頭の札で書く
  • 注意: … その節で効く物だけ。節をまたいだら繰り返す。短く保つ（かさばる繰り返しは嫌われる）
  • 済んだ合図: … 何を見れば終わったと分かるか
  • やらない: … 節 0 にまとめず、効く節に置く時
• 解説（なぜ）は手順の流れを止めず、節の後ろか別の節へ。一文一義・三つ以上は箇条書き・読み手一人に能動で
• 文中の参照は見出しの言葉を先に、番号は括弧で後ろ: 「やらないこと（節 6）」「コミュニティプラグインの設定を開いてから Git の同期を見るまで（3-2〜3-5）」。数字だけ（「3-5 で落とした bot を 6-1 で」「（節 7）」）だと読み手が迷子になる（10-20 二号・本人の指摘）。機械が拾う形（§6）は括弧の中に残るので壊れない
• 手順の節の中の小段は、行頭に - N-M.（節 N の M 番目）を置いてよい（任意。索引は拾わない。人と反応の行が指すための名前。行頭の番号は迷子の元にならない、と本人）
• 任意の節（型が合う時だけ）: 「全体の流れ」（節 0 に含めてよい）／「やらないこと」／「段をまたぐ組」（離れた節どうしの依存・対。片方をやったらもう片方も要る）／「この日の構成」（使っている道具の一覧と日付。道具に依存する題材で、節ごとの日付の代わり）／「似ているけど別のもの」（related の説明）
• 仮と空欄の印（本文で必須・形を固定）: 〔仮: 理由〕 〔空欄: 何が無いか〕。理由が無い時も 〔仮〕 〔空欄〕。読む側が節ごとに「仮あり・空欄あり」を出せる
• 別名を本文に残す形: 話し手の言葉を本文で言い換えない（台本 芯 1）。正式な言い方を決めた時は初出で「正式（話し手の言い方）」と並記し、話し手の言い方は aliases にも入れる。要相談: OHMS のように節ごとのキーワード欄を置くか。寄り: 置かない（本文の言葉を全文検索で拾えば足りる。要るなら二周目）
• 読み手がしない段（相手・機械・他人が動く段）は、そう書いて短く済ませてよい

4. 出どころの印

• 出どころ（誰が言ったか）と確かさ（どこまで固まったか）を分ける。確かさの印は §3 の〔仮〕〔空欄〕
• 出どころの印は 記録では必須、本文では任意。本文の既定は書き手が責任を負う一つの声（一般の指針 4 本の側）。本文に残すのは話し手が望んだ時（わーさん流の列）
• 印。imozuru の〔論文〕〔本人〕〔観察〕〔まとめ〕〔公式〕は資料の種類の印なので、聞き取り向けに「話し手からの距離」の印に置き換える:

• 現行の記録は〔 〕＝聞き手で足りているので 聞き手: の頭は省いてよい。新しく足すのは〔伝聞〕〔資料〕だけ
• 本文に出す時は文末に 〔伝聞〕 〔資料: 名前〕。〔聞き手〕は本文に出さない（確かめて印なしにするか、〔仮〕にする）
• 〔資料: 名前〕は 10-20 の二号で本文に初めて出た（「誰が書きましたか」を聞いて、書き手・貼った人・日付が揃った）ので確定。〔伝聞〕はまだ出番がなく保留（手順の題材でも出なかった。仕組み・心得の題材で見る）
• 機械で読む分: 全部 〔…〕 の形。索引が数えるのは〔仮〕〔空欄〕だけで、他は人向け

5. 参照・シリーズ・似て非なる物

• 同じマニュアルの中: 本文に「（やらないこと、節 7）」のように見出しの言葉を添えて書く（§3）。読む側は「節 7」を節へのリンクにできる
• 別のマニュアルへ: [[題名]]。節を指す時は「[[題名]] の節 3」と言葉で。要相談: [[題名]] か [題名](題名.md) か。寄り: [[ ]]（Obsidian で開く人が多く、正規表現で拾いやすい。読む側は両方拾ってよい）
• 宛先は題名＝ファイル名。題名を変えると参照が切れるので、変える時は aliases に旧題名を残す。番号 ID は足さない（設定欄が増え、人が参照を書く時に引けない）
• 記録への参照: 本文の末尾に「記録: records/<題名>/」の一行（任意）。記録から本文へは記録の冒頭に [[題名]]
• シリーズ: series: に名前。シリーズ自体の案内が要る時は、同じ名前のマニュアルを 1 本書く（節 0 に子の一覧）。要相談: シリーズをフォルダにするか項目にするか。寄り: 項目（フォルダだと一本が二つのシリーズに入れない）
• 似て非なる物: related: に題名、違いは節「似ているけど別のもの」に一言。まだ書かれていない物は related に入れず、節の中に「（未作成）」

6. 機械で拾う所（実装は書かない）

• 索引の 1 件＝1 節。各件にファイルの設定欄（summary / aliases / questions / readers / series / updated）を写して持たせる（OHMS の区切りが題・要約・キーワードを持つ形）
• 文字コードは UTF-8（BOM があっても落ちない）。改行は LF でも CRLF でも

7. 改訂の余地（最小限）

• 日付は updated: だけ。履歴は置き場の仕組み（git・Obsidian の履歴など）に任せ、書式では持たない

• 反応の置き場: <置き場>/reactions.md に 1 行追記。読む側が 1 行の文字列を出し、人がコピーして貼る（サーバーなしの帰り道）

  - 2026-10-20 | 鯨がいない | Windowsが再起動された後にやるべきルーチン | 節 4 の 4-1 | 役に立った |
  - 2026-10-20 | IME 壊れた |  |  |  | 出なかった
  

  • 区切りは |。2 つ目は検索語（§10 の足す物。出なかった検索語はここだけ埋めて他を空にする）。4 つ目は「節 N」か「節 N の N-M」か空（機械は節番号だけ読む）。5 つ目は 役に立った／部分的／見当違い／渡した（渡す時の一言もこの行）。6 つ目は一言
  • 見直しの合図: 同じ題名・節番号に「部分的」「見当違い」が溜まった所から直す（KCS「使われることが見直し」）。引かれない節は直さない
  • 要相談: 反応を 1 ファイルに集めるか、records/<題名>/ に題材ごとに分けるか。寄り: 1 ファイル（追記先が一つ・索引が読む物が一つ）
  • 改訂で本文を直したら、空欄の節から消す・〔仮〕を外す・updated を直す。番号は触らない

8. 確かめ（1回目のマニュアルを当てた時）

合わない・足りない所（書式側で受ける）:

• updated series related が無い。「わーさんを甘やかすシリーズ」が aliases と節 11 に書かれている → series へ移す。似て非なる物は題名が無い → related は空、節 11 に「（未作成）」
• 仮・空欄の印の形がばらばら（〔仮〕〔仮。具体例は出ていない〕〔それ以上は空欄〕〔飛ばす時の見分けは空欄〕）→ 〔仮: …〕 〔空欄: …〕 に揃える
• 節 12「空欄」に節番号の無い行がある（「3・4・5 を飛ばす時の見分け」→ 節 1）
• questions が 11 個で 1 行 → - の箇条書きを許すか（§2 要相談）に関わる
• 読み手 LLM の「前提（どの環境でも同じか）」が節 0 でなく空欄の節に落ちている → 書式は空欄として正しく受けている
• 合っていた所: 節 1 の「（節 2）」の形／「注意:」が節 0 と節 9 で繰り返されている／節 2・8 が一行（読み手がしない段）／本文に出どころの印が無い（一つの声）／記録は〔 〕のみで〔伝聞〕〔資料〕の出番がなかった

1回目のネタ特有で、一般の決まりにしてはいけない所:

• 「主語は LLM です」「わーさん側のアクション」: 読み手が手を動かさない段がある、は手順一般にもあるが、その書き方（主語の明記）までは決めない
• 読み手が LLM 一人: 書式は人・複数の読み手も受ける（readers が一覧なのはそのため）
• 準備する物・助けてくれる相手・画面の文字が無い: 手順・仕組みの型では出る。節 0 と aliases に置き場はあるが、項目として強制しない
• 心得が多く手順が短い: 手順の型で「注意 → 指示 → 補足 → 済んだ合図」の順が効くかは、この題材では確かめられていない

9. 決めた理由

10. 本体の判定（2026-10-19・わーさん「幾つか回してみないと判断難しい」）

要相談 7 件は、コードさんの寄りのまま暫定で進める（回して決める。確定ではない）: 1 埋め込みだけ／2 - 箇条書きも許す／3 キーワード欄は置かない／4 〔伝聞〕は手順の題材で出番を見てから／5 [[題名]]／6 シリーズは項目／7 反応は 1 ファイル。

足す物（依頼文の漏れ）: §7 の反応の行に検索語の欄。構想メモ 2026-10-17-01-03（構想メモ・yobimizu 読む側の出来事の記録と改訂のきっかけ） の「出なかった検索語も一緒に残す」に合わせる。見当違い＝別名の不足を直すには、引いた語が要る。形は要検討（例: - 日付 | 検索語 | 題名 | 節 N | 反応 | 一言、題名以降は空でよい＝出なかった検索語の行）。

§8 の直しは、1回目のマニュアルに適用済み（updated・series・related の追加、aliases からシリーズ名を series へ、questions を - 箇条書きに、〔仮: 〕〔空欄: 〕の形に統一、空欄の節に節番号、節 11 に「（未作成）」、末尾に記録への参照）。これが見本の一号。

11. 確かめ（再起動ルーチンのマニュアルを当てた時・2026-10-20・本体）

見本二号。手順の型・読み手は本人・小段 22・資料あり。§8 と同じ形で。

合わない・足りない所（書式側で受ける）:

• 文中の参照が数字だけだと読み手が迷子になる（わかりやすさの確認で本人が指摘。「3-5 で落とした bot を 6-1 で」「4-2 から 4-5」「（節 7）」）。§3 の「（節 7）と書く」は機械の都合で、人の案内になっていない → 参照は見出しの言葉を先に、番号は括弧で後ろ（「やらないこと（節 6）」「コミュニティプラグインの設定を開いてから Git の同期を見るまで（3-2〜3-5）」）。機械が拾う形 節 ?(\d+) は括弧の中に残るので壊れない。行頭の小段番号（- 2-5.）は「残して問題ない」（本人）
• 段と節の番号がずれる。見本一号の慣例（節 0 前提・節 1 全体の流れ）だと段 N が節 N+1 になり、聞き取りで呼んでいた「2-5」が本文で「3-5」になった → 見本二号では「全体の流れ」を節 0 の中の ### に入れ、段 N ＝ 節 N に揃えた。§3「節 0 は前提」に「全体の流れを含めてよい（### で）」を足す。見本一号は節番号を既に使っているので触らない（番号は名前）
• 日付が要る所が「全部」の題材（道具に依存する手順。「オブシディアンを使わなくなればその部分は変わる」）。節ごとに日付を打つ形も updated 一つも合わない → 任意の節「この日の構成」（使っている道具の一覧と日付）を書式に足す。updated は残す（本文を直した日）。created と「この日の構成」の日付は別物になりうる
• 〔資料: 名前〕を本文で初めて使った（4-3。コードさんが書きわーさんが貼った 6/30 のメモ）。§4 の要相談「四種にするか」に実例が一つ。〔伝聞〕はまだ出番なし → 印は〔資料〕を先に確定、〔伝聞〕は保留のまま
• 小段の番号の形: - N-M. を行頭に置いた（節 N の M 番目）。§6 は拾わない（索引の単位は節）。人と反応の行が指すための名前として任意で許す。要相談: 反応の行の「節 N」に「節 N の N-M」まで書けるようにするか。寄り: 書けるようにする（文字列なので機械は節番号だけ読めばよい）
• 「観察」の段（話し手の動作でない段。2-3「常駐 bot もここで起動していることが多い」）: 「これはあなたがやることではなく、起きていることです」の一文で済ませた。§3「読み手がしない段はそう書いて短く」で受かる。印は要らない
• 「やる段」と「見る段」を話し手が自分で分けた（段 4）。本文では「補足: やる所は〜の二つ。他は確認で、飛ばしても害が少ない」。札にはしない（題材による）
• 塊に付く注意（3-2〜3-5 が丸ごと飛ぶ）: 注意は節の冒頭に一つで足りた。§3「注意はその節で効く物だけ」で受かる
• 合っていた所: 設定欄 9 項目（series・related を最初から使えた）／questions を - 箇条書き（10 件）／〔仮: 〕〔空欄: 〕の形／空欄の節に節番号／末尾に記録四本への [[ ]]／注意 → 指示 → 補足 → 済んだ合図の順が手順の型で素直に書けた（§8 で「確かめられていない」とした所）／任意の節「やらないこと」「似ているけど別のもの」に加えて「段をまたぐ組」を立てた（§3 の任意の節の例に足してよい）

再起動ルーチン特有で、一般の決まりにしてはいけない所:

• 環境情報（パス・コンテナ名・モニター三枚・プログラム名）が本文に入る。置き場が本人の保管庫なので問題ないが、リポの見本にする時は合成に置き換える（AGENTS.md の禁則）。置き換えても「この日の構成」の形が残るかが、見本として出す時の見所
• 「鯨」「ポコポコ」「オーバーサイズ」は話し手の言葉。aliases と本文に残したが、書式はこれを強制しない（台本 芯 1-5 の結果）
• 読み手が本人一人で芯 5（LLM 読み手）を使っていない。「分からなければ止まって聞く」の代わりに「次に再起動した時に照らして直す」を節 0 に置いた。読み手が本人の時の節 0 の形として一例

12. 暫定 7 件の見直し（2026-10-20・本体。二号を当てた後）

新しく足す物（§11 から）: 文中参照は見出しの言葉を先に／節 0 に全体の流れを含めてよい（段＝節）／任意の節「この日の構成」／〔資料〕の確定／小段番号 N-M. を任意で許す／任意の節の例に「段をまたぐ組」。どれも案。茶々入れ係に見せる前に、わーさんが一度読む。

→ 2026-10-20 夜、わーさん了承済みで §1〜§7 に畳み込み済み（§2 箇条書き確定・updated の但し書き／§3 節 0 に全体の流れ・段＝節・参照は言葉先・小段番号・任意の節に「段をまたぐ組」「この日の構成」／§4 〔資料〕確定・〔伝聞〕保留／§5 参照の形／§7 反応の行に検索語と小段）。§8〜§12 は経緯として残す。次に直すのは茶々入れ係の指摘が来てから。