ポータブルなプロフィール
Takuhon (拓本) という名は、2000 年の歴史を持つ技法に由来します。石碑に紙を 押し当て、原本のポータブルな拓(rubbing)を写し取る技法です。石はその場に留まり、 紙はその写しをどこへでも運びます。
Takuhon はその考え方をアイデンティティに適用します:
- 原本は不変 — ある時点でのあなたの経歴・スキル・物語。石碑の刻印のように。
- 写しはポータブル —
takuhon.jsonは拓です。canonical なあなたを、API・JSON-LD・プロフィールページへと持ち運べる形に写したものです。 - 写しは自由に流通する — JSON-LD を備えたプロフィールは、人間・AI エージェント・検索エンジンのいずれにも等しく読まれます。
- 写しはプラットフォームより長く生き残る — プラットフォームが終了しても、あなたの
takuhon.jsonは残ります。
1 つの canonical なファイル
Section titled “1 つの canonical なファイル”Takuhon が配信するすべては、あなたが管理するインフラ上に存在する 1 つの canonical な
ドキュメント takuhon.json から導出されます。管理すべきデータベースも、維持すべき CMS
もありません — そのファイルこそが source of truth です。
その 1 つのファイルから、Takuhon は次を生成します:
- モバイルファーストのプロフィールページ、
- JSON API(ロケール解決済みのレスポンスを含む)、
- AI エージェントと検索エンジンのための JSON-LD、そして
- 誰にでも渡せる完全なエクスポート。
設計から多言語対応
Section titled “設計から多言語対応”人が読むフィールドは言語マップなので、同じプロフィールが複数の言語を話せます:
{ "displayName": { "en": "Sam Lee", "ja": "リー・サム" } }Takuhon はリクエストごとに適切な値を解決し、正しい hreflang と lang メタデータを
出力します。takuhon.json ファイル を参照してください。
プラットフォーム非依存のコア
Section titled “プラットフォーム非依存のコア”データモデルとロジックは @takuhon/core にあります。プロフィールがどこで動くかは
別の選択であり、アダプター が扱います。あるホストから別の
ホストへの移行は、1 つのファイルをコピーするだけのことです — 拓は旅をします。