Personal Knowledge Base (PKB)
This repository is a long-term personal knowledge system. The website is one optional consumer; not the source of truth.
Start here
- docs/KNOWLEDGE_SYSTEM.md
- docs/FILE_STRUCTURE.md
- docs/ENTITY_MODEL.md
- docs/RELATIONSHIP_MODEL.md
- docs/CONTENT_WORKFLOW.md
Layout
| Path | Role |
|---|
/knowledge | Canonical facts, narratives, identity, media, graph |
/docs | Operating manuals |
/data/imports | Original spreadsheets/exports (provenance) |
/scripts/knowledge | Validate + import |
/sites | Website consumer (presentation only) |
/discovery | Agent docs served at root URLs via vercel.json rewrites (/auth.md, /openapi.json, /pricing.md, ...) |
/api, /agent, middleware.js | Serverless endpoints, negotiation, agent mode |
Principles
- One fact, one place
- Reference by entity
id; never duplicate
- Evidence over marketing language
- Uncertain identity data →
/knowledge/review, never silent delete
Commands
npm run validate
npm run build:site
npm run qa
npm run check:agent
npm run local
npm start
node scripts/build-home.js
npm run build:collections
Adding work, books, people, essays, and policy case studies: docs/workflows/ADDING_LIFE_CONTENT.md.
Browse the homepage at / under npm run local. Public site: https://life.ayushrai.site/. Developer portal: https://life.ayushrai.site/developers/.
Agent skills (skills.sh)
npx skills add ayushrai-hub/LifeOS
See skills/README.md.
SDK / CLI packages
Publish with owner registry auth (npm publish / python -m build && twine upload).
Website consumer
The site is a knowledge graph in HTML: no mega-menu, inline blue links, multiple resumes and portfolios, domain pages, certifications, and media entities. Edit data/site-catalog.json, then run npm run build:site.
Deploy (Vercel)
middleware.js rewrites / → sites/www/ and 308s /sites/www → /
vercel.json maps root agent URLs to files in discovery/
- Content chronology lives in knowledge entities +
knowledge/_system/site-status.yaml
Identity spreadsheet
Drop the master online-presence file into data/imports/ and run the import script.
Filling personal data
Provide biography facts, work dates, certifications, and resume details. Until then, entity sections stay empty on purpose; nothing is invented.