Proactive Agent 🦞

By Hal Labs — Part of the Hal Stack

A proactive, self-improving architecture for your AI agent.

Most agents just wait. This one anticipates your needs — and gets better at it over time.

What's New in v3.1.0

• Autonomous vs Prompted Crons — Know when to use systemEvent vs isolated agentTurn
• Verify Implementation, Not Intent — Check the mechanism, not just the text
• Tool Migration Checklist — When deprecating tools, update ALL references

What's in v3.0.0

• WAL Protocol — Write-Ahead Logging for corrections, decisions, and details that matter
• Working Buffer — Survive the danger zone between memory flush and compaction
• Compaction Recovery — Step-by-step recovery when context gets truncated
• Unified Search — Search all sources before saying "I don't know"
• Security Hardening — Skill installation vetting, agent network warnings, context leakage prevention
• Relentless Resourcefulness — Try 10 approaches before asking for help
• Self-Improvement Guardrails — Safe evolution with ADL/VFM protocols

The Three Pillars

Proactive — creates value without being asked

✅ Anticipates your needs — Asks "what would help my human?" instead of waiting

✅ Reverse prompting — Surfaces ideas you didn't know to ask for

✅ Proactive check-ins — Monitors what matters and reaches out when needed

Persistent — survives context loss

✅ WAL Protocol — Writes critical details BEFORE responding

✅ Working Buffer — Captures every exchange in the danger zone

✅ Compaction Recovery — Knows exactly how to recover after context loss

Self-improving — gets better at serving you

✅ Self-healing — Fixes its own issues so it can focus on yours

✅ Relentless resourcefulness — Tries 10 approaches before giving up

✅ Safe evolution — Guardrails prevent drift and complexity creep

Contents

1. Quick Start
2. Core Philosophy
3. Architecture Overview
4. Memory Architecture
5. The WAL Protocol ⭐ NEW
6. Working Buffer Protocol ⭐ NEW
7. Compaction Recovery ⭐ NEW
8. Security Hardening (expanded)
9. Relentless Resourcefulness
10. Self-Improvement Guardrails
11. Autonomous vs Prompted Crons ⭐ NEW
12. Verify Implementation, Not Intent ⭐ NEW
13. Tool Migration Checklist ⭐ NEW
14. The Six Pillars
15. Heartbeat System
16. Reverse Prompting
17. Growth Loops

Quick Start

1. Copy assets to your workspace: cp assets/*.md ./