00
001

教材は1ファイルに書くな

スクール教材パッケージの設計図

README / slides / onepager / kit の役割を先に固定する

KIDO · Cloudcode · school-ops · 下書き(公開未確認)

注意

これは型の教材であり、転載ではない

共感

長文1本で終わると、全部つらくなる

痛みはネタ不足より、「どのファイルに何を書くか」が無いこと。

重要性

役割を先に決めると、量産できる

宣言

今日決めるのは中身ではなく器

ネタ出しはしない。

TL;DR

3行で足りる

  1. 正本は README。slides と onepager は同じ事実の別密度
  2. 特典は kit。本文は「受け取ると何が変わるか」だけ
  3. AIには章立てと確度マークを先に渡す
成功条件

15分後にできること

  1. 4ファイルの役割を説明できる
  2. 自分のテーマで README の章を埋め始められる
  3. kit に逃がす基準を1つ言える
目次

このデッキの順

  1. 役割の比較
  2. 正本ファースト
  3. kit の境界
  4. AIへの引き渡し
  5. 15分の手順
  6. FAQ と CTA
見取り図

基本は3ファイル。特典は任意

README

正本。検索と改訂の置き場

slides.html

画面共有用。1枚1メッセージ

このデッキ自身が例。操作は ← → または Space。

onepager.html

あとで読む1枚

kit / present

特典は本編の外

比較

何を書き、何を書かないか

ファイル書く書かない
README手順・確度・出典プロンプト全文
slides見出し・短文長文の丸移し
onepagerTLDR・表・FAQ調査ログ
kit雛形・チェック本編の再掲
判断

毎回4つ全部はいらない

正本ファースト

slides から書くと事実が削れる

書く順

出典 → 見出し → README → 短くする

  1. sources.md に URL と確度
  2. OUTLINE を承認
  3. README
  4. 同じ主張だけ slides / onepager へ
確度

印を消さない

印意味
✅公式か自リポの分析で確認
🔶一次情報はあるが変わり得る
⚠️未確認。手順にしない
kit の基準

再利用するものだけ外へ

境界

貼った瞬間、次回更新が地獄になる

特典の全文を README に埋め込まない。

この回の3枚: episode-checklist / readme-outline-template / pages-publish-checklist

AI 引き渡し

4段だけ固定する

  1. PLAN を渡す
  2. 見出しを人間が承認
  3. school-material-builder で一式
  4. 人間が公開前チェック。スキルは公開しない
固定する指示

崩れると型が崩れる3つ

文体の細目より、この3つを先に書く。

15分

空フォルダの骨格だけ

  1. 4ファイル(中身は空でよい)を作る
  2. README に TL;DR 3行
  3. kit へ逃がすものを3つメモ
  4. 承認チェックは未決のまま残してよい
コマンド

school-ops の中で

THEME=002-your-theme
DIR=materials/original/$THEME
mkdir -p "$DIR/kit"
cd "$DIR"
touch .nojekyll README.md slides.html onepager.html

原稿時間は含まない。器だけ。

FAQ

onepager だけでは足りないか

配信と復習で最適な密度が違う。

FAQ

キット無しで公開してよいか

よい。特典は後から足せる。

ただしこの #001 は下書き。Pages も配布もしない。

FAQ

他の公開教材を下敷きにしてよいか

未確認

断定しないもの

今日から

15分で止めてよい

  1. 次回テーマで4ファイルの要不要を書く
  2. TL;DR を3行書く
  3. kit に出すものを3つメモ
  4. 公開可否は決めない
CTA

器が先。公開はあと

原稿完了・公開未確認 · 2026-10-03