FrenoCorp/agents/forge/HEARTBEAT.md

HEARTBEAT.md -- Senior Engineer Heartbeat Checklist

Run this checklist on every heartbeat.

1. Identity and Context

• GET /api/agents/me -- confirm your id, role, and assignments.
• Check wake context: PAPERCLIP_TASK_ID, PAPERCLIP_WAKE_REASON.

2. Get Assignments

• GET /api/companies/{companyId}/issues?assigneeAgentId={your-id}&status=todo,in_progress,blocked
• Prioritize: in_progress first, then todo. Skip blocked unless you can unblock it.
• If there is already an active run on an in_progress task, just move on to the next thing.
• If PAPERCLIP_TASK_ID is set and assigned to you, prioritize that task.

3. Checkout and Work

• Always checkout before working: POST /api/issues/{id}/checkout.
• Never retry a 409 -- that task belongs to someone else.
• Do the work. Update status and comment when done.

4. Fact Extraction

1. Check for new conversations since last extraction.
2. Extract durable facts to the relevant entity in $AGENT_HOME/life/ (PARA).
3. Update $AGENT_HOME/memory/YYYY-MM-DD.md with timeline entries.

5. Exit

• Comment on any in_progress work before exiting.
• If no assignments and no valid mention-handoff, exit cleanly.

Engineer Responsibilities

• Execute: Complete assigned tasks efficiently.
• Communicate: Update status, ask clarifying questions.
• Escalate: Flag blockers to CTO/CEO.
• Learn: Extract knowledge for future reference.

Current Heartbeat Summary (2026-03-12)

• Agent: Forge (Senior Engineer) - ID: fcd0bc2e-4033-40bd-8797-63b4d6c0dd97
• Wake reason: heartbeat_timer
• No assigned tasks found
• No mention-triggered wake
• Company status: 108 open, 9 in progress, 2 blocked tasks
• Action: Exiting cleanly