1章

これは何をするアプリか

ツェッテルカステン（Zettelkasten）は、ドイツの社会学者ルーマンが使っていた紙のカード式ノート術です。読んだものをそのまま溜めるのではなく、自分の言葉に直して、既にある考えのどれかに結びつけて初めて保管する、という決まりが核にあります。このアプリは、その決まりを守る作業を画面で助ける道具です。

3種類のノートの関係

問題は、入り口の Literature Note だけが溜まり続けることです。行き先を決める作業は面倒で、後回しになります。このアプリは「行き先が決まっていないノート」だけを取り出して1件ずつ目の前に置き、Tag → ABC Note の順に決めさせ、決まったらNotionに書き戻すという、その1点のためだけに作られています。

使う人の流れ（受信箱の画面）

1. 左側に、まだ行き先が決まっていないノートの列が並ぶ。上から1件選ぶ。
2. 中央にそのノートの本文が出る。アプリが4文だけ抜き出した要点も一緒に出る。Xの投稿ならその投稿がそのまま表示される。
3. ステップ01：観点となるTagを選ぶ。おすすめが上位10件、最初から並んでいる。
4. ステップ02：選んだTagの下にあるABC Noteを選ぶ（最大9件が並ぶ）。適当なものが無ければ、その場で新しいABC Noteを作ることもできる。
5. 自分の言葉でコメントを書く。ここは省略できない。空欄では保存ボタンが押せない。
6. 保存すると、Notionの3か所が同時に書き換わる。列から1件消え、次のノートが出てくる。

2章

全体像を1枚の図で

図1　全体像。色の濃い枠は出入口とNotion、オレンジの枠は書き込みに関わる担当。
①玄関番は、この図のすべての矢印の手前に立っています。そしてこの図の中に、AIを呼びに行く矢印は1本もありません。

3章

用語ミニ辞典（この先で使う言葉）

この先の説明は、なるべくこの18語だけで書いています。分からなくなったらこのページに戻ってください。

窓口に仕事が持ち込まれるたびに、「この人はサインインしているか」だけを確認する担当。していなければ、その先の担当者は誰も動きません。

あなたのブラウザ ──[依頼：住所＋本文]──▶ 貸倉庫の入口 《ここで身分の札を貼る》
        └──[依頼＋札]──▶ ① 玄関番 ──[通過]──▶ ③〜⑮の担当 ──▶ Notion
                              └──[401＋日本語の断り]──▶ 画面に赤字

インターネットから届いた依頼を最初に受け取り、金庫から鍵を出して中の担当者に渡し、返事を送り返す担当。このアプリで「サーバー」と呼べるものは、実質この61行です。

インターネット ──[依頼]──▶ ② 配達係
   《1.道具箱を受け取る → 2.鍵を詰め替える → 3.行き先で仕分ける》
     ├─[住所が /_vinext/image]──▶ 自分で画像を縮める ──▶ ブラウザ
     └─[それ以外]──▶ ① 玄関番 → 各担当 ──[画面 or データ]──▶ ブラウザ

画面を開いた瞬間に走り出し、その日の仕事に必要なものを3つまとめて運んでくる担当。「未処理ノートの列」「Tagの全一覧」「ABC Noteの全一覧」です。

画面を開く ──▶ ③ 仕入れ係 ──[3セットの問い合わせ]──▶ Notion
   《1.未処理ノート  2.Tag全件  3.ABC Note全件／各100件ずつ手繰る》
   ──[3つを1つにまとめたJSON]──▶ ⑨画面係・⑦⑧の点数計算へ
   （取ったものは30秒だけ手元に保存。保存が成功したら即破棄）

列から1件選んだ瞬間だけ動き、そのノートの本文を取ってきて、ただの平たい文章に均す担当。1件ずつしか運ばないのは、全部を先に運ぶと遅くて重いからです。

1件を選ぶ ──[ノートID]──▶ ④ 取り寄せ係 ──[本文の部品を100個ずつ]──▶ Notion
   《飾りを捨てて文字だけにする／1万2千字で打ち切る》
   ──[平たい文章＋「切りました」の印]──▶ ⑤要約係・⑦⑧の点数計算・画面

本文から4文だけを選んで並べる担当。文章を新しく書くことはしません。もともとあった文の中から選ぶだけです。ここがAIの要約との決定的な違いです。

④の本文 ──▶ ⑤ 要約係 《あなたのブラウザの中。どこにも送らない》
   1.ゴミ行を捨てる → 2.文に切る → 3.点数を付ける → 4.4文選ぶ → 5.元の順に戻す
   ──[最大4文・560字。すべて元の文そのまま]──▶ 画面の「要点」欄

