Nano Memory
Architecture
Durable memory lives in project-local files. AgentScope session memory and UI JSON files are not a substitute for this skill.
Core files:
.agents/memory/MEMORY.md: curated long-term memory for user identity, preferences, project conventions, and stable decisions..agents/memory/YYYY-MM-DD.md: daily chronological logs for recent work and raw notes.
Available Tools
Use only tools that are actually registered in this Quynj Claw runtime:
list_files or list_directory to inspect directories.view_text_file to read file contents, optionally with line ranges.write_text_file to create, overwrite, or replace a range in a text file.insert_text_file to insert text at a specific line when available.- Shell search commands such as
rg, grep, ls, find, or platform equivalents when the runtime allows shell access.
Do not call non-existent tools such as read_file, write_file, or edit_file unless the current runtime explicitly exposes them. In this project, prefer view_text_file, write_text_file, and insert_text_file.
Workflow A: Retrieve Memory
- List
.agents/memory/ to see available memory files.
- Search
.agents/memory/ for relevant names, topics, dates, decisions, or preferences.
- Read the specific matching files with
view_text_file.
- Answer based on retrieved memory. If memory is absent or ambiguous, say so.
Use this workflow before claiming to know who the user is, what they prefer, or what happened in previous sessions.
Workflow B: Record Daily Context
- Use the current local date for
.agents/memory/YYYY-MM-DD.md.
- If the file exists, read it first with
view_text_file; then append by rewriting the file with write_text_file or insert at the end with insert_text_file.
- If the file does not exist, create it with
write_text_file.
- Keep daily entries short, dated, and factual.
Workflow C: Update Long-Term Memory
- Read
.agents/memory/MEMORY.md with view_text_file before updating.
- Preserve existing structure and useful content.
- Use
write_text_file with a precise line range when the target section is clear. Otherwise rewrite the full file after reading the latest contents.
- Record durable facts only: stable preferences, identity details the user wants remembered, project conventions, architecture decisions, recurring workflows, and completed milestones.
- Do not store passwords, API keys, private medical/financial details, or sensitive personal data unless the user explicitly requests it.
Recording Rules
- Record first, then rely on the memory in future answers.
- Prefer concise distilled memory over full chat transcripts.
- Do not use
.agents/ui-store as memory; those files are UI projections only.
- If a write tool fails, report the failure and do not pretend the memory was saved.
1---2name: nano-memory3description: Maintain durable local memory for the Quynj Claw user and project using only the registered file tools and shell search. Use when the agent needs to recall who the user is, user preferences, project history, prior decisions, daily logs, or when it learns durable facts that should survive new sessions.4---56# Nano Memory78## Architecture910Durable memory lives in project-local files. AgentScope session memory and UI JSON files are not a substitute for this skill.1112Core files:1314- `.agents/memory/MEMORY.md`: curated long-term memory for user identity, preferences, project conventions, and stable decisions.15- `.agents/memory/YYYY-MM-DD.md`: daily chronological logs for recent work and raw notes.1617## Available Tools1819Use only tools that are actually registered in this Quynj Claw runtime:2021- `list_files` or `list_directory` to inspect directories.22- `view_text_file` to read file contents, optionally with line ranges.23- `write_text_file` to create, overwrite, or replace a range in a text file.24- `insert_text_file` to insert text at a specific line when available.25- Shell search commands such as `rg`, `grep`, `ls`, `find`, or platform equivalents when the runtime allows shell access.2627Do not call non-existent tools such as `read_file`, `write_file`, or `edit_file` unless the current runtime explicitly exposes them. In this project, prefer `view_text_file`, `write_text_file`, and `insert_text_file`.2829## Workflow A: Retrieve Memory30311. List `.agents/memory/` to see available memory files.322. Search `.agents/memory/` for relevant names, topics, dates, decisions, or preferences.333. Read the specific matching files with `view_text_file`.344. Answer based on retrieved memory. If memory is absent or ambiguous, say so.3536Use this workflow before claiming to know who the user is, what they prefer, or what happened in previous sessions.3738## Workflow B: Record Daily Context39401. Use the current local date for `.agents/memory/YYYY-MM-DD.md`.412. If the file exists, read it first with `view_text_file`; then append by rewriting the file with `write_text_file` or insert at the end with `insert_text_file`.423. If the file does not exist, create it with `write_text_file`.434. Keep daily entries short, dated, and factual.4445## Workflow C: Update Long-Term Memory46471. Read `.agents/memory/MEMORY.md` with `view_text_file` before updating.482. Preserve existing structure and useful content.493. Use `write_text_file` with a precise line range when the target section is clear. Otherwise rewrite the full file after reading the latest contents.504. Record durable facts only: stable preferences, identity details the user wants remembered, project conventions, architecture decisions, recurring workflows, and completed milestones.515. Do not store passwords, API keys, private medical/financial details, or sensitive personal data unless the user explicitly requests it.5253## Recording Rules5455- Record first, then rely on the memory in future answers.56- Prefer concise distilled memory over full chat transcripts.57- Do not use `.agents/ui-store` as memory; those files are UI projections only.58- If a write tool fails, report the failure and do not pretend the memory was saved.
quynj