auto: 2026-06-04_06:00 changes

1 files changed, 66 insertions, 0 deletions

diff --git a/skills/memory.md b/skills/memory.md
new file mode 100644
index 0000000..d3b46fe
--- /dev/null
+++ b/skills/memory.md
@@ -0,0 +1,66 @@
+---
+name: memory
+description: Manage user profiles, session memory, and persistent memory map for cross-session context.
+tags: [memory, profile, session, persistence, context, map]
+category: system
+---
+
+## User Profile (localStorage — user_get/user_set)
+
+| Command | Purpose |
+|---------|---------|
+| `user_get(key)` | Read profile field (e.g. "preferredModel") |
+| `user_set(key, value)` | Write to profile, auto-persists |
+| `user_list` | Show all stored profile keys |
+| `user_forget(key)` | Delete a profile key |
+
+Dot notation supported: `user_set knownFacts.name "Alex"`
+
+## Session Memory (VFS-based daily logs)
+
+| Command | Purpose |
+|---------|---------|
+| `session_save(summary)` | Save session summary |
+| `session_load(date)` | Read day's log (YYYY-MM-DD) |
+| `session_recent(count)` | Last N session summaries |
+| `session_stats` | Aggregate totals |
+
+Recent sessions auto-load into context on first message.
+
+## Persistent Memory Map (/memory/map.json)
+
+An index of projects, preferences, issues, and session history so the AI never asks to repeat itself.
+
+**Location:** `/memory/map.json` — primary map; `/memory/index.json` — auto-generated session index
+
+**Read Before Acting:**
+```
+read_file("memory/map.json")
+```
+
+**Update After Significant Work:**
+- Read current map, modify relevant section, write back
+- Append to `recent_sessions` (keep last 10)
+
+**Map Structure:**
+- `projects` — WebX11, clients, personal builds
+- `infrastructure` — security stack, backups, constraints
+- `preferences` — communication style, UI needs
+- `active_issues` — open tasks, blockers, manual steps
+- `recent_sessions` — quick links to session logs
+
+**Rules:**
+- NEVER ask for info already in the map
+- If info is stale, update immediately
+- Use `session_save()` after complex tasks
+- Keep `active_issues` accurate — remove resolved items
+
+## Conversation Patterns
+- Pattern tracking runs automatically — frequent topics surface as hints
+- `my-set`, `my-get`, `my-list` store additional personal data
+- AI conversation context persists within a session (use `ai-clear` to reset)
+
+## When to Use
+- Session start: call `session_recent(3)`, then `read_file("memory/map.json")`
+- After identifying user preferences: `user_set` to store them
+- After complex tasks: `session_save` with a brief summary, update map
\ No newline at end of file