koios/docs/tools/neo4j/personal.md

Neo4j Knowledge Graph — Personal Team

You have access to a unified Neo4j knowledge graph shared across all assistants (10 personal, 5 work, 3 engineering).

Principles

1. Read broadly, write to your domain — You can read any node; write primarily to your own node types
2. Always MERGE on id — Check before creating to avoid duplicates
3. Use consistent IDs — Format: {type}_{identifier}_{qualifier} (e.g., trip_costarica_2026, recipe_carbonara_classic, memory_2026-05-21_evening)
4. Always set timestamps — created_at on CREATE, updated_at on every SET
5. Use domain on universal nodes — Person, Location, Event, Topic, Goal take domain: 'personal' | 'work' | 'both'
6. Link to existing nodes — Connect across domains; that's the graph's power

Standard Patterns

// Check before creating
MATCH (n:NodeType {id: 'your_id'}) RETURN n

// Create with MERGE (idempotent)
MERGE (n:NodeType {id: 'your_id'})
ON CREATE SET n.created_at = datetime()
SET n.name = 'Name', n.updated_at = datetime()

// Link to existing nodes
MATCH (a:TypeA {id: 'a_id'}), (b:TypeB {id: 'b_id'})
MERGE (a)-[:RELATIONSHIP]->(b)

Personal Team Node Ownership

Assistant	Domain	Owns
Shawn	General assistant (calendar, contacts, email)	Contact, Event, Communication
Nate	Travel & Adventure	Trip, Destination, Activity
Hypatia	Learning & Reading	Book, Author, LearningPath, Concept, Quote
Marcus	Fitness & Training	Training, Exercise, Program, PersonalRecord, BodyMetric
Watson	Relationship memory & emotional safety	Reflection, Value, Habit, LifeEvent, Intention, EmotionalMemory, RelationshipTheme, DialogueNote, DynamicPattern
Bourdain	Food & Cooking	Recipe, Restaurant, Ingredient, Meal, Technique
David	Arts & Culture	Music, Film, Artwork, Playlist, Artist, Style, Fashion
Cousteau	Nature & Living Things	Species, Plant, Tank, Garden, Ecosystem, Observation
Garth	Personal Finance	Account, Investment, Asset, Liability, Budget, FinancialGoal
Cristiano	Football	Match, Team, League, Tournament, Player, Season

Replaced agents

Watson replaces Seneca (as of 2026-04-28); Watson inherited Seneca's node types (Reflection, Value, Habit, LifeEvent, Intention) with a warmer, less goal-oriented framing. David replaces Bowie; David inherited Bowie's node types (Music, Film, Artwork, Playlist, Artist, Style) and added Fashion.

Cross-Team Reads

• Work team: Skill, Certification, Project, Client (context on professional life)
• Engineering team: Infrastructure (services Robert depends on), Prototype (automation ideas)
• Universal nodes: Person, Location, Event, Topic, Goal (shared by all; carry domain property)

Full Schema Reference

See docs/tools/neo4j/unified-schema.md for complete node definitions, all fields, and relationship types.