proactive-agent

Persist agent decisions and context using write-ahead logging before responding.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/papachong/RHClaw --skill proactive-agent-papachong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proactive-agent
Source: https://github.com/papachong/RHClaw/tree/main/RHClaw-Desktop/src-tauri/skills/proactive-agent
Command: npx skills add https://github.com/papachong/RHClaw --skill proactive-agent-papachong

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Proactive, stateful agents lose context, miss background work, and fail to reliably persist decisions and corrections across sessions; this Skill provides patterns and protocols to anticipate needs, capture critical state, and recover from truncated context so agents keep delivering value without constant human reminders.

Core Features & Use Cases

  • WAL Protocol: Write-ahead logging to persist corrections, decisions, and key details before responding.
  • Working Buffer & Compaction Recovery: Danger-zone buffering and step-by-step recovery when context is truncated.
  • Autonomous Crons & Agent Orchestration: Spawn isolated agent turns for background jobs that don't require main-session attention.
  • Unified Search & Memory Architecture: Semantic-first search across daily logs, session state, and long-term memory to avoid guessing.
  • Security Hardening & Skill Vetting: Installation policies, prompt-injection defenses, credential checks, and a security audit script.
  • Self-Improvement Guardrails: ADL and VFM protocols to evolve safely and verify behavioral changes.
  • Use cases: survive context limits in multi-session workflows, automate background maintenance tasks, safely migrate or deprecate tools, and recover work after compaction or restart.

Quick Start

Ask the agent to run the security audit and save the current session state to SESSION-STATE.md.

Frequently Asked Questions about proactive-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I persist AI agent context and decisions before responding to avoid losing work?

Use write-ahead logging to persist corrections and decisions before the agent responds. This ensures critical context is captured durably, preventing state loss across multi-session workflows.

What is write-ahead logging for AI agents and when do I need it?

Write-ahead logging is a protocol that persists agent decisions and key details before generating a response. It is needed when agents lose critical context during multi-session workflows or background cron jobs.

How do I recover agent state after memory compaction or context truncation?

Recover from memory compaction using a working buffer and step-by-step recovery protocols. This reconstructs truncated context and restores critical session state so agents continue delivering value.

Can I run autonomous background cron jobs without losing main agent session context?

Yes, autonomous crons spawn isolated agent turns for background maintenance tasks. This keeps background jobs separate from the main session, ensuring main-session context remains uninterrupted.

How do I secure autonomous agents against prompt injection and vet new skills?

Secure autonomous agents using installation policies, prompt-injection defenses, and credential checks. A security audit script vets skills to ensure safe execution and guard against malicious injections.

What are the limitations of using working buffers for agent state recovery?

Working buffers operate in a danger zone during context truncation and require step-by-step recovery protocols. If compaction severely truncates state, recovery depends on the write-ahead log's durability and completeness.