life.ayushrai.site docs MCP

個人ナレッジベース（PKB）

このリポジトリは、長期的に利用する個人ナレッジシステムです。ウェブサイトは任意の利用先の1つであり、情報の正本ではありません。

まずはこちら

1. docs/KNOWLEDGE_SYSTEM.md
2. docs/FILE_STRUCTURE.md
3. docs/ENTITY_MODEL.md
4. docs/RELATIONSHIP_MODEL.md
5. docs/CONTENT_WORKFLOW.md

構成

パス	役割
/knowledge	正規の事実、ナラティブ、アイデンティティ、メディア、グラフ
/docs	運用マニュアル
/data/imports	元のスプレッドシート／エクスポートデータ（来歴）
/scripts/knowledge	検証とインポート
/sites	ウェブサイトの利用先（表示のみ）
/discovery	vercel.json のリライトを介してルート URL で配信されるエージェント向けドキュメント（/auth.md、/openapi.json、/pricing.md、...）
/api、/agent、middleware.js	サーバーレスエンドポイント、ネゴシエーション、エージェントモード

原則

• 1つの事実は1か所に記載します
• エンティティの id で参照し、重複させません
• マーケティング表現より証拠を重視します
• アイデンティティデータに不確実性がある場合は /knowledge/review に移し、黙って削除しません

コマンド

npm run validate       # knowledge validation (Node)
npm run build:site     # generate resumes, portfolios, domains from data/site-catalog.json
npm run qa             # static QA (em dashes, viewport, catalog coverage); exits 1 on failure
npm run check:agent    # agent surface checks (negotiation, discovery, jobs, trust pages)
npm run local            # full local site on http://localhost:3000 (vercel dev: middleware, rewrites, api/)
npm start              # static-only preview (Python http.server; no rewrites or api/)
node scripts/build-home.js   # regenerate homepage from knowledge/_system/homepage.yaml
npm run build:collections    # work index, books, influences from knowledge/{work,books,influences}/*.json

職歴、書籍、人物、エッセイ、政策に関するケーススタディの追加方法：docs/workflows/ADDING_LIFE_CONTENT.md。

npm run local を実行して、/ からホームページを確認できます。公開サイト：https://life.ayushrai.site/。開発者ポータル：https://life.ayushrai.site/developers/。

エージェントスキル（skills.sh）

npx skills add ayushrai-hub/LifeOS

skills/README.md をご覧ください。

SDK／CLI パッケージ

• JavaScript：packages/life-ayushrai（life-ayushrai CLI）
• Python：packages/life_ayushrai

オーナーのレジストリ認証情報を使って公開します（npm publish ／ python -m build && twine upload）。

ウェブサイトの利用先

このサイトは HTML で表現したナレッジグラフです。巨大なメニューはなく、青色のインラインリンク、複数の履歴書とポートフォリオ、分野別ページ、認定資格、メディアエンティティを備えています。data/site-catalog.json を編集してから、npm run build:site を実行します。

デプロイ（Vercel）

• middleware.js は / を sites/www/ にリライトし、/sites/www を / に 308 リダイレクトします
• vercel.json はルートのエージェント URL を discovery/ 内のファイルに対応付けます
• コンテンツの時系列はナレッジエンティティと knowledge/_system/site-status.yaml で管理します

npx vercel

アイデンティティのスプレッドシート

本人のオンラインプレゼンスに関するマスターファイルを data/imports/ に入れ、インポートスクリプトを実行します。

個人データの入力

経歴に関する事実、職歴の期間、認定資格、履歴書の詳細を提供してください。それまでは、エンティティの各セクションは意図的に空のままにします。情報を捏造することはありません。