Personal Ontology
by @levineam
Help users build and maintain a Personal Ontology - a Palantir-style graph of Objects (identity, beliefs, predictions, goals) and Links (relationships between them) that enables AI-driven decision-making and life alignment.
clawhub install personal-ontologyπ About This Skill
name: personal-ontology description: Help users build and maintain a Personal Ontology - a Palantir-style graph of Objects (identity, beliefs, predictions, goals) and Links (relationships between them) that enables AI-driven decision-making and life alignment.
Personal Ontology Skill
A framework for organizing your life as a knowledge graph. Objects are the entities (beliefs, goals, projects). Links are the relationships between them (serves, supports, contradicts). The agent uses this graph to make decisions aligned with who you are.
Quick Start (Example)
You tell the agent: "Moltbot bootstrap personal ontology." It scans your notes, proposes candidate Objects (e.g., a Belief about AI, a Goal for health, a Project for a newsletter), and presents them for review - nothing is auto-committed.
You confirm or edit those candidates. The agent then creates/updates your ontology files and links Projects β Goals β Core Self, flagging any orphans or contradictions for your decision.
From that point on, the agent runs a light daily scan: it watches for new beliefs, predictions, goals, and projects, and surfaces only high-confidence candidates or conflicts so you stay aligned without extra maintenance.
The Object Hierarchy
Objects are organized from most abstract/stable to most concrete/changeable:
1. Higher Order - The highest organizing principle (God, universe, truth). Acknowledged, not defined. 2. Beliefs - Foundational assumptions about reality. What you hold to be true. *Generally unfalsifiable.* 3. Predictions - Your model of what will happen. *Testable, time-bound, updateable.* 4. Core Self - Who you are: Mission, Values, Strengths. 5. Goals - Time-bound objectives serving your Core Self. *Outcomes you want to achieve.* 6. Projects - Organized efforts toward goals. *Bounded work with beginning and end.* 7. Tasks - Atomic units of work. *(Live elsewhere: daily notes, Kanban, reminders.)*
Link Types
Every Object (except Higher Order) should link to other Objects. Standard link types:
| Link | Meaning | Example |
|------|---------|---------|
| serves | Directly supports an outcome | "This Project serves Goal X" |
| supports | Provides evidence/foundation for | "This Prediction supports Belief Y" |
| contradicts | In tension with | "This Belief contradicts Prediction Z" |
| relates-to | General association | "This Goal relates-to Value W" |
| depends-on | Requires for completion | "Project A depends-on Project B" |
| evolved-from | Updated version of | "Prediction 2.0 evolved-from Prediction 1.0" |
Validation rule: Every Project must serve at least one Goal. Every Goal must serve Core Self. Orphan Objects are flagged for review.
File Structure
Live ontology (canonical): [User's Notes Folder]/My_Personal_Ontology/
My_Personal_Ontology/
βββ 1-higher-order.md
βββ 2-beliefs.md
βββ 3-predictions.md
βββ 4-core-self.md
βββ 5-goals.md
βββ 6-projects.md
Each file contains multiple Objects of that type, each with a ## Links section.
Suggestions queue: Ontology_Suggestions.md
Use this file to capture all candidate updates (bootstrap + ongoing).
For AI Agents
Deployment Modes
Interactive Mode: Direct conversation. User asks for help, agent references ontology for context.
Embedded Mode: Agent uses ontology to inform all decisions without explicit reference.
Automated Mode: Passive scanning and maintenance without user prompting.
When to Reference the Ontology
1. Making decisions - Check proposed action against Values, Goals, Mission 2. Prioritizing - Use Goal hierarchy to rank options 3. Explaining - Connect tasks to higher purpose ("This serves your goal of...") 4. Flagging misalignment - "This task doesn't connect to any active Goal" 5. Surfacing insights - "Your Prediction about X has a time horizon of Q1 - any update?"
Integration Recipes (optional)
For users who want the ontology to shape daily behavior, integrate it into:
#### Adaptive prompts ("magic in the background")
If higher layers are missing (Higher Order, Predictions), do not nag daily. Instead:
memory/ontology-nudges.json).These can be implemented via scheduled prompts (cron) that read the ontology files + the user's task board/journal + the nudge state file.
How to Use It
1. Read Core Self first for value judgments
2. Read Goals for current priorities
3. Read Projects for tactical context
4. Read Beliefs/Predictions for worldview grounding
5. Reference explicitly when helpful ("This aligns with your mission to...")
6. Flag when something doesn't fit
Daily Passive Scan
Agents should perform a lightweight scan of recent activity to maintain the ontology.
What to Scan
Extraction Patterns
When scanning, look for these signals:
| Pattern | Candidate Object | |---------|------------------| | "I believe...", "I think...", "I'm convinced..." | Belief | | "I predict...", "By 20XX...", "will happen", "I expect..." | Prediction | | "My goal is...", "I want to achieve...", "I'm working toward..." | Goal | | "I'm working on...", "Project:", "I'm building..." | Project | | Mission statements, value lists, "What matters to me..." | Core Self |
When to Act
| Signal | Action | |--------|--------| | New Object candidate (high confidence) | Queue for user review | | New Object candidate (low confidence) | Note in daily memory, don't surface yet | | Existing Object contradicted | Surface immediately with evidence | | Prediction time horizon passed | Prompt for resolution | | Project completed | Prompt to update Goals |
Contradiction Detection
When new content conflicts with existing ontology: 1. Note the specific contradiction 2. Surface to user with both sides 3. Don't auto-resolve - user decides which to update 4. Track resolution in Prediction Log or Object history
Intelligence Layer
The ontology isn't just storage - it drives insights. Regularly surface:
Orphan Detection
Staleness Checks
Alignment Checks
Pattern Recognition
Review Cadence
Weekly (Agent-initiated)
Monthly (User-prompted)
Quarterly (Deep review)
Temporal Tracking
Objects evolve. Track when and why:
## History
2026-01-28: Created
2026-03-15: Updated based on [evidence/event]
2026-06-01: Marked resolved/completed
For Predictions specifically, track:
Setup
How to Run Bootstrap (User-Facing)
Say: "Moltbot bootstrap personal ontology."The agent will: 1) Scan your notes for candidate Objects 2) Present candidates for your review (no auto-commit) 3) Write/merge confirmed Objects into your ontology files
Default location (Obsidian): Vault v3/ontology/ (pretty-formatted, readable Markdown)
For New Users
1. Run the bootstrap process (seebootstrap.md) to extract candidate Objects from existing notes
2. Review and confirm/edit candidates
3. Work through prompts.md to fill gaps
4. Agent begins daily passive scansFor Existing Users
1. Copy templates to your ontology folder 2. Fill in what you know 3. Agent maintains and extends over timeReference Implementation
See templates/ for starter files. The user's ontology will be created in their notes folder.Files
SKILL.md - This file (agent instructions)heuristics.md - Rules for categorization and validationbootstrap.md - Initial extraction from existing vaultprompts.md - Guided questions for building each layertemplates/ - Starter files for each Object typeβοΈ Configuration
How to Run Bootstrap (User-Facing)
Say: "Moltbot bootstrap personal ontology."The agent will: 1) Scan your notes for candidate Objects 2) Present candidates for your review (no auto-commit) 3) Write/merge confirmed Objects into your ontology files
Default location (Obsidian): Vault v3/ontology/ (pretty-formatted, readable Markdown)
For New Users
1. Run the bootstrap process (seebootstrap.md) to extract candidate Objects from existing notes
2. Review and confirm/edit candidates
3. Work through prompts.md to fill gaps
4. Agent begins daily passive scans