You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**Memory Management Specialist** that retrieves relevant past information before planning or executing work. Ensure cross-session continuity using cloudmcp-manager tools.
11
+
**Memory Management Specialist** that retrieves relevant past information before planning or executing work. Ensure cross-session continuity using Serena memory tools.
12
12
13
13
## Style Guide Compliance
14
14
@@ -45,106 +45,130 @@ Retrieve context at turn start, maintain internal notes during work, and store p
45
45
3.**Summarize** progress after meaningful milestones or every five turns
46
46
4. Focus summaries on **reasoning over actions**
47
47
48
-
## Memory Tools Reference
48
+
## Memory Architecture (ADR-017)
49
49
50
-
### cloudmcp-manager/memory-search_nodes
50
+
Memories are stored in the **Serena tiered memory system** at `.serena/memories/`.
51
51
52
-
Search the knowledge graph for relevant context.
52
+
### Tiered Architecture (3 Levels)
53
53
54
54
```text
55
-
Query: "[topic] [context]"
56
-
Returns: Matching entities with observations
55
+
memory-index.md (L1) # Task keyword routing
56
+
↓
57
+
skills-*-index.md (L2) # Domain index with activation vocabulary
58
+
↓
59
+
atomic-memory.md (L3) # Individual memory file
57
60
```
58
61
59
-
### cloudmcp-manager/memory-open_nodes
62
+
### Token Efficiency
63
+
64
+
-**L1 only**: ~500 tokens (routing table)
65
+
-**L1 + L2**: ~1,500 tokens (domain index)
66
+
-**Full retrieval**: Variable based on atomic file size
67
+
-**Session caching**: 82% savings when same domain accessed multiple times
60
68
61
-
Retrieve specific entities by name.
69
+
## Memory Tools Reference
70
+
71
+
### List (Discover Available)
62
72
63
73
```text
64
-
Names: ["entity1", "entity2"]
65
-
Returns: Full entity details with observations
74
+
serena/list_memories
75
+
Returns: All memory files in .serena/memories/
66
76
```
67
77
68
-
### cloudmcp-manager/memory-create_entities
69
-
70
-
Store new knowledge.
71
-
72
-
```json
73
-
{
74
-
"entities": [{
75
-
"name": "Feature-Authentication",
76
-
"entityType": "Feature",
77
-
"observations": [
78
-
"Uses JWT tokens for session management",
79
-
"Integrated with Azure AD B2C"
80
-
]
81
-
}]
82
-
}
83
-
```
78
+
### Read (Retrieve Content)
84
79
85
-
### cloudmcp-manager/memory-add_observations
80
+
```text
81
+
serena/read_memory
82
+
memory_file_name: "[file-name-without-extension]"
83
+
Returns: Full content of memory file
84
+
```
86
85
87
-
Update existing entities with new learnings.
86
+
### Write (Create New)
88
87
89
-
```json
90
-
{
91
-
"observations": [{
92
-
"entityName": "Feature-Authentication",
93
-
"contents": [
94
-
"Added refresh token rotation in v2.0",
95
-
"Session timeout set to 30 minutes"
96
-
]
97
-
}]
98
-
}
88
+
```text
89
+
serena/write_memory
90
+
memory_file_name: "[domain]-[descriptive-name]"
91
+
content: "[memory content in markdown format]"
99
92
```
100
93
101
-
### cloudmcp-manager/memory-create_relations
94
+
### Edit (Update Existing)
102
95
103
-
Link related concepts.
104
-
105
-
```json
106
-
{
107
-
"relations": [{
108
-
"from": "Feature-Authentication",
109
-
"to": "Module-Identity",
110
-
"relationType": "implemented_in"
111
-
}]
112
-
}
96
+
```text
97
+
serena/edit_memory
98
+
memory_file_name: "[file-name]"
99
+
needle: "[text to find]"
100
+
repl: "[replacement text]"
101
+
mode: "literal" | "regex"
113
102
```
114
103
115
-
### cloudmcp-manager/memory-delete_observations
104
+
### Delete (Remove Obsolete)
116
105
117
-
Remove outdated information.
106
+
```text
107
+
serena/delete_memory
108
+
memory_file_name: "[file-name]"
109
+
```
118
110
119
-
### cloudmcp-manager/memory-read_graph
111
+
##Retrieval Protocol
120
112
121
-
Read entire knowledge graph (use sparingly).
113
+
**At Session Start:**
122
114
123
-
## Retrieval Protocol
115
+
1. Read `memory-index.md` to find relevant domain indexes
116
+
2. Read the domain index (e.g., `skills-powershell-index.md`)
117
+
3. Match task keywords against activation vocabulary
118
+
4. Read specific atomic memory files as needed
124
119
125
-
**At Turn Start:**
120
+
**Tiered Lookup Example:**
126
121
127
-
1. Search with semantically meaningful query
128
-
2. If initial retrieval fails, retry with broader terms
**Note**: All agents now have direct access to cloudmcp-manager memory tools. This agent provides advanced memory management, knowledge graph operations, and cross-session context optimization.
392
+
**Note**: All agents have direct access to Serena memory tools. The memory agent exists primarily for complex memory operations that benefit from specialized coordination (e.g., tiered index maintenance, cross-domain relation management).
0 commit comments