Add Neo4j schema initialization and validation scripts

- 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.

README.md

@@ -1,3 +1,82 @@
-# koios
+# Koios
 
-A curated collection of LLM system prompts for analysis, review, and reuse.
+> *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