/macrodata-memory-maintenance

name: macrodata-memory-maintenance
description: End of day memory maintenance. Runs distillation, updates state files, prunes stale info. Runs in background with no user interaction.

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.