seed — Claude と一緒に種を播く

利用マニュアル — seed

書いた日: 2026-11-02。使う人(自給したい人、テスター)のための手引き。画面や手順を変えたら、末尾の「変更の記録」に日付付きで書く。仕組みの側は 設計書.md、ファイルの中身は 記録の形.md。

1. seed は何をする物か

すべては畑の写真を撮ることから始まる。記録を置くフォルダーを、このマニュアルではプロジェクトフォルダー(記録のフォルダー)と呼ぶ。アプリの上の端に、その名と、変えるためのフォルダーの印が出る。自分の畑が無くてもよい(§5)。畑の写真(座標入り)を自分の Claude に渡すと、読みが戻る。あなたは読みに合う/違うを付ける。選んだ行を公開でき、公開された記録で人と繋がる。座標から引く地形・土壌・筆の資料の行(data)は、照会の部品([lookup])を入れた PC か、サーバーで引く(§3、§5「この土地」)。この PC の Claude Code は写真を読むだけで、照会はしない(§6.1)。

seed が持ち込む物は、生物学・気象・地質の読み(出典付き)で、農業のやり方ではない。気象の章(手引き 03)は、気象庁の平年値と天気の害の資料の入口と、記録の気象の行の読み方です。気象の実績は weather/<月>.md に残る(§5「気象の記録」)。

事実は三つだけ。 出典付きの data 行、あなたの言葉の record 行、あなたの判定(合う/違う)。AI の行は、言い切りの形でも仮説で、確からしさ [0.00〜1.00] が付く。

しないこと: - 「こうしなさい」とは言わない。読みは、何が見えて、何に拠るか、次に何を見るとよいか、まで。判定の形の文(〜すべき)は uncertain に落とされる。Claude の行は仮説で、合っていたかは次の季節の畑に出ます。 - 記録を預からない。記録(写真と座標を含む)はあなたの PC の ~/seed/ に残る。座標はこの作業に必須で、記録から外さない。人に見える所に出るのは、あなたが了解した行だけ(§9)。 - 売買と伝言の仕組みは持たない。繋がった後の会話は Discord で。

2. 要るもの

