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