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.
83 lines
3.5 KiB
Markdown
83 lines
3.5 KiB
Markdown
# 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
|