Proactive Agent (wyblhl fork)
by @wyblhl
Transform AI agents from task-followers into proactive partners. Implements WAL Protocol, Working Buffer, Compaction Recovery, Unified Search, Security Harde...
1. Copy assets to your workspace: cp assets/*.md ./
2. Your agent detects ONBOARDING.md and offers to get to know you
3. Answer questions (all at once, or drip over time)
4. Agent auto-populates USER.md and SOUL.md from your answers
5. Run security audit: ./scripts/security-audit.sh
Implementation
Core Scripts:
scripts/wal_protocol.py β Write-Ahead Logging for corrections/decisionsscripts/working_buffer.py β Danger zone exchange loggingscripts/compaction_recovery.py β Context recovery after truncationUsage Examples:
# Capture WAL entry (call before responding)
python scripts/wal_protocol.py "Use the blue theme, not red"Append to working buffer (when context >60%)
python scripts/working_buffer.py --append --human "message here"
python scripts/working_buffer.py --append --agent "summary here"Recover from compaction
python scripts/compaction_recovery.py --recoverCheck context threshold
python scripts/working_buffer.py --check
Reference Files:
references/proactive-tracker.md β Track patterns and opportunitiesreferences/security-hardening.md β Security checklist and guidelines1. Write immediately β context is freshest right after events 2. WAL before responding β capture corrections/decisions FIRST 3. Buffer in danger zone β log every exchange after 60% context 4. Recover from buffer β don't ask "what were we doing?" β read it 5. Search before giving up β try all sources 6. Try 10 approaches β relentless resourcefulness 7. Verify before "done" β test the outcome, not just the output 8. Build proactively β but get approval before external actions 9. Evolve safely β stability > novelty
clawhub install proactive-agent-wyblhl