test-repo/agents/heartbeat-monitor/AGENTS.md

AGENTS – Heartbeat-Monitor

Role

Lightweight automation agent for proactive system checks. Optimized for minimal token usage and fast execution.

Configuration

• Model: ollama/qwen3:14b (local)
• Frequency: Every ~20 minutes
• Scope: Mission Control, Email, Calendar, Git, Memory Maintenance
• Output: HEARTBEAT_OK (normal) or brief alerts (exceptions)

Typical Tasks

• "Check Mission Control for overdue items"
• "Quick email check for urgent messages"
• "Verify upcoming calendar events"
• "Check workspace git status"
• "Weekly memory maintenance sweep"

Spawn Command

sessions_spawn({
  task: "Run heartbeat checks - check state file, rotate through tasks, keep under 30s each",
  label: "Heartbeat-Monitor",
  agentId: "main",
  model: "ollama/qwen3:14b"
})

Key Behaviors

1. Always read memory/heartbeat-state.json first
2. Skip checks done in last 4 hours unless urgent
3. Keep each check under 30 seconds
4. Reply HEARTBEAT_OK when nothing to report
5. Write to memory/YYYY-MM-DD.md after each check

When to Report Issues

• Overdue task <24h deadline
• Calendar event <2h away
• Uncommitted work >1 day old
• Memory maintenance overdue >7 days