カードを書いてもらう

アプリから渡すプロンプト（iOS）

iOS 版の設定 →「使い方（カードの書式・AIに作ってもらう）」に、AI エージェントに渡すプロンプトを組み立てる欄があります。学びたいテーマを入れてコピーし、Claude や ChatGPT に貼るだけです。

プロンプトには書式そのものは書き写さず、仕様書を読ませる指示が入っています（書き写すと、アプリの出荷サイクルでしか直せない写しが増えて必ず古くなるため）。GitHub への書き込み権限を持つ AI エージェントなら、そのままコミットまで頼めます。

同じプロンプトは、分野を増やしたいときにも何度でも使えます。

この画面は iOS 版だけにあります。Mac / Android から始めるときは、書式の仕様書（英語・正本）か、このドキュメントのカードの書式を AI エージェントに読ませてください。

書式の一式は公開しています。

リポジトリの作り方

• リポジトリは公開・非公開どちらでも構いません（非公開のほうが普通です）
• カードは1つ以上のディレクトリの中に置きます。置き場所は自由で、デッキは deck: が決めます
• リポジトリの一番上に AGENTS.md / CLAUDE.md を置き、「カードの書式はこの仕様書に従う」と書いておくと、次に別の AI エージェントが触るときも書式を読み直してくれます（雛形をそのまま使えます）
• 市販教材の OCR や音声のような端末に落としたくない素材は _references/ のように _ で始まるディレクトリに入れます。同期の対象外になります

よいカードの書き方

書式が通ることと、覚え直しに効くことは別です。指針は7つです。

• 1枚が問うのは1つだけ。 答えが独立した半分に割れるなら、それは2枚です。id と履歴が付く前に決めます
• まとめて言えないと意味がない集合は、裏がその集合である1枚にします。単体で思い出せる事実は1枚ずつにし、共通の前提は ask: false のカードに置いて参照します
• 参照は、同じ文が3枚以上に必要なときだけ使います
• 表はそれだけで答えられる形にします。「標準偏差」は題目、「標準偏差は平均だけでは分からない何を教えるか」が問いです
• 出典は補足に書きます。 辿れない事実は確かめられません
• 本文は学ぶ言語で書きます。英語なのはキーとマーカーだけです
• 問いの中身を変えるのは新しいカードです。新しい id を作り、古いファイルは人が消します

検査で落として直させる

vault は機械で検査できます（lint・規則はカードの書式）。エラーが1件でもあれば終了コード 1 で落ちるので、「AI が書く → 検査が落ちる → AI が直す」の輪を、アプリを開かずに CI の中だけで回せます。

カードがテキストであることの利点がそのまま出る部分です。バイナリ形式のカードでは、中身を CI で検査できません。

復習中に気づいた誤りを直す

学習中に「この説明はおかしい」と思ったら、その場で直しに回せます。

1. 復習画面またはカード画面のコピーを押す（渡されるのはカードの ID だけです）
2. iPad / Mac の Split View で隣に置いた AI エージェントに貼る
3. AI エージェントが同じリポジトリを開き、その id のカードを直して PR にする
4. 変更（PR）タブで直った本文を読み、問題なければマージする
5. 次の同期で手元に降りてくる

なぜ本文ではなく ID だけなのか。 隣の AI エージェントは同じリポジトリを読めるので、どの札かさえ言えれば本文は向こうで引けます。全文を貼ると、貼った側と手元のどちらが新しいか分からなくなり、古い本文を直させることが起きます。

まとめて渡す

• さがすタブの「苦手をまとめてAIに渡す」：忘れた回数の多い順に最大10枚を、本文と出典パス付きでまとめてコピーします（iOS / Mac）
• セッションを終えた直後の「このセッションをAIに共有」：その日つまずいたカードだけをまとめて渡します（iOS）
• 同期のたびにアプリが data/insights.json（弱点の一覧）をリポジトリへ書き出すので、クリップボードを使わなくても、AI エージェントがリポジトリを開くだけで「いま何が苦手か」を読めます

まとめて渡すときだけは本文が付きます（まとめて直させるには本文が要るため）。参照は展開せず、参照先のカードを別ブロックで添えます。直す先が別のファイルだからです。展開して1枚に混ぜると、AI エージェントが「参照先の本文を問題カードに書き足す」直し方をしてしまい、1か所にまとめてある意味が消えます。