Proactive Agent Skill

Transform AI agents from task-followers into proactive partners that anticipate needs and continuously improve.

When to Use

✅ USE this skill when:

• "Make the agent more proactive"
• "Automate routine checks"
• "Implement memory persistence"
• "Schedule automated tasks"
• "Build self-improving agents"

Core Architecture

1. WAL Protocol (Write-Ahead Logging)

• Purpose: Preserve critical state and recover from context loss
• Components:
  • SESSION-STATE.md - Active working memory (current task)
  • working-buffer.md - Danger zone log
  • MEMORY.md - Long-term curated memory

2. Working Buffer

• Captures every exchange in the "danger zone"
• Prevents loss of critical context during session restarts
• Automatically compacts and archives important information

3. Autonomous vs Prompted Crons

• Autonomous Crons: Scheduled, context-aware automation
• Prompted Crons: User-triggered scheduled tasks
• Heartbeats: Periodic proactive checks

Implementation Patterns

Memory Architecture

workspace/
├── MEMORY.md              # Long-term curated memory
├── memory/
│   └── YYYY-MM-DD.md      # Daily raw logs
├── SESSION-STATE.md       # Active working memory
└── working-buffer.md      # Danger zone log

WAL Protocol Workflow

1. Capture: Log all critical exchanges to working buffer
2. Compact: Periodically review and extract key insights
3. Curate: Move important information to MEMORY.md
4. Recover: Restore state from logs after restart

Proactive Behaviors

1. Heartbeat Checks

# Check every 30 minutes
- Email inbox for urgent messages
- Calendar for upcoming events
- Weather for relevant conditions
- System status and health

2. Autonomous Crons

# Daily maintenance
- Memory compaction and cleanup
- File organization
- Backup verification

# Weekly tasks
- Skill updates check
- Documentation review
- Performance optimization

3. Context-Aware Automation

• Detect patterns in user requests
• Anticipate follow-up needs
• Suggest relevant actions

Configuration

Basic Setup

1. Create memory directory structure
2. Set up SESSION-STATE.md template
3. Configure heartbeat intervals
4. Define autonomous cron schedules

Advanced Configuration

{
  "proactive": {
    "heartbeatInterval": 1800,
    "autonomousCrons": {
      "daily": ["08:00", "20:00"],
      "weekly": ["Monday 09:00"]
    },
    "memory": {
      "compactionThreshold": 1000,
      "retentionDays": 30
    }
  }
}

Usage Examples

1. Implementing WAL Protocol

# SESSION-STATE.md Template

## Current Task
- Task: [Brief description]
- Started: [Timestamp]
- Status: [In Progress/Completed/Failed]

## Critical Details
- [Key information needed for recovery]

## Next Steps
- [Immediate actions]
- [Pending decisions]

2. Setting Up Heartbeats

# HEARTBEAT.md Template
# Check every 30 minutes