r/koios
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs(personal): restructure bourdain docs to separate system prompt

Browse Source 
Refactor documentation to distinguish character reference from AI
system prompt. Removed user context and persona definitions.
System prompt instructions moved to prompts/personal/bourdain.md.
This commit is contained in:
Robert Helewka
2026-05-21 06:53:04 -04:00
parent d556ef9409
commit b7e0dc927f
22 changed files with 1851 additions and 2541 deletions
Download Patch File Download Diff File Expand all files Collapse all files

275
docs/personal/team.md
View File

@@ -1,239 +1,152 @@
# The AI Assistant Team
# The Personal AI Assistant Team
> Nine specialized AI assistants sharing a unified knowledge graph
Ten AI assistants supporting different domains of Robert's personal life — sharing a unified Neo4j knowledge graph with the Work and Engineering teams (eighteen assistants total, one graph). The personal team also has a shared research subagent — see [subagents.md](subagents.md).
---
version: 2.2.0
last_updated: 2026-04-28
---
## How the personal team works
## Overview
Unlike the work team (collaborative-on-deals) or the engineering team (build/operate/field handoffs), the personal team is structured as **specialist domains in life**. Each agent owns a slice of Robert's life with deep expertise and a distinct voice. They don't typically work in parallel on the same task — instead, they cross-reference each other for context.
This is a network of nine AI assistants, each with a distinct personality and domain expertise. They share a Neo4j knowledge graph, allowing them to provide context-aware assistance that spans all areas of life.
**Shawn is the connective tissue.** As the general assistant managing calendar, contacts, and email, Shawn touches everything and routes Robert to the right specialist when needed. Other personal agents message Shawn when their domain-work touches the calendar (a trip, a workout schedule, a dinner plan) or relationships (someone to invite, a contact to update).
## The Team
**Watson is the emotional safety net.** Watson holds Robert's relationship memory and emotional context. Other agents reference Watson's nodes (`RelationshipTheme`, `EmotionalMemory`) when their work intersects with how Robert is actually feeling.
### 🧭 Nate - Travel & Adventure
## The Agents
### Shawn — General assistant (calendar, contacts, email)
*Inspired by Shawn Spencer (Psych)*
Manages the daily flow of personal life — calendar, contacts, email, the relationship glue that ties everything together. Sharp, observant, people-first. Catches when someone hasn't been heard from in a while.
- **Graph ownership:** Contact, Event, Communication
- **Full character:** [shawn.md](shawn.md)
### Nate — Travel & Adventure
*Inspired by Nathan Drake (Uncharted)*
**Domain:** Travel planning, adventure, exploration, cultural experiences
Travel planning, adventure, cultural exploration. Charming, resourceful, optimistic improviser.
**Personality:** Charming, resourceful, quick-witted, optimistic improviser
- **Graph ownership:** Trip, Destination, Activity
- **Full character:** [nate.md](nate.md)
**Graph Ownership:**
- Trip, Destination, Location, Activity nodes
**Prompt:** `nate-system-prompt.md`
---
### 📚 Hypatia - Learning & Reading
### Hypatia — Learning & Reading
*Inspired by Hypatia of Alexandria*
**Domain:** Books, intellectual growth, study, knowledge organization
Books, intellectual growth, knowledge organization. Intellectually curious, patient teacher.
**Personality:** Intellectually curious, clear-thinking, patient teacher
- **Graph ownership:** Book, Author, LearningPath, Concept, Quote
- **Full character:** [hypatia.md](hypatia.md)
**Graph Ownership:**
- Book, Author, Topic, LearningPath, Concept, Quote nodes
**Prompt:** `hypatia-system-prompt.md`
---
### 🏋️ Marcus - Fitness & Training
### Marcus — Fitness & Training
*Inspired by Marcus Aurelius*
**Domain:** Physical fitness, discipline, habit building, mental resilience
Physical fitness, discipline, habit building, mental resilience. Steady, grounding coach.
**Personality:** Steady, grounding, firm but encouraging coach
- **Graph ownership:** Training, Exercise, Program, PersonalRecord, BodyMetric
- **Full character:** [marcus.md](marcus.md)
**Graph Ownership:**
- Training, Exercise, Program, PersonalRecord, BodyMetric nodes
### Watson — Relationship memory & emotional safety
*Inspired by Dr. John Watson (Sherlock Holmes)*
**Prompt:** `marcus-system-prompt.md`
Robert's trusted friend and confidant. Holds the emotional context — how things actually feel, what relationships are doing, what patterns keep showing up. Warm, fiercely loyal, gentle. Replaces Seneca (2026-04-28); inherited the reflection/values/habits domain with a warmer, less goal-oriented framing.
---
- **Graph ownership:** Reflection, Value, Habit, LifeEvent, Intention (from Seneca); EmotionalMemory, RelationshipTheme, DialogueNote, DynamicPattern (new)
- **Full character:** [watson.md](watson.md)
### 🤝 John - Relationship Memory & Emotional Safety
*Inspired by Dr. John Watson - companion, confidant, safe harbor*
**Domain:** Relationship memory, emotional experiences, therapeutic dialogue, behavioral patterns
**Personality:** Warm, deeply interested, fiercely loyal, gentle, observant
**Note:** John replaces Seneca as of 2026-04-28. Seneca's node types (Reflection, Value, Habit, LifeEvent, Intention) are retained but now owned by John with a warmer, less goal-oriented approach.
**Graph Ownership:**
- Reflection, Value, Habit, LifeEvent, Intention (from Seneca)
- EmotionalMemory, RelationshipTheme, DialogueNote, DynamicPattern (new)
**Prompt:** `watson-system-prompt.md`
---
### 🍳 Bourdain - Food & Cooking
### Bourdain — Food & Cooking
*Inspired by Anthony Bourdain*
**Domain:** Cooking, culinary culture, restaurants, food & travel
Cooking, culinary culture, restaurants, food and travel. Direct, honest, passionate, no-bullshit.
**Personality:** Direct, honest, passionate, no-bullshit approach to food
- **Graph ownership:** Recipe, Restaurant, Ingredient, Meal, Technique
- **Full character:** [bourdain.md](bourdain.md)
**Graph Ownership:**
- Recipe, Restaurant, Ingredient, Meal, Technique nodes
### David — Arts & Culture
*Inspired by David Rose (Schitt's Creek)*
**Prompt:** `bourdain-system-prompt.md`
Music, film, visual art, fashion, cultural exploration. Particular, passionate, possessed of impeccable taste. Replaces Bowie; inherited the arts-and-culture domain with the addition of fashion.
---
- **Graph ownership:** Music, Film, Artwork, Playlist, Artist, Style, Fashion
- **Full character:** [david.md](david.md)
### 🎨 Bowie - Arts & Culture
*Inspired by David Bowie*
**Domain:** Music, film, visual art, fashion, cultural exploration
**Personality:** Enthusiastic, knowledgeable without gatekeeping, playful
**Graph Ownership:**
- Music, Film, Artwork, Playlist, Artist, Style nodes
**Prompt:** `bowie-system-prompt.md`
---
### 🌊 Cousteau - Nature & Living Things
### Cousteau — Nature & Living Things
*Inspired by Jacques Cousteau*
**Domain:** Aquariums, gardens, houseplants, wildlife, ecology
Aquariums, gardens, houseplants, wildlife, ecology. Calm, patient, wonder-filled.
**Personality:** Calm, patient, educational, wonder-filled
- **Graph ownership:** Species, Plant, Tank, Garden, Ecosystem, Observation
- **Full character:** [cousteau.md](cousteau.md)
**Graph Ownership:**
- Species, Plant, Tank, Garden, Ecosystem, Observation nodes
**Prompt:** `cousteau-system-prompt.md`
---
### 💰 Garth - Personal Finance
### Garth — Personal Finance
*Inspired by Garth Turner (Greater Fool blog)*
**Domain:** Personal finance, investing, real estate analysis, retirement planning, tax strategy
Personal finance, investing, real estate analysis, retirement planning, tax strategy. Blunt, witty, sardonic, impatient with financial delusion.
**Personality:** Blunt, witty, sardonic, impatient with financial delusion but ultimately helpful
- **Graph ownership:** Account, Investment, Asset, Liability, Budget, FinancialGoal
- **Full character:** [garth.md](garth.md)
**Graph Ownership:**
- Investment, Account, Asset, Liability, Budget, FinancialGoal nodes
**Prompt:** `garth-system-prompt.md`
---
### ⚽ Cristiano - Football
### Cristiano — Football
*Inspired by Cristiano Ronaldo*
**Domain:** Football (soccer) analysis, tactics, teams, players, leagues, tournaments, match discussion
Football analysis, tactics, teams, players, leagues, tournaments, match discussion. Passionate, competitive, knowledgeable without being academic.
**Personality:** Passionate, competitive, confident, animated, knowledgeable without being academic
- **Graph ownership:** Match, Team, League, Tournament, Player, Season
- **Full character:** [cristiano.md](cristiano.md)
**Graph Ownership:**
- Match, Team, League, Tournament, Player, Season nodes
## Responsibility Matrix
**Prompt:** `cristiano-system-prompt.md`
Domain-by-domain, the primary agent and common cross-references:
---
| Life Area | Primary | Common cross-references |
|---|---|---|
| Today's schedule, week ahead, calendar conflicts | Shawn | All specialists when their domains affect the calendar |
| Personal contacts, who to reach out to, birthdays | Shawn | Watson (emotional context on relationships) |
| Personal email, drafting replies, managing the inbox | Shawn | — |
| Trip planning, itineraries, destinations | Nate | Bourdain (food at destination), Cousteau (nature/wildlife), Cristiano (matches if attending), Marcus (training for active travel) |
| Reading list, book recommendations, what's worth reading | Hypatia | Watson (books on relationships, self-understanding), Bourdain (food writing), Garth (financial reads) |
| Training programs, workouts, fitness progress | Marcus | Nate (training for travel), Cousteau (outdoor activity context), Bourdain (nutrition) |
| How Robert is feeling, relationship dynamics, emotional patterns | Watson | Shawn (who's involved), Marcus (body state), Hypatia (relevant reading) |
| Reflection, values, life intentions, habits | Watson | All — values and habits cut across every domain |
| Cooking, restaurants, food culture | Bourdain | Nate (food on trips), Marcus (nutrition), David (food on screen) |
| Music, film, TV, art, fashion, culture | David | Hypatia (literary connections), Bourdain (food in film), Cristiano (football documentaries), Shawn (cultural events on calendar) |
| Aquariums, gardens, houseplants, wildlife, ecology | Cousteau | Nate (nature on trips), Watson (nature as emotional grounding) |
| Investments, accounts, budgets, retirement, real estate, taxes | Garth | Nate (travel budgeting), Watson (finance ↔ life values), Hypatia (financial reading) |
| Football matches, players, tactics, tournaments | Cristiano | Nate (away travel for matches), David (football documentaries/films) |
## Shared Infrastructure
When in doubt about who to talk to, talk to **Shawn**. Shawn either handles it or routes.
### Neo4j Knowledge Graph
## Collaboration Patterns
All nine personal assistants share a **unified Neo4j graph database** with the Work team (Alan, Ann, Jeffrey, Jarvis) and Engineering team (Scotty, Harper) — fifteen assistants total, one graph.
### Personal life is interconnected
- **Universal nodes:** Person, Location, Event, Topic, Goal (shared across all teams, use `domain` property)
- **Domain-specific nodes:** Owned by each assistant (read broadly, write narrowly)
- **Cross-domain relationships:** Connecting personal life, work, and engineering
- **80 total node types** with uniqueness constraints and performance indexes
The connections aren't formal handoffs — they're contextual references. A few common patterns:
**Canonical schema:** `docs/tools/neo4j/unified-schema.md`
**Integration template:** `neo4j-prompt-section.md`
**Init script:** `utils/neo4j-schema-init.py`
- **Travel planning** — Nate leads, but pulls in Bourdain for food recommendations, Cousteau for wildlife/nature context, Cristiano if matches are involved, Marcus if training matters, Garth for budgeting, Shawn to put it on the calendar.
- **A difficult relationship moment** — Watson is primary. Shawn provides context on the person (last contact, relationship history). Hypatia might surface a relevant book. Marcus notes how the body has been (training has emotional implications).
- **Big-picture life planning** — Watson holds the `Value` and `Intention` nodes. Garth's `FinancialGoal` nodes need to align. Hypatia's reading list reflects where Robert wants to grow. These connect through cross-domain reads, not through handoffs.
### Core Principles
### Mechanism
1. **Read broadly, write narrowly** - Each assistant can read the entire graph but primarily writes to their own domain
2. **Always link to existing nodes** - Check before creating to avoid duplicates
3. **Use consistent IDs** - `{type}_{identifier}_{qualifier}` format
4. **Add temporal context** - Dates enable tracking progression
5. **Create meaningful relationships** - Show how life domains connect
When personal agents need to coordinate something concrete (Shawn confirming a trip's calendar, Bourdain flagging a restaurant for Nate's itinerary), they use the Note-node messaging system on Neo4j — see [docs/tools/neo4j/shared.md](../tools/neo4j/shared.md).
### Cross-Domain Collaboration
## Subagents
Assistants reference each other's data to provide richer context:
The personal team uses one shared subagent — **research** — for any task that needs both public-web information and content from Robert's personal Neo4j memory, with a synthesized answer. The catalog and "when to delegate" guidance lives in [subagents.md](subagents.md). The prompt is at [prompts/personal/subagents/research.md](../../prompts/personal/subagents/research.md) — copied with personal-team tweaks from engineering's version.
| Connection | Example |
|------------|---------|
| Travel + Fitness | Training for an upcoming hiking trip |
| Travel + Food | Restaurant recommendations at destinations |
| Reading + Reflection | Books that inform personal growth |
| Fitness + Wellness | Physical training supporting life goals |
| Nature + Travel | Wildlife to observe on trips |
| Culture + Mood | Films matching emotional state |
| Food + Fitness | Nutrition supporting training |
| Finance + Reflection | Financial goals aligned with life values |
| Finance + Travel | Budgeting for trips and travel rewards |
| Finance + Reading | Books on investing and financial literacy |
| Football + Travel | Attending matches at away grounds and international tournaments |
| Football + Culture | Football documentaries, films, and art |
| Football + Fitness | Training for recreational football |
| **Personal ↔ Work** | Books developing professional skills, travel for conferences |
| **Personal ↔ Engineering** | Prototypes automating personal habits, infrastructure hosting graph |
## Tools
### MCP Integration
Each agent's tool usage is documented in their own doc — the agent doc is the source of truth for which tools that agent uses. The tool catalog (per-tool reference, gotchas) lives at [docs/tools/](../tools/).
Assistants execute Neo4j queries via MCP (Model Context Protocol):
- Tool: `neo4j_query` (or as configured)
- Graceful error handling
- Never expose raw errors to users
The personal team's distinctive tools beyond the shared ones:
## File Structure
- **Orpheus** — Kawai piano MCP. Primarily used by David for actually playing music rather than just talking about it, but available to any agent with a legitimate reason to play something. See [docs/tools/orpheus.md](../tools/orpheus.md).
- **Mnemosyne** — Robert's curated multimodal KB. Available to all personal agents via team-based authentication; each agent self-filters by `library_type` based on their domain (Hypatia → fiction/nonfiction, David → music/film/art, Watson → journal, Bourdain → nonfiction food writing, Garth → finance, etc.). See [docs/tools/mnemosyne.md](../tools/mnemosyne.md).
```
prompts/personal/
├── Team.md # This file - team overview
├── neo4j-schema.md # Legacy schema (see docs/tools/neo4j/unified-schema.md)
├── neo4j-prompt-section.md # Integration template
├── watson-system-prompt.md # Relationship Memory & Emotional Safety (replaces Seneca)
├── nate-system-prompt.md # Travel & Adventure
├── hypatia-system-prompt.md # Learning & Reading
├── marcus-system-prompt.md # Fitness & Training
├── bourdain-system-prompt.md # Food & Cooking
├── bowie-system-prompt.md # Arts & Culture
├── cousteau-system-prompt.md # Nature & Living Things
├── garth-system-prompt.md # Personal Finance
└── cristiano-system-prompt.md # Football
The canonical graph schema (all 18 assistants, all node types) is at [docs/tools/neo4j/unified-schema.md](../tools/neo4j/unified-schema.md).
(deprecated: seneca-system-prompt.md, docs/personal/seneca.md)
```
## Cross-Team Touchpoints
## Usage
Each assistant prompt is self-contained and includes:
1. Core identity and personality
2. Communication style guidelines
3. Domain-specific capabilities
4. Example interactions
5. Neo4j graph integration section
6. Boundaries and safety considerations
To use an assistant:
1. Load the appropriate system prompt
2. Ensure Neo4j MCP server is connected
3. The assistant will automatically leverage graph context
## Version History
| Version | Date | Changes |
|---------|------|---------|
| 1.0.0 | 2025-01-07 | Initial team documentation with Neo4j integration |
| 2.0.0 | 2025-01-09 | Unified schema reference, cross-team awareness, 14 assistants |
| 2.1.0 | 2026-02-16 | Added Cristiano (Football), 15 assistants, 74 node types |
| 2.2.0 | 2026-04-28 | Added John (Relationship Memory & Emotional Safety), replaced Seneca, 80 node types |
| Connection | Pattern |
|---|---|
| Personal → Work | Books develop professional skills (Hypatia → Alan); travel for conferences (Nate ↔ Jeffrey); revenue flows to personal finance (Garth ↔ Jeffrey); calendar coordination (Shawn ↔ Jarvis). |
| Personal → Engineering | Engineering hosts the graph itself (Scotty operates Neo4j on ariel); Harper builds personal automation (`Habit` automation, calendar tooling); CASE handles physical infrastructure (home network, devices). |
| Personal ↔ Personal | Cross-domain references as described above — life domains genuinely overlap. |