使い方 要るもの
畑を観察する Python 3.11 以上と git の入った PC(Windows / macOS / Linux)。読みは、この PC の Claude Code(claude コマンド。入れ方は https://claude.com/claude-code 。Pro 以上のサブスクでログイン。API キーは不要)か、自分の Claude に手で頼む(§6)。外のサーバーで読む道もあるが、今は準備中(§4)。地形・土壌・筆の資料の行は、照会の部品 [lookup] を入れるとこの PC で引ける(§3)
写真 位置情報(GPS)の入った写真。一枚でも、歩きながら何枚でも
スマートフォン Android か iPhone。seed のアプリはストアに無く、PC で作って入れる(README「スマートフォンで試す」、iPhone 版.md)。撮る画面には、カメラと位置を使う許しが要る(§11b)
スマートフォンから PC へ送る PC とスマートフォンが同じ Wi-Fi にあること。PC に [server] の部品と Claude Code(§11b)
畑 無くてよい。気になる耕作放棄地を道から撮れば、候補地として観察できる(§5)
公開・一言・サーバーで読む 招待コード(Discord「AI と一緒に自給農」で渡す)。この PC の Claude で読むだけなら要らない。家の PC に送る時の 6 桁の招待コードは、これとは別の物で、PC の seed home が出す(§11b)

詰まった所は Discord か Issues へ(§12)。

3. 入れ方(自分の PC)

GitHub から取って入れます。PyPI には今は出していません。いいアプリが出来たら上げます(例: 同じ作者の fieldnotes-farm https://pypi.org/project/fieldnotes-farm/ )。アプリのストアには出しません。自分の物にするにはフォークします(§11「機能は自分で足す」)。動かし方(seed app、flet run)は README の「使ってみる」にある。スマートフォンで試すのは、USB で繋いだ Android に flet devices で出る番号を渡す flet debug android --device-id <番号> --arch arm64-v8a。アプリにして入れるなら flet build apk --arch arm64-v8a で出来る build/apk/seed-farm.apk を入れる(どちらも PC に Flutter と Android Studio が要る。README の「スマートフォンで試す」)。iPhone は Mac で作る(iPhone 版.md)。

git clone https://github.com/aiseed-dev/seed.git
cd seed && python -m venv .venv && .venv/bin/pip install -e ".[app]"

venv を有効にする(ターミナルを開くたびに一度)。macOS / Linux:

source .venv/bin/activate

Windows:

.venv\Scripts\activate

有効にした後は、コマンドは seed でよい(以下もそう書く)。有効にしないなら .venv/bin/seed(Windows では .venv\Scripts\seed)。足す物(extra)は使うときだけ:

extra 中身 何に
[app] Flet 1.1.0、Pillow、httpx、pillow-heif ほか アプリと写真。ふつうはこれ。iPhone の HEIC も読める
[origin] Pillow、httpx、imageio-ffmpeg seed origin の mp4。無ければ GIF になる
[grow] Pillow、httpx、resvg-py seed grow --draw(図を PNG にして絵に)
[heic] pillow-heif HEIC だけ要るとき
[server] FastAPI、uvicorn など seed home(スマートフォンから PC へ送る。§11b)。サーバーを動かす人も
[lookup] fieldnotes-farm 0.2.0 座標から土地の資料の行(地名、筆、標高、地形、地質、災害の区域、土、史跡)を、この PC で引く(§5「この土地」)
seed init

seed init は ~/seed/ と設定 ~/seed/seed.toml を作り、公開のための乱数(token)を決め、手引きを ~/seed/skill/ に写す。場所を変えるなら --folder <道>(環境変数 SEED_FOLDER でも)。招待コードがあれば --invite CODE、後からでも seed invite CODE。サーバーを置く人は、渡したコードの一覧を seed invite --list --invites /etc/seed/invites.toml で見る(呼び名とコードの先頭 4 桁だけ)。失効は invites.toml からその行を消すだけで、再起動しなくても次の要求から効く。

seed init はディスクの空きを測って見せ、どれだけ残すか(keep)を出す。観察一回(写真 10 枚)の目安は、text(写真は読み用の長辺 2,000 px。座標は残る)約 5 MB、photos(既定。写真を元の大きさの JPEG で)約 80 MB、research(さらに写真の元 originals/ と読みの生の出力 observations/<id>.raw/)約 120 MB。seed init --keep research か、後から seed keep research。写真の元を別の盤に置くなら --bulk <道>(--bulk "" で外す)。上げるのは自由、下げても何も消えない。消すのは seed prune(何を何 MB 消すかを見せ、y と答えたときだけ。--yes で聞かない)。詳しくは 記録の形.md §11。

4. Web で見る(seed.aiseed.dev)

seed.aiseed.dev は開いています。Claude の読み取りと話すは準備中で、公開された記録は読めます。入口に公開された記録の一覧と件数が並び、記録を開くと、その人が選んで公開した行と写真(位置の情報を外した物)が読めます。一言はアプリの「話す」から送ります(§8)。Web は説明と公開された記録を置く所で、アプリの Web 版はありません(seed app --web は、この PC のブラウザで画面を確かめるための物です)。使い方は https://seed.aiseed.dev/manual でも読めます(このマニュアルと同じ物です)。

外のサーバーが開くまで、それを使う所(サーバーで読む、ほかの人の畑、一言、取り下げ)は「サーバーに届きません」で止まります。家の PC の seed home(§11b)は外のサーバーとは別の物で、今も使えます。

5. 自分の PC で

seed app

アプリは PC 版とスマートフォン(iPhone、Android)。上の端に、プロジェクトの名と小さな印が並ぶ。左から、歯車(設定のフォーム。PC と繋ぐ、読む所、自分の鍵。§6、§11b)、フォルダー(プロジェクトフォルダーと畑を変える)、話す(Claude とのやり取り)、写真(この畑の写真を全部)、同梱の画面 この土地、手続き、天気、自分で足した画面(§11)。サーバーの管理は、このアプリではなく kagi の机の画面「人の出入り」から(§11c)。

「話す」は、Claude Code の画面のように、上から下へやり取りが並ぶ(新しい物が下)。一番下に、写真を足すボタン(スマートフォンはカメラの印で「撮る」、PC は「写真・動画・zip を選ぶ」)、一行の欄、送るボタン。文字を打つ所は、ここと歯車の設定のフォームだけ。写真を読む時は、土と歴史をいつも聞く(ask の soil、history)。読みの中で土や歴史に触れた行は「土地の資料から分かる事」として分けて出る。

「この土地」の画面には、座標から引いた土地の資料の行(place.md の ## Data)が、土地と地形・土・水と災害の区域・歴史の四つにまとまって、出典と一緒に出る。資料がまだ無ければ「この場所の資料を調べる」、昔の地図と空中写真がまだ無ければ「昔の地図と空中写真を取って来る」を押す(AI は使わない。地図を先に、空中写真は古い順。押すと大きく)。資料は、位置の入った写真を初めて送った時にも引きに行く(照会の部品 [lookup] があればこの PC で、無ければ招待コードでサーバーで)。「この土地の成り立ちを教えて」と話すと、Claude がこの資料を読んで答える。

何ができるかは、入力の上に「こういう事ができます」の例で出る(「この土地の成り立ちを教えて」「土はどんな土?」「昔はどんな土地だった?」(無ければその場で地図を取って来る)「写真を場所ごとに、時の順に並べて」「この草の名前は?」「それは違う。あれはススキ」「来年の春の計画を立てたい」「この観察を公開したい」「設定を見せて」など)。押すか、同じ言葉を書いて送る。

一周は、写真を撮る → 読み → 違う所を言葉で言う → 計画 → 公開 → 繋がる、の順。撮るから違う所までは下の「畑を観察する」、計画は「借りる・買うことができたら — 栽培計画」、公開は §7、繋がるは §8。畑が無い人、紹介された農地を見る人は「農地が無いとき」「農地を紹介されたら」も読む。

畑を観察する

  1. 「話す」の左下のボタンで写真を足す(一言を添えてもよい。先に下の欄に書いてからボタンを押す。例「北の角。土が固い」)。スマートフォンはカメラが開く(§11b)。PC にはカメラが無いので、スマートフォンで撮った写真を PC に移し、「写真・動画・zip を選ぶ」で選ぶ(HEIC でもよい。動画と zip も。下の「PC で写真・動画・zip を入れる」)。家の PC で seed home を動かせば、スマートフォンで撮った物がそのまま PC に届く(§11b)。一つの観察は写真 6 枚まで。写真は ~/seed/photos/<日>/<時刻>.jpg に写され、座標と時刻は EXIF から読む。ほかの写真から 50 m より離れた写真は知らせる。
  2. 送った写真が大きく出て「読んでいます…」。読み方は設定の「読み取りと話す」の通り。既定は在る物を順に: この PC の Claude Code(§6.1)、自分の Claude の鍵(§6)、サーバー(招待コード)。スマートフォンは自分の鍵かサーバー(家の PC の seed home もサーバーの一つ)。どれも無ければ「招待コードを貼ってください」と出るので、下の欄に貼る(その一行はやり取りに残らない)。
  3. Claude の側に、今日の一枚(一番見せたい写真)とその一言、見つけた事(行が指す写真が左に小さく出る)、Claude からの問い、次の一枚(次に撮るとよい物)が出る。長い読みは頭の数行だけで、「続きを読む」で開く。読みは ~/seed/observations/<日>-<時刻>.md に残る。
  4. 問いへの答えや、読みの違う所は、下の欄に言葉で書いて送る(例「3 行目は違う。あれはススキ」「水が溜まるのは雨の後だけ」)。Claude が使える時(この PC の Claude Code、自分の Claude の鍵、招待コードでサーバー)は、Claude が違う行に印を付け(seed mark と同じ)、あなたの言葉を残し、読み直して、直した行を先に見せる。どれも使えない時は、あなたの言葉として一番新しい観察に残り(「書き留めました」と、Claude と話すには何を入れるか)、次に写真を送った時の読み取りが「あなたが直した事」として先に読む。
  5. 「写真」の画面で、写真を日ごと・観察ごとに見る。押すと大きく開き(左右で前後へ、つまんで拡大。位置の入っていない写真には「位置なし」)、「この草の名前は?」「今日の一枚にする」「この写真を外す」ができる。外した写真は消えず、~/seed/photos/removed/ に移る(すぐ後なら「戻す」)。

Claude は読みの中で、写真一枚ごとに「タグ」の行を付けます(植物の名と、発芽・育ち・開花・結実・枯れ・刈った・播いた・植えた・収穫・裸地の十語のうちの状態)。「写真」の画面の上に、タグが札(語と枚数)で並び、押すとその語の写真だけが日ごとに出ます(もう一度押すと全部に戻ります)。大きく開いた写真の下にも出ます。直したい時は、ほかの行と同じに「話す」で言葉で言います(例「この写真の開花は違う」)。 6. place.md(場所について分かっていること)、next.md(その次の考え)、観察のファイルは、どれも文字のファイルなので、エディターで直してよい。細かい作業(並べ替え、比べる、まとめる)は Claude Code に頼む。写真を場所ごとに時の順に並べるのは seed photos --by-place(AI を使わない)。

PC で写真・動画・zip を入れる

「話す」の左下のボタン(「写真・動画・zip を選ぶ」)を押すと、ファイルを選ぶ窓が出ます。いくつでも選べます。プロジェクト全体を見ている時は、先に畑を選ぶ板が出ます。

選んだ物 どうなるか
写真(jpg、jpeg、png、heic、heif) 撮った時(EXIF。無ければファイルの時刻)の順に並べ、撮った日ごとに 6 枚ずつの観察にして、順に読みます。二回以上に分かれる時は「写真 N 枚を、撮った日ごとに M 回に分けて読みます。」と出ます
動画(mp4、mov、m4v) 読みには入りません。videos/<撮った日>/<時刻>.<元の拡張子> に写し、撮った時と所を同じ名の .json に書きます。撮った時は動画の中の時刻、無ければファイルの時刻。所は、動画の中に位置が書かれている時だけ入ります(スマートフォンの標準のカメラで、位置を付けて撮った物)。選んだ元のファイルはそのまま残ります。撮った時と大きさが同じ動画がもうあれば、同じ物として二度は置きません。「動画 N 本を置きました: …」と出ます
zip 中の写真と動画だけを取り出して、上の二つと同じに入れます。zip の中のフォルダーは見ず、ファイルの名だけで取り出します。写真の撮った時が無ければ、zip に書かれた時刻を使います。取り出した物は記録のフォルダーの中の一時の場所に置き、終われば消します
そのほか 入れません。「写真でも動画でもない物 N 個は入れませんでした: …」と名が出ます(zip の中の、写真でも動画でもない物、鍵の掛かった物、壊れた物、zip の中の zip も)

畑に入っていない写真

記録のフォルダー(~/seed)に、どの畑にも入っていない写真があると、アプリを開いた時に「話す」で知らせます。前のアプリから移した写真や、手でフォルダーに置いた写真です。

コマンドで

seed observe ~/Pictures/IMG_0012.jpg ~/Pictures/IMG_0013.jpg

Windows では写真の道を C:\Users\<名前>\Pictures\IMG_0012.jpg のように書く。

seed observe --ask grow,soil --say "ask: 果樹は向くか" ~/Pictures/IMG_0012.jpg

--ask の語は grow, soil, plants, history, access, sow, next, names。--say は did:、saw:、said:、note:、ask: の形で何度でも。読む先は --local(この PC の claude。あれば既定)、--server(claude が無いときの既定)、--claude-code(読まずに手順を出す)。CLI の写真の数に上限は無いが、サーバーの道は 6 枚まで。外のサーバーはまだ開いていないので、Claude Code が無い PC では、今は既定のままでは読みが戻らない(--claude-code で手順を出し、§6.2 で頼む)。Claude Code がある PC では既定(この PC の claude)でよい。

seed mark 2026-11-05-142107 soil_surface wrong --reason "北側は見える"

同じ key の行がいくつもあるとき(plants など)は --text "行の文" でどの行かを指す。本人の行は seed say 2026-11-05-142107 did "今日は見ただけ"。

借りる・買うことができたら — 栽培計画

  1. 自分の畑として撮る(「自分の畑」、kind: own)。
  2. 「話す」で「来年の春の計画を立てたい」のように言う(季節もその言葉で)。Claude(この PC の Claude Code、自分の鍵、サーバーのどれか)が、手引き、観察、place.md を読んで、~/seed/plan.md の ## Plan の行を書く。
  3. どれも使えない端末では「これは PC の Claude Code でできます」と、鍵か招待コードを入れればここでも頼める事が返る。手で頼む手順は seed plan --claude-code が出す。立てた計画は「計画を見せて」で見える。
  4. 違う行は「話す」で言葉で言う(Claude が印を付ける)。決めたことは「決めたこと」(decided)、したことは「したこと」(did)として、「話す」で言うか seed say plan … で書く。立て直しても、判定と自分の行は残る。
  5. 立ち位置(菌根菌を活かす自然農法から。理由はりん酸肥料の高騰)は出発点で、前提ではない。数字と混植は書かない(手引き 09 章、04 章)。収量や経費の数字は、作者の別の手引き aiai(就農の手続きと自然農法の経営計画)に任せる。
seed plan --season "2026-27 冬" --decided "南側は草のまま"

seed say plan did "北側を刈った"、seed mark plan sow wrong --reason "種が無い" のように、plan を観察の名の代わりに使う。

同じ場所(100 m 以内)をまた撮ると、読みに change(前の観察からの変化)が付く。「したこと」を残しておけば、何が効いたかが並んで読める。同じ写真をもう一度読ませると AI の行は置き換わり、判定と自分の言葉は残る。判定の付いていた行の文が変わると、古い行は「前の読み」に移る。

一周の実例(作者の畑、2026-11-02)

  1. 徳島の元田んぼ(自分の畑)で写真を 24 枚撮った(CLI で渡した。アプリなら一度に 6 枚まで)。
  2. この PC の Claude Code が読み、読みの行が 17 行戻った。地形(氾濫平野)と土壌図(水田化褐色低地土)の行は Claude の読みではなく、fieldnotes の座標からの照会で付いた資料の行。今の seed では、この行は照会の部品 [lookup] か、サーバーで引く。
  3. 白い穂の草を Claude は「ススキらしい」と読み、作者が「違う」を付けた(理由: ススキではなくてオギ)。土の固さは写真に写らない、と読みの側にも書かれた。
  4. 栽培計画 plan.md の元になったのは、作者が記録に書いた言葉(元田んぼ、硬盤層、おそらくシルト質埴土、サブソイラにはトラクターが要る)で、Claude はそれを案に並べた。固い層の厚さは分からないので、次に見ることとして計画に残った。
  5. 公開と繋がるは、サーバーが開いていないので、まだ通していない。

農地が無いとき — ここから始める

  1. 気になる耕作放棄地を、道から撮る(人の土地に入らない)。
  2. 「話す」で「設定を見せて」と送り、「今見ている畑」を「候補地に変える」にしてから撮る(CLI は seed observe --candidate)。
  3. 筆と所有者を調べるのは、あなた。手引き 13 章に、地番は法務局の地図(公図)で、所有者は登記事項証明書か近所で、とある。分かったことは「言ったこと」「そのほか」に自分の言葉で残す。所有者の名前や住所は公開しない。 公開の下書きで Claude が人の名前を「近所の方」のような言い方に直し、載せる前にサーバーの人が読みます(§9)。電話番号・メール・郵便番号の形はアプリが止めます。
  4. 持ち主と話せたら、その人にも seed を渡す。公開の「その次」に「貸す」「借りる」「手伝う」の札がある。

農地を紹介されたら — 借りる・買うかの材料

  1. その農地を候補地として観察する(道、水の口、周りの畑、傾斜が分かるように)。
  2. 読みに、道(access)、日当たりと傾斜(sun_slope)、周り(surroundings)、水(water)、草(plants)が並ぶ。
  3. 筆・地形・ハザード・地質・土壌の資料の行(data)は、「この土地」の画面に出る(照会の部品 [lookup] を入れた PC か、招待コードでサーバーで引く。§3、§5 の初め)。この PC の Claude Code で読んだだけでは付かない。
  4. これは材料で、借りる・買うの判定は出ない。手続きは手引き 13 章と 00 章。

「違う」を集める seed marks

付けた判定を key ごとに集め、手引き 06 章(~/seed/skill/06-畑を読む.md、無ければパッケージの物)の当たる行と並べて出す。章を直す材料(§11)。

seed marks

--all で「合う」も、--key plants で一つの key だけ、--json で JSON。

畑の成り立ちの動画 seed origin

座標から、公開の地図と空中写真を順に並べた一分ほどの動画を組む。AI は使わない。場面は、標準地図(引いた所から寄る)、色別標高図、地形分類、洪水浸水想定区域、土砂災害警戒区域、土壌図、年代別の空中写真(その場所にある年代だけ)、近くの史跡、あなたの写真。字幕は place.md の照会の行(出典付き)だけで、各場面の下に地図の出典が出る。照会の行が無いと字幕は付かず、史跡の場面は省く。

seed origin

計画の絵(仮説)seed grow

plan.md の ## Plan の行から、畑が季節ごとにどう見えるはずかを、線と色と字の図にする(場面は 6 まで)。上から見た図、横から見た土の断面、見えるはずの物が一枚に並ぶ。仮説の図で、あなたの写真でも判定でもない。 時期が来たら同じ所を撮って並べ、合う/違うを付けるための物。

Claude が場面を書き、seed がそれを計画の行と照らして描く。計画の行に無い場面と作物は描かず、省いた理由を captions.md に書く。確からしさは元の行より高くならない。先に seed plan で計画の行が要る。

seed grow

自分の機械で絵にする(--draw)。(上級者向け。GPU のある機械と画像生成サーバーが要る)場面の図を、あなたが用意した画像生成の機械(stable-diffusion.cpp の sd-server、FLUX.2 klein 4B)でイラストにする。要るのは [grow] と、その機械。絵の指示(英語の prompt)は Claude がシナリオに書く物で、prompt の無い場面は描かない。

seed grow --draw --server http://<あなたの機械>:11445   # 門(deploy/halo)の口。token は credentials.toml の draw_token

種のロット seed lot

seed lot add --lot 2026-aoi-kabocha --crop かぼちゃ --variety 在来 --place 南の畑 --year 2026 --from 2025-aoi-kabocha
seed lot list

~/seed/lots.md に一行一ロット(記録の形 §15)。公開しない。

帳簿 seed ledger

seed ledger add --date 2026-11-20 --kind sale --yen 1800 --what "かぼちゃ 3 本" --to A   # kind は sale / cost / help / other
seed ledger sum --month 2026-11
seed ledger invoice --to A --month 2026-11   # ledger/invoice-<日>-A.md の下書き。税の計算はしない

気象の記録 seed weather

seed weather fetch --from 2026-11-01 --to 2026-11-05   # Open-Meteo の過去データ。座標は 2 桁に丸めて送る
seed weather show --month 2026-11
seed weather fill                                       # 最初の観察の日から昨日まで、記録の無い日を埋める

~/seed/weather/<月>.md。座標は --lat --lon、place.md の center の行、座標のある一番新しい観察の順。 気象の実績(最高・最低・平均気温、降水、日照、蒸発散、風、地温と水分の層ごとの日平均)は、植物の成長と照らすために残します。最初の観察の日から昨日までの穴は、観察を送った時と、アプリの「天気」の画面を開いた時(一日に一度)に自動で埋まります(seed weather fill でも)。過去データがまだ来ていない直近の日は、予報の過去の値で一旦書き、過去データが来たら置き換えます。予報は記録に残りません。

手続きの下書き seed procedure

seed procedure nochi-3jo   # procedures/nochi-3jo/ に checklist.md、draft.md、sources.md

農地法 3 条の申請の下書き。判定ではないので、農業委員会で確かめる。作り直しても [x] と自分の行は残る。

畑を分ける seed field

畑が二つ以上ある時は、一つのプロジェクトフォルダーの中に fields/<畑の名>/ を作って分けます。 畑のフォルダーの中身は、今までの記録のフォルダーと同じです(写真、観察、place.md、plan.md、公開の控え)。 設定(seed.toml)、手引き(skill/)、CLAUDE.md、本人の画面(plugins/)は、プロジェクトフォルダーに一つだけ置き、どの畑でも使います。 fields/ が無いプロジェクトは、今まで通り、プロジェクトフォルダーそのものが一つの畑です。

アプリでは、上の端のフォルダーの印を押すと、下に板が出ます。上に「プロジェクト全体」と畑の並び(今の物に印)、細い線の下に別のプロジェクトが並びます。 畑を選ぶと、上の端の名は「プロジェクトの名 / 畑の名 — 話す」になります。 「プロジェクト全体」では、写真は畑ごとの見出しで全部を並べ、話すは畑ごとの見出しでやり取りを並べます。言葉は、この PC の Claude Code にプロジェクトフォルダーで渡します。 写真は畑ごと、月ごと、日ごとに並びます(新しい月、新しい日が上)。話すのやり取りには、月が替わる所に小さく月が出ます。 写真を撮る、選んで送る、公開するは、畑を選んでからです(全体の時に写真のボタンを押すと、畑を選ぶ板が出ます)。

別のフォルダー(別のプロジェクト)は、プロジェクトの一覧(~/.config/seed/fields.toml)で切り替えます。 seed project add 知人の田 ~/知人の田 で一覧に足し、seed project use 知人の田 で替え、seed project list で見ます。前の名の seed field add も同じ事をします。 どのフォルダーを使うかは、この順で決まります: --folder → 今いるフォルダー(seed.toml がある時。Claude Code と同じ)→ --field(このプロジェクトに無い名なら一覧の名)→ 今のプロジェクト → SEED_FOLDER → ~/seed。 PC のアプリでは、板の「別のフォルダーを開く」で選んだフォルダーが、フォルダーの名で一覧に足されて、今のプロジェクトになります。

6. 自分の Claude で読む

自分の Claude の鍵(Anthropic の API の鍵)で。 Claude Code が無い PC とスマートフォンでも、自分の鍵を入れると、写真の読み取りと「話す」の細かい作業(違う所を直す、計画、公開の下書き)がその端末から直にできる。費用はあなたの鍵に掛かる。鍵は console.anthropic.com で作る。入れ方: 上の端の歯車を押し、「自分の Claude の鍵(あれば)」の「Anthropic の API の鍵」の欄に貼って「保存」(伏せ字で出る)。「話す」で「設定を見せて」→「自分の Claude の鍵」の「入れる」を押し、下の欄に貼って送ってもよい(「入りました」とだけ返る)。鍵はやり取りにも記録にも残らない。置き場はこの端末の ~/.config/seed/credentials.toml(600)だけで、送り先は Anthropic の API だけ。外すのは、歯車のフォームの「鍵を外す」か、「設定を見せて」の「鍵を外す」(続けて「本当に外す」)。モデルは seed.toml の claude_model(既定 claude-opus-5-5。安くするなら claude-sonnet-5-5 か claude-haiku-5-5)。Claude は記録のフォルダーの中だけに効く道具を使い、アプリがそれを端末の中で動かす(公開を送る事と、命令を走らせる事はできない)。待つ間も画面は動き、「止める」で止まる。

サーバー経由で。 招待コードを入れると(歯車のフォームの「招待コード」か seed invite CODE)、写真の読み取りと「話す」がサーバー(作る人の鍵)を通る。一日の回数に上限があり、使い切った時と受け付けを止めている時は、あなたの言葉を書き留めて理由を返す。

どれを使うかは、歯車のフォームの「読む所」で選ぶ(「手元の Claude(Claude Code)で」は、この PC に claude がある時だけ出る)。「設定を見せて」の「読み取りと話す」でも、押すと次の物に変わる。既定は、PC がこの PC の Claude Code → 自分の鍵 → サーバー、スマートフォンが自分の鍵 → サーバー。

6.1 この PC の Claude Code に読ませる(自動)

Claude Code が入っていてログインしている PC では、seed observe は何も付けなくてもこの PC の claude -p で読む。アプリでは、写真を送った時に、設定の「読み取りと話す」が「手元の Claude(Claude Code)で」(PC の既定)ならこの道で読む。API キーは要らない。費用はあなたのサブスクの分。

6.2 手で頼む

  1. Claude Code で ~/seed/ を開く。
  2. ~/seed/skill/SKILL.md(seed skill-path が道を出す)を読ませる。Claude.ai なら、プロジェクトの知識に ~/seed/skill/ の中身を入れる。
  3. 「observations/<日>-<時刻>.md の写真を読んで、観察を書いて」と頼む(seed observe --claude-code が、この手順を道付きで出す。同じ場所の前の観察があれば、それも読ませるように出る)。
  4. 書けたら、アプリの「話す」で同じように見える。費用はあなたの Claude の分。seed のサーバーは通らない。

フォルダーには CLAUDE.md(seed init が書く)があるので、Claude Code をここで開けば(PC の端末でも、スマートフォンから使う時も)、アプリの「話す」と同じ決まりで動きます。

7. 公開する

seed.aiseed.dev は開いています。サーバーの Claude の読み取りと話すは準備中で、公開された記録は読めます。

公開は、Claude を使って行う。本人が読んだ文と、送られる文を同じにするためで、アプリは公開を組み立てない。「話す」で「この観察を公開したい」と送ると、Claude(この PC の Claude Code、自分の鍵、サーバーのどれか)が下の 1〜2 をする。自分の鍵とサーバーの時は、Claude は下書きを作るだけで送れない。アプリが下書きの写真と全文と「出す」を出し、あなたが写真と全文を見て「出す」を押すと、その中身のまま送る(見せた後に下書きが変わっていたら送らず、新しい全文を出す)。どれも使えない端末では「これは PC の Claude Code でできます」と返る。

  1. Claude に「この観察を公開したい」と頼む。Claude が、行の候補(判定の付いた行が先)、場所の粗さ(都道府県/市町村/大字。座標を付けるなら小数 2 桁、約 1 km まで)、呼び名、札、その次、一言(200 字まで。入口に並ぶ)をあなたと決め、下書きを作る(seed publish … --local。~/seed/public/<id>.md に書かれ、送られない)。公開は成長の記録で、写真は、同じ場所を日を追って撮った物が日ごとに一枚 photo の行で入る(二日以上に渡る場所が無ければ、その日の今日の一枚)。別の写真にしたい時は、Claude にそう言う。
  2. 下書きの全文を読む。直したい所は Claude に言う。直したら、Claude はもう一度全文を見せる。
  3. 「出す」と言うと(自分の鍵とサーバーの時は「出す」を押すと)、その下書きがそのまま送られる(seed publish --file ~/seed/public/<id>.md)。「出す」の前には送らない。写真は長い辺 1280 に縮め、撮った場所などの情報(EXIF)を外して一緒に送る。サーバーも受けた写真を開いて書き直し、位置の情報を残さない。行が指す写真が手元に無い時は送らない。
  4. 取り下げ・書き直しは同じ PC(同じ token)から。アプリの「話す」で「公開した物を見せて」と送り、「取り下げる」を二度押す。取り下げると、出した写真もサーバーから消える。
  5. HTML、電話番号・メール・郵便番号の形の文があると止まる(「直す所」が出る)。候補地の観察を含むと、所有者のことを書かないよう注意が出る。
  6. サーバーは、届いた物をすぐには載せない。サーバーを動かす人が読んで「載せる」と言ってから、公開の頁に出る。アプリには「送りました。サーバーの人が読んでから、載ります。」と出る。載ったかは、「公開した物」の「載ったかを見る」で見る。家の PC(seed home)では待ちは無く、すぐ載ります。戻された時は、そこにその人の一言が出る。もう載っている記録を書き直した時は、載せるまで前の版が見える。
seed publish 2026-11-05-142107 --id my-field --place "徳島県 吉野川市" --word "元田んぼを草ごと読んでいます" --local
seed publish --file ~/seed/public/my-field.md

一つ目は、判定の付いた読みの行と、data、record を全部入れた下書きを作る。--coord、--what、--next、--name(既定は seed.toml の name。空なら止まる)、--contact、--photo(出す写真の名。何度でも。一日 3 枚、全部で 12 枚まで。付けなければ日ごとに今日の一枚)、--local(送らずに public/ に書くだけ。付けなければ作ってすぐ送る)。二つ目は、在る下書きを中身のまま送る(観察や --id などは要らない。形が合わなければ送らずに止まる)。

8. 探す・繋がる

seed.aiseed.dev は開いています。サーバーの Claude の読み取りと話すは準備中で、公開された記録は読めます。

  1. 「話す」で「ほかの人の畑を見たい」と送ると、公開された記録の一覧が出る(一覧はサーバーから取る)。「開く」で中身が読める。
  2. 「この人に一言」を押すと、下の欄が「<相手> への一言」になる。書いて送る。送る名はあなたの公開の id(無ければ呼び名)。相手の記録の繋がりの数が増え、自分の connections.md に一行残る。同じ相手へは一日一回。
  3. 続きの会話は Discord「AI と一緒に自給農」( https://discord.gg/Q8pwMH2uTA )で。seed は伝言を持たない。

9. 写真と座標、個人情報

10. 設定 ~/seed/seed.toml

folder = "~/seed"
server_url = "https://seed.aiseed.dev"
name = ""                 # 呼び名。公開の既定
language = "ja"           # 本人の言葉の言語。無ければ OS の言語。画面の文と、AI が書く言葉
place_level = "city"      # prefecture / city / oaza。公開の場所の粗さの既定
field = ""                # 今の畑(fields/ の下のフォルダーの名)。空ならプロジェクト全体(seed field use で変える)
keep = "photos"           # text / photos / research(seed keep で変える)
bulk = ""                 # 写真の元 originals/ を置く別の盤の道(seed keep --bulk で変える)
read = ""                 # local / key / server。Claude を呼ぶ所(読み取りと話す)。空なら在る物を順に(「話す」の設定か、歯車のフォームの「読む所」で変える)
claude_model = ""         # 自分の鍵で呼ぶモデル。空なら claude-opus-5-5(費用はあなたに掛かる)
# token、invite、自分の Claude の鍵(秘密)は seed.toml ではなく ~/.config/seed/credentials.toml(600)にある

[grow]
server = "http://<あなたの機械>:11445"   # seed grow --draw の描く機械(任意。門の口。token は credentials.toml)

秘密(token、invite、halo の門の draw_token、自分の Claude の鍵 anthropic_key)は seed.toml ではなく ~/.config/seed/credentials.toml(許可 600。環境変数 SEED_CREDENTIALS で場所を変えられる)に置かれ、seed.toml に古く書かれていた物は次に開いた時にそこへ移る。

知らない鍵と表は消さずに書き戻す。ファイルの中の決まった語(overall、farmer: right、## Reading)は英語のまま。どの国の人のフォルダーも同じ読み手で読めるようにするため。画面では日本語で見える。

コマンドの共通の引数と環境変数: --folder(SEED_FOLDER)、--field <畑の名>(この回だけその畑を使う。§5「畑を分ける」)、--server-url はこの回だけのサーバー(SEED_SERVER_URL。ファイルには書かない)、SEED_CLAUDE(§6.1)、PLANTNET_API_KEY(§11a)、SEED_DRAW_URL(§5)。

11. ビルダーの訓練

観察して、読みに合う/違うを付け、「違う」の理由が溜まったら ~/seed/skill/ の手引きの章を直す(seed marks が材料を並べる)。この一周が、自分の場所で AI を使い、確かめ、直す、ビルダーの最初の仕事。記録は素の文字のファイルなので、自分の Claude と小さなスクリプトで並べたり比べたりもできる。手順は手引き 08 章。

機能は自分で足す

seed は、使う人が自分で機能を足していくアプリです。畑は一枚ずつ違うので、何を記録するか、何をどう読むか、どう見せるかは、人ごとに違います。足し方は二つです。

フォークした seed は、その人の物で、その人の Claude が動かします。元の seed の Claude があなたのアプリのコードを書き換える事はありません。

画面やコードで足す時の手順は、seed の skill-builder/ に手引きとしてまとめてあります。自分の Claude Code に skill-builder/SKILL.md を読ませてから「〜を足したい」と話すと、言葉で済むかを先に見て、プラグイン一つか、フォークしたコードかの順に進めます。家の PC を仲間のために動かす人の手引きは skill-keeper/、その中で使う道具 kagi の手引きは skill-kagi/ です。写真や資料の置き場を整える時、別の場所の畑をプロジェクトに迎える時、手引きの写しを新しくする時は、skill-folder/SKILL.md を読ませてから頼みます。

手引きは本人の物

seed init(とアプリ、seed observe、seed plan の始まり)は、手引きを ~/seed/skill/ に写す。これはあなたの手引きで、直してよい。直した手引きが効くのは、この PC の Claude と自分の鍵で読むとき(§6)。サーバーは共通の手引きを読む。

章は 2026-11-05 に組み替えた: 00 始める前、01 立ち位置、02 地質と土、03 気象と時期(気象庁の資料の入口と、記録の気象の行の読み方)、04 生物(菌根菌・草・混植)、05 鳥獣害、06 畑を読む、07 周りの物(筆・史跡・地名)、08 ビルダーの訓練、09 栽培計画、10 種、11 売る、12 加工、13 手続きと農地。

11-05 より前に写した手引きは、古い章の名のまま(02-畑を読む.md、06-手続きと農地.md など)。seed init は、もうある ~/seed/skill/ を上書きしない(「上書きしません」と出る)。古い写しのままでも章は付く(§6.1 を見てください)。自分の直しを効かせるには写し直す。写し直すコマンドは無い。手で次のようにする。

mv ~/seed/skill ~/seed/skill-old
seed init

新しい写しができたら、skill-old/ で自分が直した所を見て、新しい章に移す(seed marks の 06 章は、古い写しのあいだはパッケージの物を使っている)。

数字は aiai(作者の別の手引き)に任せ、seed は書かない。混植は、読んだ資料が ~/seed/skill/sources.md に入るまで書かない。

資料の候補は五つ(seed init が ~/seed/skill/ に写す。写した後にリポジトリの skill/ に足された物は写しに無いので、リポジトリの方を見る。どれも資料の候補で、手引きの本文に引いていない。根拠にはしない): sources-regenerative.md(リジェネラティブ農業と混植と菌根菌、59 件)、sources-wildlife.md(鳥獣害)、sources-law.md(法令の本文と解説)、sources-defense.md(植物の防御機構の論文 178 件)、sources-security.md(サイバー攻撃への守り 59 件)。

11a. 草の名を確かめる — Pl@ntNet

はじめて作物を作ると、雑草か作物かが分からない。seed は写真を一枚ずつ Pl@ntNet(植物の識別器)に送り、種の候補を plants の行に「Pl@ntNet(写真の名): 名 0.62、…」の形で足す。Claude の読みとは別の行(モデルの読み)なので、合うか食い違うかが分かる。食い違った草は、畑で近くから見直す所です。

seed identify 2026-11-05-142107 092817 092733

keep = research なら、答えが observations/<id>.raw/plantnet-<写真>.json に残る。

11b. スマートフォンだけの人 — スマートフォンのアプリ

アプリは PC 版とスマートフォン(Android、iPhone)です。ストアには出していないので、PC で作って入れます(Android は README の「スマートフォンで試す」、iPhone は Mac で作ります。iPhone 版.md)。人ごとに記録をサーバーに置く Web 版は作りません。

スマートフォンでの一周

  1. seed を開きます。初めは「話す」の画面に「まず一枚、撮ってみます」と「設定を見せて」の札が出ます。
  2. 上の端の歯車を押すと、設定のフォームが開きます。家の PC に送るなら「PC と繋ぐ」を使います(下の「スマートフォンから PC へ」)。PC を使わないなら、「自分の Claude の鍵(あれば)」に Anthropic の API の鍵を貼るか(§6。費用はあなたに掛かります)、Discord で受けた招待コードを「招待コード」に入れます(サーバーの道。一日の回数に上限があります)。最後に「保存」を押します。
  3. 「話す」の左下のカメラの印(撮る)を押すと、カメラが画面いっぱいに開きます。初めての時は、カメラと位置を使ってよいかを端末が聞くので、許します。
  4. 撮ります(下の「カメラの使い方」)。写真は一度に 6 枚までです。
  5. ✓(撮った枚数が出ます)を押すと、その写真で観察になります。「← 戻る」を押した時は「撮った写真 n 枚を観察にしますか。」と聞かれるので、「n 枚で観察にする」か「観察にせずに戻る」を選びます。
  6. 観察にすると「話す」に戻り、写真が大きく出て「読んでいます…」と出ます。読みが戻ったら、違う所を下の欄に言葉で書いて送ります(§5「畑を観察する」)。家の PC と繋いでいれば、写真は PC に届き、PC の Claude Code が読みます。撮った動画は、カメラを出た時に PC へ送ります。

計画を立てる、公開の下書き、読みをその場で直す、も「話す」から頼めます(鍵か、サーバーか、家の PC)。公開は、全文を読んで「出す」を押した時だけ送られます。鍵も招待コードも無い時に言葉だけを送ると、一番新しい観察にあなたの言葉として残り(AI は呼びません)、次に読み取れた時にそれを先に読みます。記録はスマートフォンの中のあなたのフォルダーに残ります。

カメラの使い方

スマートフォンの標準のカメラに近い形にしてあります。

スマートフォンから PC へ(一方通行)

PC のプロジェクトフォルダーを本物の記録にして、スマートフォンで撮った写真と動画をそこへ送れます。PC からスマートフォンへ記録を送る事はしません。仲間のために PC を動かす人も、同じ手順です。

PC で:

  1. seed を入れ(§3)、seed のフォルダーでサーバーの部品も入れます。

bash pip install -e ".[app,server]"

  1. プロジェクトフォルダーの中で seed home を打ちます(別のフォルダーなら seed home --folder <道>)。端末に「サーバーの URL: http://…:8800」と「招待コード: 6 桁」が出ます。招待コードはプロジェクトフォルダーの home.toml に一つ作られ、次からも同じ物が出ます(home.toml を消すと、次の seed home で作り直します)。写真を読むのは、この PC の Claude Code です(§6.1)。
  2. 端末は開いたまま、PC は点けたままにします。止めるには、その端末で Ctrl+C を押します。

スマートフォンで:

  1. PC と同じ Wi-Fi につなぎ、seed の上の端の歯車を押し、「PC と繋ぐ」の「PC を探す」を押します。「同じ Wi-Fi の PC を探しています…」の後に「PC が見つかりました。招待コードを入れて「保存」を押します。」と出て、「サーバーの URL」が入り、「読む所」が「サーバーで」になります。
  2. 「招待コード」の欄に、PC の端末に出ている 6 桁を打ち(伏せ字で、数字の鍵盤が出ます)、「保存」を押します。
  3. 撮って観察にすると、写真は縮めずに(座標入りのまま)PC のプロジェクトフォルダーに入ります(畑を分けていれば、PC で今選んでいる畑)。PC の Claude Code が読み、答えがスマートフォンの「話す」に出ます。スマートフォンには読み用の縮めた写しだけが残ります。「話す」の言葉も、PC の Claude Code がそのフォルダーで受けます。
  4. 動画は、カメラを出た時に PC へ送ります。送れたら「動画を n 本、PC へ送りました(最後は …)」と出て、PC の videos/<日>/<時刻>.mp4 に入ります(撮った時と所は同じ名の .json)。畑で網が無いなどで送れなかった時は「…スマートフォンに残し、次に繋がった時に送ります」と出て、次にカメラを出た時に古い順に送ります。一本は 2 GB までです。

補足:

スマートフォンから PC の Claude Code と話す

PC のアプリの「設定を見せて」にある「スマートフォンから使う」の「始める」を押すと、その畑のフォルダーで Claude Code のリモートコントロールが立ちます。スマートフォンの Claude アプリの Code に畑の名のセッションが出るので、開けば、その PC の Claude(seed の手引きと seed の命令つき)と話せます。要る物は、Pro 以上の Claude のアカウントと、点けたままの PC です。初めて立てる時は、Claude Code が「Remote Control を使ってよいか」と聞くので、アプリの「はい」を押します。そのフォルダーは、一度端末で claude を開いて、信頼すると答えておきます。立ったあとに出る URL か QR コードからも開けます。

11c. サーバーを動かす人 — 相手ごとの token

seed のサーバーを自分で動かす人のための節(使うだけの人は読まなくてよい)。招待コードの一覧に加えて、相手ごとに token を出せる。

seed token add "買い手の呼び名" --scope buyer --days 30

出た一行が token。出るのはこの一度だけで、台帳(~/.config/aiseed/tokens.json。サーバーでは --file /var/lib/seed/gate/tokens.json)に残るのはハッシュだけ。その人にだけ渡す。相手は招待コードと同じ所(歯車のフォームの「招待コード」か seed invite)に入れる。

管理は、kagi の机の画面(kagi app --dir <作業の場所>)の「人の出入り」から。サーバーの URL と、動かす人の token(--scope admin)を「繋ぐ先」に入れると、今の状態、気を付ける事、人に渡す token、公開された記録、操作の記録をそこで見て、出す・取り消す・取り下げるができる(skill-kagi/SKILL.md)。動かす人の token を seed のアプリに入れても、ほかの人と同じ様に使えるだけ。

誰が何をしたか(通した、断った)は、サーバーの記録に一行ずつ残る。token も招待コードも書かれない。確かめは kagi log verify、期限は kagi check tokens(skill-kagi/SKILL.md)。

12. 困ったとき

出た文 何が起きたか、どうするか
「この PC に claude(Claude Code)が見つかりません。」 Claude Code を入れてログインする。または §6.2
「この PC の Claude Code のログインが切れています。」 ターミナルで claude を起動し、/login し直す
「サーバーに届きません(…)。」 網に繋がっているかを見る。外のサーバー(seed.aiseed.dev)の読み取りと話すは準備中(§4)なので、この PC の Claude か §6.2 で。家の PC に送っている時は、PC で seed home が動いているか、スマートフォンが同じ Wi-Fi にいるかを見る
「招待コードが要ります(Discord で渡します)。」 seed invite CODE か、歯車のフォームの「招待コード」に入れる。家の PC に送る時は、PC の端末に出た 6 桁
「今日はここまで。」 サーバーの一日の上限(読み取りは既定で一人 10 回、全体 200 回。話すは一人 60 回、全体 300 回。家の PC の seed home は 500 回と 1000 回)。明日か、自分の Claude で
「読めませんでした。写真が暗い・遠い、または Claude が断りました。」 近くで、地面と草が分かるように撮り直す
「座標がありません。」 写真に位置情報が無い。カメラの設定で位置情報を付けて撮り直す(手で場所を入れる欄は無い)
「HEIC の写真を読むには pillow-heif が要ります」、「flet がありません。」など pip install -e ".[app]"。HEIC がだめならカメラを JPEG(互換性優先)に
「写真 … は、ほかの写真から … m 離れています。」 別の場所の写真なら、別の観察に分ける
「plan.md の ## Plan に行がありません。」 先に seed plan(seed grow は計画の行からだけ描く)
「描く server がありません。」 --server、SEED_DRAW_URL、[grow] の server のどれか
「同じ Wi-Fi に PC が見つかりません。…」 PC の端末で seed home が動いているか、スマートフォンが PC と同じ Wi-Fi にいるか(モバイルデータになっていないか)を見ます。ゲスト用の Wi-Fi は、つないだ機械どうしが届かない事があります。PC の防火壁(ファイアウォール)が seed home の口(TCP の 8800 番と、探す時の UDP の 8801 番)を止めていても見つからないので、この二つを家の網の中だけ通します。探せない網でも、PC の端末に出た URL を歯車の「サーバーの URL」に打てば繋がります(8800 番が通っていれば)
写真は PC に届くが、動画が届かない 動画はカメラを出た時(✓ か「← 戻る」で「話す」に戻った時)に送ります。動画を受ける口は 2026-11-07 の夕方に足したので、それより前に入れた seed の seed home は動画を受けません。PC で seed を新しくし(git pull の後に pip install -e ".[app,server]")、seed home を Ctrl+C で止めて、もう一度 seed home を打ちます。写真が届いているなら、写真と動画は同じ 8800 番を通るので、PC の防火壁は原因ではありません
「動画 n 本は PC に断られました(大きすぎる等)…」 一本 2 GB より大きい動画か、動画を受けない古い seed home に送った時です。断られた動画は送り直しません。Android ならスマートフォンの Pictures/seed から PC に写し、PC のアプリの「写真・動画・zip を選ぶ」で入れます(§5)
「位置を待っています…」でシャッターが押せない、「位置が許されていません(端末の設定)。」 空の見える所で待ち、上の端の位置の印を押して取り直します。許されていない時は、スマートフォンの設定で seed に位置を許します
「カメラを開けません(端末の設定)。」 スマートフォンの設定で seed にカメラを許し、「カメラを開く」を押します
「zip を開けませんでした(…)。」 壊れた zip か、大きすぎる zip です(中の一つ 4 GB、取り出す全体 16 GB、2,000 個まで)。分けて zip にし直すか、写真と動画をそのまま選びます
「seed home にはサーバーの部品が要ります…」 seed のフォルダーで pip install -e ".[server]" を打ちます(§11b)
そのほか Discord の #seed か、GitHub の Issues( https://github.com/aiseed-dev/seed/issues )

変更の記録