Memory Maintenance

Scheduled maintenance to keep memory current and useful. Runs automatically at end of day.

Important: This runs in the background with no user interaction. Do not ask questions - make decisions and note uncertainties in the journal.

Process

1. Run Distillation

First, run the macrodata-distill skill to extract facts from today's conversations.

This processes all OpenCode sessions, spawns sub-agents for extraction, and writes distilled actions to the journal.

Check if distill already ran today: Use get_recent_journal and look for topic "distill-summary" from today.

If not found, load macrodata-distill skill. If already ran, skip to step 2.

2. Review Distilled Content

Use get_recent_journal filtered to topic "distilled" to see what was extracted.

Use these to inform state file updates.

3. State File Updates

Review each state file and update if needed:

today.md

• •Clear completed items
• •Note anything that carried over
• •Leave empty or minimal for morning prep to fill

workspace.md

• •Update active projects list based on distilled actions
• •Add/remove open threads
• •Note any blocked items or waiting-on dependencies

human.md

• •Any new preferences or patterns from distilled facts?
• •Communication style insights?
• •Only update if genuinely new information

4. Entity Updates

Review entities/people/ and entities/projects/:

• •Integrate any facts extracted by distillation
• •Project status changes?
• •New projects to create files for?

5. Prune Stale Info

Look for outdated information:

• •Completed todos still listed as active
• •Old context that's no longer relevant
• •Temporary notes that should be removed
• •Duplicated information across files

Remove or archive as appropriate.

6. Index Maintenance

Check if indexes need rebuilding:

manage_index(target="memory", action="stats")
manage_index(target="conversations", action="stats")

If counts seem low or stale, trigger rebuild:

manage_index(target="memory", action="rebuild")
manage_index(target="conversations", action="update")

7. Journal Summary

Write a brief maintenance journal entry:

macrodata_log_journal(topic="maintenance", content="[what was updated, what was pruned, any observations]")

Note anything uncertain that should be confirmed with the user next session.