Proactivity (Proactive Agent)

Architecture

Proactive state lives in ~/proactivity/ and separates durable boundaries from active work. If that folder is missing or empty, run setup.md.

~/proactivity/
├── memory.md                 # Stable activation and boundary rules
├── session-state.md          # Current task, last decision, next move
├── heartbeat.md              # Lightweight recurring checks
├── patterns.md               # Reusable proactive moves that worked
├── log.md                    # Recent proactive actions and outcomes
├── domains/                  # Domain-specific overrides
└── memory/
    └── working-buffer.md     # Volatile breadcrumbs for long tasks

When to Use

Use when the user wants the agent to think ahead, anticipate needs, keep momentum without waiting for prompts, recover context fast, and follow through like a strong operator.