Implement three-tier memory architecture (Hot/Vault/Handoff)
This commit replaces the previous memory_layers.py with a proper three-tier
memory system as specified by the user:
## Tier 1 — Hot Memory (MEMORY.md)
- Single flat file always loaded into system context
- Contains: current status, standing rules, agent roster, key decisions
- ~300 lines max, pruned monthly
- Managed by HotMemory class
## Tier 2 — Structured Vault (memory/)
- Directory with three namespaces:
• self/ — identity.md, user_profile.md, methodology.md
• notes/ — session logs, AARs, research
• aar/ — post-task retrospectives
- Markdown format, Obsidian-compatible
- Append-only, date-stamped
- Managed by VaultMemory class
## Handoff Protocol
- last-session-handoff.md written at session end
- Contains: summary, key decisions, open items, next steps
- Auto-loaded at next session start
- Maintains continuity across resets
## Implementation
### New Files:
- src/timmy/memory_system.py — Core memory system
- MEMORY.md — Hot memory template
- memory/self/*.md — Identity, user profile, methodology
### Modified:
- src/timmy/agent.py — Integrated with memory system
- create_timmy() injects memory context
- TimmyWithMemory class with automatic fact extraction
- tests/test_agent.py — Updated for memory context
## Key Principles
- Hot memory = small and curated
- Vault = append-only, never delete
- Handoffs = continuity mechanism
- Flat files = human-readable, portable
## Usage
All 973 tests pass.
2026-02-25 18:17:43 -05:00
|
|
|
# User Profile
|
|
|
|
|
|
|
|
|
|
> Learned information about the user. Updated continuously.
|
|
|
|
|
|
|
|
|
|
## Basic Information
|
|
|
|
|
|
2026-02-27 01:52:42 -05:00
|
|
|
**Name:** Not
|
Implement three-tier memory architecture (Hot/Vault/Handoff)
This commit replaces the previous memory_layers.py with a proper three-tier
memory system as specified by the user:
## Tier 1 — Hot Memory (MEMORY.md)
- Single flat file always loaded into system context
- Contains: current status, standing rules, agent roster, key decisions
- ~300 lines max, pruned monthly
- Managed by HotMemory class
## Tier 2 — Structured Vault (memory/)
- Directory with three namespaces:
• self/ — identity.md, user_profile.md, methodology.md
• notes/ — session logs, AARs, research
• aar/ — post-task retrospectives
- Markdown format, Obsidian-compatible
- Append-only, date-stamped
- Managed by VaultMemory class
## Handoff Protocol
- last-session-handoff.md written at session end
- Contains: summary, key decisions, open items, next steps
- Auto-loaded at next session start
- Maintains continuity across resets
## Implementation
### New Files:
- src/timmy/memory_system.py — Core memory system
- MEMORY.md — Hot memory template
- memory/self/*.md — Identity, user profile, methodology
### Modified:
- src/timmy/agent.py — Integrated with memory system
- create_timmy() injects memory context
- TimmyWithMemory class with automatic fact extraction
- tests/test_agent.py — Updated for memory context
## Key Principles
- Hot memory = small and curated
- Vault = append-only, never delete
- Handoffs = continuity mechanism
- Flat files = human-readable, portable
## Usage
All 973 tests pass.
2026-02-25 18:17:43 -05:00
|
|
|
**Location:** (unknown)
|
|
|
|
|
**Occupation:** (unknown)
|
|
|
|
|
**Technical Level:** (to be assessed)
|
|
|
|
|
|
|
|
|
|
## Interests & Expertise
|
|
|
|
|
|
|
|
|
|
- (to be learned from conversations)
|
|
|
|
|
|
|
|
|
|
## Preferences
|
|
|
|
|
|
|
|
|
|
### Communication
|
|
|
|
|
- Response style: (default: concise, technical)
|
|
|
|
|
- Detail level: (default: medium)
|
|
|
|
|
- Humor: (default: minimal)
|
|
|
|
|
|
|
|
|
|
### Tools
|
|
|
|
|
- Auto-tool usage: (default: minimal)
|
|
|
|
|
- Confirmation required for: shell commands, file writes
|
|
|
|
|
|
|
|
|
|
### Memory
|
|
|
|
|
- Personalization: Enabled
|
|
|
|
|
- Context retention: 20 messages (working), 100 (short-term)
|
|
|
|
|
|
|
|
|
|
## Important Facts
|
|
|
|
|
|
|
|
|
|
- (to be extracted from conversations)
|
|
|
|
|
|
|
|
|
|
## Relationship History
|
|
|
|
|
|
|
|
|
|
- First session: 2026-02-25
|
|
|
|
|
- Total sessions: 1
|
|
|
|
|
- Key milestones: (none yet)
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
2026-02-27 01:52:42 -05:00
|
|
|
*Last updated: 2026-02-27*
|