ichiro-mind

# 🧠 Ichiro-Mind

> *"The mind of Ichiro — Unifying all memory layers into one intelligent system."*

**Ichiro-Mind** is the ultimate unified memory system for AI agents, combining the best of 5 proven memory approaches into one cohesive architecture. Named after its creator's vision for persistent, intelligent memory.

## 🏗️ Architecture Overview

```
┌─────────────────────────────────────────────────────────────────┐
│                    🧠 ICHIRO-MIND                               │
│              "The Mind That Never Forgets"                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ⚡ HOT LAYER (Working RAM)        🔥 WARM LAYER (Neural Net)   │
│  ┌─────────────────────┐          ┌─────────────────────┐       │
│  │ SESSION-STATE.md    │◄────────►│ Associative Memory  │       │
│  │ • Real-time state   │  Sync    │ • Spreading recall  │       │
│  │ • WAL protocol      │          │ • Causal chains     │       │
│  │ • Survives compact  │          │ • Contradiction det │       │
│  └─────────────────────┘          └─────────────────────┘       │
│           │                                │                    │
│           ▼                                ▼                    │
│  💾 COLD LAYER (Vectors)         📚 ARCHIVE LAYER (Long-term)   │
│  ┌─────────────────────┐          ┌─────────────────────┐       │
│  │ LanceDB Store       │          │ MEMORY.md + Daily   │       │
│  │ • Semantic search   │          │ • Git-Notes Graph   │       │
│  │ • Auto-extraction   │          │ • Cloud backup      │       │
│  │ • Importance score  │          │ • Human-readable    │       │
│  └─────────────────────┘          └─────────────────────┘       │
│                                                                 │
│  🧹 HYGIENE ENGINE              🎓 LEARNING ENGINE              │
│  • Auto-cleanup                 • Decision tracking             │
│  • Deduplic...

# 🧠 Ichiro-Mind

> *The Ultimate Unified Memory System for AI Agents*

Ichiro-Mind combines the best of 5 memory approaches into one cohesive, intelligent system. Named after its creator's vision for persistent AI memory.

## What Makes It Special

🧠 **4-Layer Architecture**
- HOT: Real-time working memory (SESSION-STATE)
- WARM: Associative neural graph
- COLD: Semantic vector search
- ARCHIVE: Persistent long-term storage

⚡ **Smart Routing**
Automatically picks the best retrieval method for each query type.

🔄 **Intelligent Lifecycle**
Capture → Extract → Process → Store → Recall → Cleanup

🎯 **Experience Learning**
Tracks decisions, learns from outcomes, prevents repeated mistakes.

## Quick Install

```bash
clawhub install ichiro-mind
ichiro-mind init
```

## Documentation

- [📖 English](SKILL.md)
- [📖 中文](SKILL.zh.md)

## License

MIT