What problem does it solve?
Proactive-agent prevents AI assistants from losing critical context, failing background tasks, and repeating work when sessions are truncated or memory is compacted. It ensures decisions, corrections, and important details are captured reliably so the agent can continue work across restarts and run autonomous maintenance without human prompts.
Core Features & Use Cases
- WAL Protocol (Write-Ahead Log): Persist corrections, decisions, proper nouns, and specific values to SESSION-STATE.md before responding.
- Working Buffer: Capture every exchange in the "danger zone" after context usage passes a threshold so no recent interaction is lost during compaction.
- Compaction Recovery: Read the working buffer and session state to reconstruct context and resume interrupted tasks without asking the user "what were we doing?"
- Autonomous vs Prompted Crons: Use isolated agentTurns for background work and systemEvents for attention-requiring prompts to avoid missed maintenance tasks.
- Self-Improvement Guardrails & Verification: Safe evolution via ADL/VFM rules, verify implementation changes (not just text), and enforce security hardening before installing skills or acting externally.
- Use Cases: Auto-populate onboarding files and USER.md, run periodic memory fresheners and heartbeat audits, recover a project after a context truncation, and generate draft proactive suggestions without sending externally.
Quick Start
Ask the agent: "Before replying, write any corrections, decisions, or proper nouns into SESSION-STATE.md, then summarize the current task and next steps."