flowchart LR
S["種まき<br>quarto use template"] --> B["育苗箱で育てる<br>concepts/*.qmd + okf/ バンドル"]
B --> L["検査・間引き<br>validate-okf リンター"]
L --> T["双葉が開く<br>HTML + 機械用バンドル"]
T --> D["畑へ移植<br>デプロイ / RAG / エージェント"]
Vision: なぜ「育苗箱」なのか
このツールを「育苗箱(seedling)」と呼んだ理由。知識を育て、大きくし、本番へ移植する設計思想を解釈する
Vision: なぜ「育苗箱(seedling)」なのか
このツールの名前は okf-seedling — 育苗箱(なえだねばこ)。なぜこんな名前なのか。機能だけを見れば分からない、このツールの「思い」を語ります。
育苗箱とは何か
育苗箱は、植物の種を蒔いて、本番の畑に移植できるまで守り育てる小さな箱です。嵐から守り、水をやり、育ちの悪い苗を間引き、やがて丈夫になった苗を大地へ移します。
大切なのは、育苗箱が「完成品の保管庫」ではないことです。箱は 育成の途中地点 であり、苗はここで育ち、最終的には箱の外の世界へ旅立ちます。
このツールへの写像
| 育苗箱の営み | okf-seedling の対応物 |
|---|---|
| 種を蒔く | quarto use template でバンドル雛形を生成(すべての発芽の起点) |
| 育苗箱で守る | okf/ バンドル + OKF 形式による、管理された生育環境 |
| 水やり・間引き・検査 | validate-okf リンター(準拠チェック + 鮮度・欠落の品質警告 = 苗の健康診断) |
| 育ちの記録・観察 | status: draft → stable、generated / verified / stale_after(生育記録) |
| 双葉が開く | 1 ソースから「人間用 HTML」と「機械用 OKF バンドル」の二系統出力 |
| 畑へ移植する | デプロイ(GitHub Pages / Cloudflare Pages)、RAG・エージェントへ受け渡す |
この名前が伝えたい「思い」
育苗箱という名前には、3 つの思いが込められています。
1. 知識は生き物であり、「育てる」ものである
ドキュメントを「作って放置する」のではなく、開いた芽を水をやりながら育て、必要なときに剪定し、実がなるところまで寄り添う。status や stale_after はその育成記録であり、リンターは毎日の健康観察です。
2. このツールは「完成品」ではなく「起点」である
育苗箱は苗のゴールではありません。知識の最終形は、その先の畑(公開サイト・RAG・エージェントの中)にあります。 ここでは小さな苗づくりを助けるものであり、「大きな成果物を作るための最初の一歩」を提供します。
3. 双葉は「人間と機械、両方に読まれて育つ」ことの象徴
苗木は最初に二枚の葉(双葉)を開きます。このツールも同じソースから二つの顔 — 人間の目で読む HTML と エージェントが読む OKF バンドル — を開きます。片方だけでは木になりません。両方の葉が開いて、はじめて知識はこの世界で育っていけるのです。
さいごに
育苗箱は、乱暴に言ってしまえば「ただの箱」です。しかし、その箱に土を入れて種をまき、水をやって光にあてることで、苗木は育ちます。あなたの知識は、どんな苗を育てたいですか?
- まだ芽も出ていない段階から始めるなら、0. What is OKF
- 実際に種をまくなら、1. Create a Bundle
- 育てた知識をエージェントに渡すなら、OKF × RAG Synergy