init

docs/DOCS.md

@@ -0,0 +1,66 @@
+# aigpt docs
+
+## Overview
+
+MCP server for AI memory. Reads/writes core.md and memory.md. Nothing more.
+
+## Design
+
+- AI decides, tool records
+- File I/O only, no database
+- 4 MCP tools: read_core, read_memory, save_memory, compress
+- Simple, unbreakable, long-lasting
+
+## MCP Tools
+
+| Tool | Args | Description |
+|------|------|-------------|
+| read_core | none | Returns core.md content |
+| read_memory | none | Returns memory.md content |
+| save_memory | content: string | Overwrites memory.md |
+| compress | conversation: string | Reads memory.md + conversation, writes compressed result to memory.md |
+
+compress note: AI decides what to keep/discard. Tool just writes.
+
+## Data
+
+```
+~/.config/aigpt/
+├── core.md      ← read only (identity, settings)
+└── memory.md    ← read/write (memories, grows over time)
+```
+
+## Architecture
+
+```
+src/
+├── mcp/server.rs   ← JSON-RPC over stdio
+├── core/reader.rs  ← read core.md, memory.md
+├── core/writer.rs  ← write memory.md
+└── main.rs         ← CLI + MCP server
+```
+
+## Compression Rules
+
+When compress is called, AI should:
+- Keep facts and decisions
+- Discard procedures and processes
+- Resolve contradictions (keep newer)
+- Don't duplicate core.md content
+
+## Usage
+
+```bash
+aigpt serve          # start MCP server
+aigpt read-core      # CLI: read core.md
+aigpt read-memory    # CLI: read memory.md
+aigpt save-memory "content"  # CLI: write memory.md
+```
+
+## Tech
+
+- Rust, MCP (JSON-RPC over stdio), file I/O only
+
+## History
+
+Previous versions (v0.1-v0.3) had multi-layer architecture with SQLite, Big Five personality analysis, relationship inference, gamification, and companion systems. Rewritten to current simple design. Old docs preserved in docs/archive/.