blob: 6f2e8060d5803aa2c971cce72dfae7f1f09043fc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
# Opencode Agents Memory Usage Guide
This document outlines how to use the memory directory for prioritization and
updates in opencode agents.
## Memory Directory Structure
The ~/memory directory contains several categories of information:
- **conversations/**: Detailed conversation logs with timestamps and topics
- **context/**: Personal context and AI assistant memories
- **projects/**: Current project documentation
- **reflections/**: Monthly reflection notes
- **light_metadata/**: Structured metadata like login history
## Agent Prioritization Strategy
### High Priority Information
1. **Recent conversations** - Check `conversations/` directory for latest
context
2. **Project documentation** - Review `projects/` for current work focus
3. **Personal context** - Read `context/` files for background knowledge
### Medium Priority Information
1. **Reflections** - Monthly notes in `reflections/` for ongoing insights
2. **Metadata** - Login history and user data in `light_metadata/`
## Memory Update Guidelines
### When to Update Memories
- After significant conversations with new context
- When completing projects or making progress on them
- When gaining new insights that should be preserved
- When discovering patterns or recurring themes
### How to Update
1. **Conversations**: Add new conversation files in `conversations/` following
the naming pattern `[timestamp]-[topic].md`
2. **Context**: Update `context/personal-context.md` with relevant background
information
3. **Projects**: Modify `projects/e-coop-application.md` with current status and
details
4. **Reflections**: Add entries to `reflections/` for monthly reflections
### Best Practices
- Keep conversation files focused on specific topics
- Use descriptive naming conventions for files
- Regularly review and organize memory content
- Avoid storing sensitive information in these files
- Maintain consistent formatting across all memory entries
## Agent Usage Patterns
### For Context Retrieval
When agents need background information, they should:
1. Check `context/personal-context.md` for personal background
2. Review recent conversation files in `conversations/` for current context
3. Look at project documentation in `projects/` for ongoing work
### For Pattern Recognition
Agents should:
1. Search through conversation logs to identify recurring themes
2. Analyze reflection notes for patterns in thinking or approaches
3. Use metadata from `light_metadata/` for access patterns and usage
This guide ensures consistent use of memory content across all opencode agents
while maintaining organization and prioritization.
|
