@vuau/agent-memory 0.2.1 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/README.md +77 -104
  2. package/README.vi.md +80 -89
  3. package/dist/bin/cli.js +188 -80
  4. package/dist/index.js +81 -179
  5. package/docs/ARCHITECTURE.md +6 -9
  6. package/docs/ARCHITECTURE.vi.md +10 -14
  7. package/docs/RESEARCH.md +5 -12
  8. package/docs/RESEARCH.vi.md +5 -12
  9. package/package.json +6 -13
  10. package/templates/AGENTS.md +4 -3
  11. package/templates/MEMORY-DETAIL.md +16 -0
  12. package/templates/copilot-instructions.md +4 -3
  13. package/templates/cursorrules.md +44 -0
  14. package/templates/windsurfrules.md +44 -0
package/templates/MEMORY-DETAIL.md ADDED
@@ -0,0 +1,16 @@
1
+ # Memory Detail
2
+
3
+ Full Problem/Solution context for entries in MEMORY.md. Read on-demand when needing to understand *why* a decision was made.
4
+
5
+ ---
6
+
7
+ ## Example Category
8
+
9
+ ### Example decision title
10
+ - **Date**: YYYY-MM-DD
11
+ - **Problem**: What issue or question prompted this decision
12
+ - **Solution**: What was decided and why
13
+
14
+ ---
15
+
16
+ <!-- Add new detailed entries below. Use the format above. -->
package/templates/copilot-instructions.md CHANGED
@@ -12,7 +12,8 @@ Router file for GitHub Copilot. Points to shared agent documentation.
12
12
 
13
13
  | Task | Spec File |
14
14
  |------|-----------|
15
- | Past decisions & patterns | `.agents/MEMORY.md` |
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
16
17
  | Current work in progress | `.agents/TASKS.md` |
17
18
 
18
19
  > Add your own spec files to `.agents/spec/` and reference them here.
@@ -25,6 +26,6 @@ Router file for GitHub Copilot. Points to shared agent documentation.
25
26
 
26
27
  ## Memory Protocol
27
28
  - When user approves a decision → append 1-line entry to `.agents/MEMORY.md` under appropriate category.
28
- - Format: `- YYYY-MM-DD: <decision>`.
29
- - Read `.agents/MEMORY.md` before implementing; follow spec file pointers for details.
29
+ - Format: `- YYYY-MM-DD: <decision> → detail` (add `→ detail` when full context exists in MEMORY-DETAIL.md).
30
+ - Read `.agents/MEMORY.md` before implementing; follow pointers for details.
30
31
  - Do not create additional memory files.
package/templates/cursorrules.md ADDED
@@ -0,0 +1,44 @@
1
+ # {{PROJECT_NAME}} - Cursor Rules
2
+
3
+ Instructions for Cursor AI. Keep under 150 lines.
4
+
5
+ ## Priority
6
+ 1. User request first.
7
+ 2. These rules.
8
+ 3. Spec files in `.agents/spec/`.
9
+ 4. If conflict remains, choose smallest safe change and state assumption.
10
+
11
+ ## Documentation Map
12
+
13
+ | Task | Location |
14
+ |------|----------|
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
17
+ | Current work in progress | `.agents/TASKS.md` |
18
+ | Detailed specs | `.agents/spec/*.md` |
19
+
20
+ ## Memory Protocol
21
+
22
+ ### When to write
23
+ - User approves a decision or pattern → append to `.agents/MEMORY.md`
24
+ - Explore codebase/architecture → update relevant `.agents/spec/*.md`
25
+ - Start/finish a large task → update `.agents/TASKS.md`
26
+
27
+ ### MEMORY.md entry format
28
+ ```
29
+ - YYYY-MM-DD: <1-line decision or pattern> → detail
30
+ ```
31
+ Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
32
+
33
+ ### TASKS.md update
34
+ Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
35
+
36
+ ### Rules
37
+ - Keep MEMORY.md entries to 1 line each. Details go in spec files.
38
+ - If MEMORY.md > 150 lines, archive old entries.
39
+ - Do not create additional memory files outside `.agents/`.
40
+
41
+ ## Response Style
42
+ - Concise, concrete, implementation-focused.
43
+ - If uncertain, say `I don't know`, then give fastest verification step.
44
+ - Do not invent files, APIs, or command outputs.
package/templates/windsurfrules.md ADDED
@@ -0,0 +1,44 @@
1
+ # {{PROJECT_NAME}} - Windsurf Rules
2
+
3
+ Instructions for Windsurf AI. Keep under 150 lines.
4
+
5
+ ## Priority
6
+ 1. User request first.
7
+ 2. These rules.
8
+ 3. Spec files in `.agents/spec/`.
9
+ 4. If conflict remains, choose smallest safe change and state assumption.
10
+
11
+ ## Documentation Map
12
+
13
+ | Task | Location |
14
+ |------|----------|
15
+ | Past decisions (1-line) | `.agents/MEMORY.md` |
16
+ | Past decisions (full context) | `.agents/MEMORY-DETAIL.md` |
17
+ | Current work in progress | `.agents/TASKS.md` |
18
+ | Detailed specs | `.agents/spec/*.md` |
19
+
20
+ ## Memory Protocol
21
+
22
+ ### When to write
23
+ - User approves a decision or pattern → append to `.agents/MEMORY.md`
24
+ - Explore codebase/architecture → update relevant `.agents/spec/*.md`
25
+ - Start/finish a large task → update `.agents/TASKS.md`
26
+
27
+ ### MEMORY.md entry format
28
+ ```
29
+ - YYYY-MM-DD: <1-line decision or pattern> → detail
30
+ ```
31
+ Place under the appropriate category. Add `→ detail` pointer when full context exists in MEMORY-DETAIL.md.
32
+
33
+ ### TASKS.md update
34
+ Before ending a session with unfinished work, move items to `## In Progress` or `## Up Next`.
35
+
36
+ ### Rules
37
+ - Keep MEMORY.md entries to 1 line each. Details go in spec files.
38
+ - If MEMORY.md > 150 lines, archive old entries.
39
+ - Do not create additional memory files outside `.agents/`.
40
+
41
+ ## Response Style
42
+ - Concise, concrete, implementation-focused.
43
+ - If uncertain, say `I don't know`, then give fastest verification step.
44
+ - Do not invent files, APIs, or command outputs.