Transform AI agents from passive task-followers into proactive, self-improving partners with WAL Protocol, Working Buffer, and battle-tested patterns.
npx clawhub@latest install proactive-agentProactive Agent is an architectural skill that upgrades your AI agent from a reactive task-executor into a proactive partner that anticipates needs, survives context loss, and continuously improves. Built around three pillars — proactive value creation, persistent memory across sessions, and safe self-improvement — it brings Write-Ahead Logging, Working Buffer protocols, and compaction recovery to keep your agent reliable even as context windows fill and truncate. These patterns are battle-tested from thousands of real conversations, not theoretical designs.
npx clawhub@latest install proactive-agentClick the Install button at the top of this page for one-click setup
Before composing any response, the agent scans every human message for corrections, decisions, preferences, and specific values, then writes them to SESSION-STATE.md first. This ensures critical details are never lost to context eviction — the trigger is the human's input, not the agent's memory.
Once context reaches 60%, the agent activates a working buffer that logs every exchange — both the human's message and a summary of the agent's response — to a persistent file. After compaction, the buffer is read first so the agent never has to ask "what were we doing?"
Auto-triggers when a session restarts after truncation. The agent reads memory/working-buffer.md, then SESSION-STATE.md, then daily notes in order, extracting and consolidating context before presenting a recovery summary — without asking the human to re-explain.
The Anti-Drift Limits protocol prevents the agent from adding complexity for its own sake, making unverifiable changes, or sacrificing stability for novelty. The Value-First Modification scoring system ensures every behavioral change must prove compounding leverage before being adopted.
Distinguishes between systemEvent crons (which prompt the main session) and isolated agentTurn crons (which spawn a sub-agent to do the work independently). Prevents the failure mode where scheduled checks never actually execute because the main session is occupied.
Covers skill installation vetting (with guidance that ~26% of community skills contain vulnerabilities), protection against external AI agent networks used for context harvesting, and context leakage prevention before posting to shared channels.
For ongoing work spanning days or weeks, Proactive Agent maintains continuity through SESSION-STATE.md and daily memory logs. The WAL Protocol captures every decision and correction as it happens, so the agent picks up exactly where it left off each session.
Using the isolated agentTurn cron pattern, schedule tasks like memory freshening, log reviews, or security audits to run and complete without requiring main session attention — critical for truly hands-off automation.
The Curiosity Loop, Pattern Recognition Loop, and USER.md/SOUL.md architecture let the agent build a persistent model of who you are and what you value. Repeated requests get detected and proposed for automation; past decisions get followed up on weekly.
Instead of waiting to be asked, the agent surfaces ideas via reverse prompting — asking what would be helpful based on what it knows about you. The Heartbeat System schedules regular "proactive surprise" checks so this behavior fires automatically, not just when prompted.
npx clawhub@latest install proactive-agentLog in to write a review
No reviews yet. Be the first to share your experience!