Enhanced auto-memory with rich few-shot format
- Updated memory reminder prompt with per-symbol char ranges - Added two few-shot examples: Session Continuation (feature) + UTF-8 Safe Slicing (pattern) - Updated system prompt Memory Format section to match - Format: file -> nested symbols with [start..end] ranges and descriptions - Enables direct read_file navigation to specific functions
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
# Project Memory
|
||||
> Updated: 2026-01-12T09:14:13Z | Size: 10.5k chars
|
||||
> Updated: 2026-01-13T16:15:37Z | Size: 11.8k chars
|
||||
|
||||
### Remember Tool Wiring
|
||||
- `crates/g3-core/src/tools/memory.rs` [0..5000] - `execute_remember()`, `get_memory_path()`, `merge_memory()`
|
||||
@@ -172,10 +172,24 @@ if s.chars().count() <= max_len { ... }
|
||||
|
||||
### Project Memory Location
|
||||
- Memory is now stored at `analysis/memory.md` (version controlled, shared across worktrees)
|
||||
- Previously was at `.g3/memory.md` (gitignored, ephemeral)
|
||||
- `crates/g3-core/src/tools/memory.rs` - `get_memory_path()` returns `analysis/memory.md`
|
||||
- `crates/g3-cli/src/project_files.rs` - `read_project_memory()` reads from `analysis/memory.md`
|
||||
|
||||
### Compact Tool Output
|
||||
- `crates/g3-cli/src/ui_writer_impl.rs` - `print_tool_compact()` handles compact display for file ops and other tools
|
||||
- `crates/g3-core/src/streaming.rs` - `format_*_summary()` functions for each tool type
|
||||
|
||||
### Racket Code Search Support
|
||||
Tree-sitter based syntax-aware search for Racket `.rkt` files.
|
||||
|
||||
- `crates/g3-core/src/code_search/searcher.rs`
|
||||
- Racket parser init [~line 45] - `tree_sitter_racket::LANGUAGE`
|
||||
- Extension mapping [~line 90] - `.rkt`, `.rktl`, `.rktd` → "racket"
|
||||
|
||||
### Auto-Memory Reminder Format
|
||||
Rich few-shot prompting for higher quality memory entries with per-symbol char ranges.
|
||||
|
||||
- `crates/g3-core/src/lib.rs`
|
||||
- `send_auto_memory_reminder()` [47800..48800] - MEMORY CHECKPOINT prompt with few-shot examples
|
||||
- `crates/g3-core/src/prompts.rs`
|
||||
- Memory Format section [3800..4500] - system prompt template and examples
|
||||
@@ -1416,7 +1416,37 @@ impl<W: UiWriter> Agent<W> {
|
||||
debug!("Auto-memory: Sending reminder to LLM ({} tools called this turn: {:?})", tools_called.len(), tools_called);
|
||||
self.ui_writer.print_context_status("\nMemory checkpoint: ");
|
||||
|
||||
let reminder = "SYSTEM REMINDER: You used tools during this turn. If you discovered any key code locations, patterns, or entry points that aren't already in Project Memory, please call the `remember` tool now to save them. If you didn't discover anything new worth remembering, you can skip this. Respond briefly after deciding.";
|
||||
let reminder = r#"MEMORY CHECKPOINT: If you discovered code locations worth remembering, call `remember` now.
|
||||
|
||||
Use this rich format:
|
||||
|
||||
### Feature Name
|
||||
Brief description of what this feature/subsystem does.
|
||||
|
||||
- `path/to/file.rs`
|
||||
- `FunctionName()` [1200..1450] - what it does, key params/return
|
||||
- `StructName` [500..650] - purpose, key fields
|
||||
- `related_function()` - how it connects
|
||||
|
||||
### Pattern Name
|
||||
When to use this pattern and why.
|
||||
|
||||
1. First step
|
||||
2. Second step
|
||||
3. Key gotcha or tip
|
||||
|
||||
Example of a good entry:
|
||||
|
||||
### Session Continuation
|
||||
Save/restore session state across g3 invocations using symlink-based approach.
|
||||
|
||||
- `crates/g3-core/src/session_continuation.rs`
|
||||
- `SessionContinuation` [850..2100] - artifact struct with session state, TODO snapshot, context %
|
||||
- `save_continuation()` [5765..7200] - saves to `.g3/sessions/<id>/latest.json`, updates symlink
|
||||
- `load_continuation()` [7250..8900] - follows `.g3/session` symlink to restore
|
||||
- `find_incomplete_agent_session()` [10500..13200] - finds sessions with incomplete TODOs for agent resume
|
||||
|
||||
Skip if nothing new. Be brief."#;
|
||||
|
||||
// Add the reminder as a user message and get a response
|
||||
self.context_window.add_message(Message::new(
|
||||
|
||||
@@ -109,17 +109,25 @@ Use this format when calling `remember`:
|
||||
|
||||
```
|
||||
### <Feature Name>
|
||||
- `<file_path>` [<start>..<end>] - `<function_name>()`, `<StructName>`
|
||||
Brief description of what this feature/subsystem does.
|
||||
|
||||
- `<file_path>`
|
||||
- `FunctionName()` [1200..1450] - what it does, key params/return
|
||||
- `StructName` [500..650] - purpose, key fields
|
||||
- `related_function()` - how it connects
|
||||
|
||||
### <Pattern Name>
|
||||
When to use this pattern and why.
|
||||
|
||||
1. Step one
|
||||
2. Step two
|
||||
3. Key gotcha or tip
|
||||
```
|
||||
|
||||
## When to Remember
|
||||
|
||||
**ALWAYS** call `remember` at the END of your turn when you discovered:
|
||||
- A feature's location (file + char range + function/struct names)
|
||||
- A feature's location with purpose and key entry points
|
||||
- A useful pattern or workflow
|
||||
- An entry point for a subsystem
|
||||
|
||||
@@ -129,9 +137,13 @@ Do NOT save duplicates - check the Project Memory section (loaded at startup) to
|
||||
|
||||
## Example
|
||||
|
||||
After discovering where WebDriver tools live:
|
||||
After discovering how session continuation works:
|
||||
|
||||
{\"tool\": \"remember\", \"args\": {\"notes\": \"## Features\\n\\n### WebDriver Browser Automation\\n- crates/g3-core/src/tools/webdriver.rs [0..21750] - execute_webdriver_start(), execute_webdriver_navigate(), WebDriverSession\"}}
|
||||
{\"tool\": \"remember\", \"args\": {\"notes\": \"### Session Continuation\\nSave/restore session state across g3 invocations using symlink-based approach.\\n\\n- `crates/g3-core/src/session_continuation.rs`\\n - `SessionContinuation` [850..2100] - artifact struct with session state, TODO snapshot, context %\\n - `save_continuation()` [5765..7200] - saves to `.g3/sessions/<id>/latest.json`, updates symlink\\n - `load_continuation()` [7250..8900] - follows `.g3/session` symlink to restore\\n - `find_incomplete_agent_session()` [10500..13200] - finds sessions with incomplete TODOs for agent resume\"}}
|
||||
|
||||
After discovering a useful pattern:
|
||||
|
||||
{\"tool\": \"remember\", \"args\": {\"notes\": \"### UTF-8 Safe String Slicing\\nRust string slices use byte indices. Multi-byte chars (emoji, CJK) cause panics if sliced mid-character.\\n\\n1. Use `s.char_indices().nth(n)` to get byte index of Nth character\\n2. Use `s.chars().count()` for length, not `s.len()`\\n3. Danger zones: display truncation, user input, any non-ASCII text\"}}
|
||||
|
||||
# Response Guidelines
|
||||
|
||||
|
||||
Reference in New Issue
Block a user