ABC Noteの候補が画面に並んだら、その中身をこっそり覗きに行って「主な章・論点」の一文を作る担当。名前だけでは「どっちの棚だったか」を思い出せない、という問題を解くためにいます。

候補9件が画面に並ぶ ──[IDを最大9件]──▶ ⑥ 下見係
   ──[3件ずつ・間に0.9秒]──▶ Notion ──[各ノートの見出しと段落]──▶
   《大見出し＝章、中見出し＝論点として一文に組み立てる》
   ──[220字の紹介文＋点数用の本文6千字]──▶ 画面の説明文／⑧の材料（6時間保存）

数十件のTagから、いま開いているノートに合いそうな10件を選んで上に出す担当。このアプリの「賢さ」の半分は、この30行ほどの計算式です。

題名＋書きかけのコメント＋本文 ──▶ ⑦ タグ推薦係 《ブラウザの中で計算・外に出ない》
   全Tagに点数（名前の一致・破片の重なり・使用回数・整理用タグは減点）
   ──[高い順に上位10件]──▶ 画面のステップ01

Tagが決まってから動く担当。まず選ばれたTagの下だけに候補を絞り、それから点数を付けるという二段構えが肝です。この順番のおかげで、数百件が数件になります。

Tagが決まる ──▶ ⑧ ABC推薦係
   1.そのTag直下だけに絞る（親Tagがちょうど1つ、かつ今のTag）
   2.名前で点数 ──[上位9件]──▶ ⑥下見係へ「中身を見てきて」
   3.中身が届いたら もう一度点数 ──[並べ替え]──▶ 画面のステップ02

あなたの目の前にあるもの全部の担当。列、本文、要点、2つのステップ、コメント欄、保存ボタン。そして⑦⑧の点数計算も、この中（＝あなたの端末の中）で走っています。

③〜⑧のデータ ──▶ ⑨ 画面係 《あなたのスマホ／PCの中》
   列 ／ 本文 ／ 要点 ／ ステップ01・02 ／ コメント欄 ／ 転記イメージ
   ──[題名・コメント・Tag・ABCが全部そろった時だけ]──▶ 保存ボタンが押せる
   ──[1回のまとまった依頼]──▶ ⑩門番へ

保存ボタンが押されて最初に会う人。届いた中身を1項目ずつ点検し、1つでもおかしければNotionに触る前に突き返します。

⑨から ──[JSON：ノートID／Tag／ABC／題名／コメント]──▶ ⑩ 門番
   形・件数・字数・「同時指定の禁止」を点検
     ├─[NG]──▶ 400番＋日本語の断り ──▶ 画面（Notionには触れていない）
     └─[OK]──▶ ⑪ 現場監督へ

実際にNotionを書き換える一連の作業を、順番どおりに、辻褄が合っているかを確かめながら進める担当。このアプリで一番神経を使っている場所です。

⑩から ──▶ ⑭整理券を取る ──▶ ⑪ 現場監督
   1.本人確認（本当にその表のページか）  2.まだ未処理か  3.選んだTagの子か
   4.（新規なら）ABC Noteを作る ──▶ ⑫追記係 ──▶ ノート本体を更新 ──▶ ⑬検算係
   （途中で失敗したら、その回に作ったものは⑬がゴミ箱へ戻す）

ABC Noteの本文の「その他」という見出しの下に、今回の1件を差し込む担当。差し込む形は決まっていて、見出し（題名）＋元ノートへのリンク＋あなたのコメントの3点セットです。

⑪から ──[ABC ID／ノートID／題名／コメント]──▶ ⑫ 追記係
   「その他」を探す ──2つ以上あった──▶ 中止して人に相談（409）
        ├─[同じリンクが既にある]──▶ 足さずに書き換える
        ├─[本文の奥に隠れていた]──▶ 何もしない
        └─[無い]──▶ 「その他」の最後に 見出し＋リンク＋コメント を差し込む

書き終わった後でもう一度Notionから読み直し、頼んだとおりになっているかを1項目ずつ突き合わせる担当。合っていなければ、成功とは言いません。

書き込み完了 ──▶ ⑬ 検算係 ──[もう一度読む]──▶ Notion
   照合：題名／コメント／Tagの本数／ABCの本数／選んだ番号がすべて含まれるか
     ├─[全部合う]──▶ 成功 ──▶ ③のキャッシュを破棄 ──▶ 列から1件消える
     └─[1つでも違う]──▶ 502で失敗（列から消さない）＋新規作成分はゴミ箱へ

