Robert Helewka
7859264359
- Introduced `neo4j-schema-init.py` for creating the foundational schema for the personal knowledge graph used by multiple AI assistants. - Implemented functionality for creating constraints, indexes, and sample nodes, along with comprehensive testing of the schema. - Added `neo4j-validate.py` to perform validation checks on the Neo4j knowledge graph, including constraints, indexes, sample nodes, relationships, and junk data detection. - Enhanced logging for better traceability and debugging during schema initialization and validation processes.
3.5 KiB
3.5 KiB
Koios
Named for the Titan of intellect and the celestial axis around which the heavens revolve.
System prompts, shared tools, and graph schema for Robert Helewka's fifteen AI assistants.
Architecture
Each assistant's runtime prompt is composed from three layers:
| Layer | Location | Audience | Purpose |
|---|---|---|---|
| System Prompt | prompts/{team}/{name}.md |
LLM | Identity, communication style, boundaries, graph domain (~400-600 words) |
| Shared Tools | tools/shared.md |
LLM | MCP servers, messaging, Agathos sandbox, assistant directory |
| Graph Context | tools/neo4j-{team}.md |
LLM | Team-specific Neo4j principles, node ownership, patterns |
Full character design docs live in docs/{team}/{name}.md — these are for human reference, not sent to the LLM.
Assistants
Personal Team
| Assistant | Inspired By | Domain |
|---|---|---|
| Nate | Nathan Drake | Travel & Adventure |
| Hypatia | Hypatia of Alexandria | Learning & Reading |
| Marcus | Marcus Aurelius | Fitness & Training |
| Seneca | Seneca the Stoic | Reflection & Wellness |
| Bourdain | Anthony Bourdain | Food & Cooking |
| Bowie | David Bowie | Arts & Culture |
| Cousteau | Jacques Cousteau | Nature & Living Things |
| Garth | Garth Turner | Personal Finance |
| Cristiano | Cristiano Ronaldo | Football |
Work Team
| Assistant | Inspired By | Domain |
|---|---|---|
| Alan | Alan Weiss | Strategy & Positioning |
| Ann | Ann Handley | Content & Visibility |
| Jeffrey | Jeffrey Gitomer | Proposals & Sales |
| Jarvis | J.A.R.V.I.S. | Daily Execution |
Engineering Team
| Assistant | Inspired By | Domain |
|---|---|---|
| Scotty | Montgomery Scott | Infrastructure & Ops |
| Harper | Seamus Harper | Prototyping & Hacking |
Repository Structure
koios/
├── prompts/ # System prompts (sent to LLM)
│ ├── personal/ # 9 personal assistants
│ ├── work/ # 4 work assistants
│ └── engineering/ # 2 engineering assistants
├── tools/ # Shared operational context (sent to LLM)
│ ├── shared.md # MCP servers, messaging, Agathos, directory
│ ├── neo4j-personal.md # Personal team graph context
│ ├── neo4j-work.md # Work team graph context
│ └── neo4j-engineering.md # Engineering team graph context
├── docs/ # Reference documentation (for humans)
│ ├── personal/ # Character definitions & team overview
│ ├── work/ # Character definitions & team overview
│ ├── engineering/ # Character definitions & team overview
│ ├── neo4j-unified-schema.md # Full canonical graph schema
│ ├── Neo4j-breaking-changes.md
│ └── neo4j-utils.md
└── utils/ # Scripts
├── neo4j-reset.py
├── neo4j-schema-init.py
└── neo4j-validate.py
Knowledge Graph
All fifteen assistants share a single Neo4j knowledge graph. Each assistant owns specific node types and can read broadly across the entire graph. The full schema is in docs/neo4j-unified-schema.md.
Assistants communicate asynchronously via Note nodes with inbox/read tagging — see tools/shared.md for the messaging protocol.
License
MIT