ascorbic/macrodata/macrodata-memory-maintenance

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.