姿は見えませんが、⑪〜⑬の全体を外側から包んでいる担当。同じノート、同じABC Noteへの作業が、絶対に同時に走らないよう一列に並べます。

⑪〜⑬ の全体を、外から包む
   同じノートID への作業 ──▶ [列1] ──▶ 1件ずつ通す
   同じABC ID の本文書き換え ──▶ [列2] ──▶ 1件ずつ通す
   （前の人が失敗しても、列は必ず前に進む／効くのは"いま動いている小部屋の中"だけ）

もう1つの画面「全体マップ」の担当。3つの表を全部読み直して木の形に組み立て、「取りこぼし」を数えます。書き込みは一切しません。

/map を開く ──▶ ⑮ 集計係 ──[3つの表を全件]──▶ Notion
   木を組む：Tag → ABC Note → Literature Note
   数える：埋没（棚止まり）／サブ埋没（線だけ）／要確認（親が0か2つ以上）
   ──[木＋13種類の集計値]──▶ 画面（5分保存）
   「サブ埋没」ボタン ──[最大3件]──▶ 探偵が本文の奥を潜る（30分保存）

5章

1回の流れを時間軸で追う

「1件を仕分けて保存する」あいだに、誰がいつ動いているか。左から右へ時間が流れます。

図2　1件を処理する間の時間の使われ方。薄緑はあなたのブラウザの中だけで完結する仕事。

同じ流れを、言葉で追う

1. 画面を開く。①が身分を確かめ、③が3種類の一覧をまとめて取ってきます。ここが一番待つ場面（Notionへの問い合わせが3セット）。
2. 1件選ぶ。④が本文を取りに行き、届いた瞬間に⑤が4文を抜き、⑦がタグの点数を計算して10件を並べます。⑤と⑦はネットに出ないので一瞬です。
3. Tagを選ぶ。⑧が候補を9件に絞り、⑥がその9件の中身を見に行きます。戻ってきたら⑧がもう一度計算して並べ替えます。
4. コメントを書く。1文字打つたびに⑦⑧が計算し直すので、書いているうちにおすすめの順番が変わります。あなたの言葉が、そのままヒントとして効いています。
5. 保存を押す。⑩が形を点検→⑭が整理券を発行→⑪が本人確認と処理済みチェック→（新規なら作成）→⑫が本文に追記→ノート本体を更新→⑬が読み直して照合。ここまで全部成功して初めて「保存しました」と出て、列から1件消えます。

6章

AIを使う所と、使わない所

では、何がこのアプリを賢く見せているのか

AIはどこにいたのか

1か所だけあります。このアプリ自体が、ChatGPTを使って作られ、ChatGPTのサイト置き場に公開されていることです（住所が ...chatgpt.site なのはそのため）。つまりAIは「作る時」と「置き場所」には関わっているが、「動いている時の判断」には一切関わっていない。この線引きが、このアプリの性格を決めています。

この設計の良いところと、限界

7章

間違いを起こさない5つの工夫

相手（Notion）は別のサービスで、途中で通信が切れることも、他の端末から同時にいじられることもあります。その前提で置かれている備えが5つあります。

工夫1　同じ規則を、二重に守らせる

「既存を選ぶ」と「新しく作る」を同時にできない、という規則は画面（⑨）でも、窓口（⑩）でも、現場（⑪）でも点検されます。画面だけで守ると、窓口を直接叩かれた時に破られます。窓口は画面を信用しない――これはWebアプリ全般の鉄則です。

工夫2　書いた後に、読み直して突き合わせる

⑬の仕事です。「保存できました」という返事ではなく、実際にNotionに残っている中身を見て成否を決めます。合わなければ失敗として扱い、ノートを列から消しません。取りこぼしよりも、取りこぼしに気付かないことのほうが怖いという判断です。

工夫3　途中で失敗したら、作ったものを消して戻す

新しいABC Noteを作った直後にエラーが起きた場合、そのABC Noteをゴミ箱へ移してからエラーを返します（ロールバック）。中途半端な残骸は、後から見ると原因が分からなくなるためです。

工夫4　「もう処理済みのもの」には手を出さない

保存も削除も、最初に必ず「まだTagもABC Noteも付いていないか」を確認します。付いていれば、そこで止めて「画面を更新してください」と伝えます。Notionアプリ側で先に手を付けていた時に、上書きしてしまう事故を防ぎます。

工夫5　決めていいことと、そうでないことを分ける

⑫追記係は、「その他」の見出しが2つあると作業をやめて人に相談します。機械が推測で片方に書き込めば、後から探せなくなるかもしれない。迷ったら止まるほうが、直す手間が小さいという判断です。

8章

