chore: scaffold IdentityDB package tooling

README.md

@@ -1,3 +1,28 @@
 # IdentityDB
 
-Memory database for Artificial Personality
+IdentityDB is a TypeScript package for building structured AI memory on top of relational databases.
+
+## What it is
+
+IdentityDB stores memory as a graph made of:
+
+- **Topics** — named nodes such as `TypeScript`, `programming language`, `2025`, or `I`
+- **Facts** — statements that connect multiple topics
+- **Fact-topic links** — the relationships that turn one fact into a bridge between many topics
+
+A single fact like `I have worked with TypeScript since 2025.` can connect the topics `I`, `TypeScript`, and `2025` at the same time.
+
+## Foundation scope
+
+The first implementation pass focuses on:
+
+- SQLite, PostgreSQL, MySQL, and MariaDB adapters
+- Automatic schema initialization
+- High-level APIs for topics and facts
+- Pluggable ingestion so callers can use a small LLM to extract topics from free-form statements
+
+## Current status
+
+This repository is in active foundation development.
+
+See `docs/plans/2026-05-11-identitydb-foundation.md` for the current implementation plan.