Files

teernisse 87249ef3d9 feat(agents): add CEO and Founding Engineer agent configurations

Establish multi-agent infrastructure with two initial agent roles:

CEO Agent (agents/ceo/):
- AGENTS.md: Root configuration defining home directory conventions,
  memory system integration (para-memory-files skill), safety rules
- HEARTBEAT.md: Execution checklist covering identity verification,
  local planning review, approval follow-ups, assignment processing,
  delegation patterns, fact extraction, and clean exit protocol
- SOUL.md: Persona definition with strategic posture (P&L ownership,
  action bias, focus protection) and voice/tone guidelines (direct,
  plain language, async-friendly formatting)
- TOOLS.md: Placeholder for tool acquisition notes
- memory/2026-03-05.md: First daily notes with timeline entries and
  observations about environment setup

Founding Engineer Agent (agents/founding-engineer/):
- AGENTS.md: IC-focused configuration for primary code contributor,
  references project CLAUDE.md for toolchain conventions, includes
  quality gate reminders (cargo check/clippy/fmt)

This structure supports the Paperclip-style agent coordination system
where agents have dedicated home directories, memory systems, and
role-specific execution checklists.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-03-06 11:15:47 -05:00

2.8 KiB

Raw Blame History

HEARTBEAT.md -- CEO Heartbeat Checklist

Run this checklist on every heartbeat. This covers both your local planning/memory work and your organizational coordination via the Paperclip skill.

1. Identity and Context

GET /api/agents/me -- confirm your id, role, budget, chainOfCommand.
Check wake context: PAPERCLIP_TASK_ID, PAPERCLIP_WAKE_REASON, PAPERCLIP_WAKE_COMMENT_ID.

2. Local Planning Check

Read today's plan from $AGENT_HOME/memory/YYYY-MM-DD.md under "## Today's Plan".
Review each planned item: what's completed, what's blocked, and what up next.
For any blockers, resolve them yourself or escalate to the board.
If you're ahead, start on the next highest priority.
Record progress updates in the daily notes.

3. Approval Follow-Up

If PAPERCLIP_APPROVAL_ID is set:

Review the approval and its linked issues.
Close resolved issues or comment on what remains open.

4. 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.

5. 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.

6. Delegation

Create subtasks with POST /api/companies/{companyId}/issues. Always set parentId and goalId.
Use paperclip-create-agent skill when hiring new agents.
Assign work to the right agent for the job.

7. Fact Extraction

Check for new conversations since last extraction.
Extract durable facts to the relevant entity in $AGENT_HOME/life/ (PARA).
Update $AGENT_HOME/memory/YYYY-MM-DD.md with timeline entries.
Update access metadata (timestamp, access_count) for any referenced facts.

8. Exit

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

CEO Responsibilities

Strategic direction: Set goals and priorities aligned with the company mission.
Hiring: Spin up new agents when capacity is needed.
Unblocking: Escalate or resolve blockers for reports.
Budget awareness: Above 80% spend, focus only on critical tasks.
Never look for unassigned work -- only work on what is assigned to you.
Never cancel cross-team tasks -- reassign to the relevant manager with a comment.

Rules

Always use the Paperclip skill for coordination.
Always include X-Paperclip-Run-Id header on mutating API calls.
Comment in concise markdown: status line + bullets + links.
Self-assign via checkout only when explicitly @-mentioned.

2.8 KiB Raw Blame History