データはどこに、どう置かれているか

置き場所の一覧

なぜ自前でデータを持たないのか

• 二重管理をしないため。アプリにも控えを持つと、Notion側で直した時にどちらが正しいか分からなくなります。
• Notionで直接いじっても壊れないため。Notionアプリ側で手作業でTagを付ければ、このアプリの列からも自然に消えます（③のとおり「線が無い＝未処理」だから）。
• このアプリが無くなっても、知識はNotionのページとして残るため。

そのかわり必要になるのが「作り置き」

毎回すべてをNotionに取りに行くと遅く、相手にも負担がかかります。そこで4種類のキャッシュを使い分けています。

9章

どうやって動き、外からどう使えるのか

置き場所は、ChatGPTが用意したWebサイト置き場

住所は zettelkasten-inbox-ak.akuramochi.chatgpt.site。前半がアプリ名、後半があなたの作業場の名前です。ChatGPTが提供しているサイト公開の仕組みに置かれ、実際の実行はCloudflareという会社の設備の上で行われます（②配達係が動く場所）。自宅のPCの電源が落ちていても動きます。

鍵の置き場所

• Notionのキーは、プログラムの中には書かれていません。置き場所側に預けた環境変数として保管され、②配達係が依頼のたびに金庫から出します。このプログラムを丸ごと他人に見せても、Notionは開けません。
• 3つの表の番号も同じ仕組みで差し替えられます（置き場所側の設定が優先）。
• 入口の鍵はChatGPTのサインイン。サインインすると、置き場所が依頼に身分の札を貼ります。①玄関番はその札だけを見ています。

外から使える窓口は7つだけ

書き込みができる窓口は2つだけ。窓口を絞ってあること自体が、安全の一部です。

使っている道具

10章

品質を保つ仕組み

自動テスト8本

「直したつもりが別のところを壊す」を防ぐため、プログラムを別のプログラムに検査させる仕掛けが8本あります。しかもその多くが、Notionの偽物を用意して本物に触れずに検査しています。

もう1つの品質：エラー文が全部日本語

Notionから返る英語のエラーは、すべてその場で日本語の説明に置き換えられてから画面に出ます。「401」ではなく「Notion APIキーが無効です」、「404」ではなく「対象のNotionデータベースが連携に共有されていません」。自分ひとりで使う道具でも、半年後の自分は他人だという考え方の表れです。

11章

弱いところと、これから選べる道

欠陥という意味ではなく、「今はこう割り切ってある」という設計上の選択と、その代償を並べます。

外部への依存

• Notionが止まれば、何もできません。読むことも書くこともできず、手元に控えもありません（8章のとおり意図的にそうしています）。
• Notionの受付窓口の仕様が変われば、影響を受けます。版数を指定して使っているので急には壊れませんが、いつかは追随が要ります。
• 混雑時の待ちは、実際に起こりえます。特に全体マップは全件を読むので重く、ノートが増えるほど時間が延びます。

作りの上での割り切り

• 作り置きは、その瞬間動いている場所の中だけ。②のとおり動く場所は毎回変わりえるので、同じ操作でも速さが揺れます。
• 整理券（⑭）も、その場所の中だけ。2つの端末から同時に同じノートを保存した場合、整理券では防げません。「もう処理済みか」の確認と保存後の読み直しが最後の砦です。守りはあるが一本ではない、という状態。
• 本文の追記先が「その他」で固定。内容にふさわしい章に振り分けることはしません。人が後で移す前提です。
• 「埋没」「サブ埋没」を見つけても、直すのは手作業。マップは指摘するだけです。
• 入口の身分確認は「サインイン済みか」だけ。置き場所の公開設定が変わると意味が変わります（①）。
• 名前が3通りある。Notion上は「🧠 Zettelkasten DB」、プログラム内では「permanent（永久）」、画面では「ABC Note」。同じものです。

もし次に手を入れるなら（優先度順の一案）

付録

この資料の言葉と、実際のファイルの対応

実物を開いて確かめたい時のための対応表です。すべて C:\Users\aky_m\Scripts\zettelkasten-inbox\ の下にあります。

Notion側の名前の対応

決め打ちされている上限の一覧

最後に

3つだけ持ち帰るなら

※ この資料は、2026年8月10日時点の zettelkasten-inbox のプログラムを1行ずつ読んで作成しました。
※ 「担当者」という言い方はこの資料の説明のための呼び名で、プログラム内にその名前が付いているわけではありません。対応は付録の表のとおりです。
※ 数値（点数の重み、上限、作り置きの時間）はすべて実際のコードから取った値です。プログラムを直せば、これらの数値も変わります。