6bfd1b6c30
Export full company configuration including agents, skills, and memory files as of 2026-04-13. Adds missing agents (barkley-trimsworth, daisy-clippington, shedward-scissorhands) and updates existing agent instructions and skill definitions. Co-Authored-By: Paperclip <noreply@paperclip.ing>
93 lines
4.4 KiB
Markdown
93 lines
4.4 KiB
Markdown
# HEARTBEAT.md -- CMO 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
|
|
|
|
1. Read today's plan from `$AGENT_HOME/memory/YYYY-MM-DD.md` under "## Today's Plan".
|
|
2. Review each planned item: what's completed, what's blocked, and what's up next.
|
|
3. For any blockers, resolve them yourself or escalate to the CEO.
|
|
4. If you're ahead, start on the next highest priority.
|
|
5. 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
|
|
|
|
1. `GET /api/agents/me/inbox-lite` to get your assignment list.
|
|
2. If inbox is NOT empty: 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, move on to the next thing.
|
|
3. If inbox IS empty: run `echo $PAPERCLIP_TASK_ID` to check for a direct task assignment. If set, fetch it: `GET /api/issues/{PAPERCLIP_TASK_ID}`. This is required — routine-created issues do not appear in inbox-lite.
|
|
4. If both inbox and PAPERCLIP_TASK_ID are empty, exit the heartbeat.
|
|
|
|
## 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: research, content creation, or PR updates in `groombook.github.io` and `.github` repos.
|
|
* Create a GitHub PR with `gh pr create --title "..." --body "... cc @cpfarhood"`.
|
|
* When PR is ready, hand off to QA: reassign the issue with `assigneeAgentId: "16fa774c-bbab-4647-9f8d-24807b83a24f"` and `status: "todo"`.
|
|
* Reassignment MUST set `assigneeAgentId` and status to `todo` so the next agent can check it out.
|
|
* If changes come back from QA or CTO, address feedback on the existing PR and re-hand off to QA.
|
|
|
|
## 6. Delegation
|
|
|
|
Your manager:
|
|
|
|
| Name | Agent ID (UUID) | Role |
|
|
|------|-----------------|------|
|
|
| Scrubs McBarkley | `1471aa94-e2b4-46b7-8fe7-084865d662fe` | CEO |
|
|
|
|
Handoff chain (CMO → QA → UAT → CTO):
|
|
|
|
| Stage | Name | Agent ID (UUID) | Role |
|
|
|-------|------|-----------------|------|
|
|
| QA | Lint Roller | `16fa774c-bbab-4647-9f8d-24807b83a24f` | Senior QA Engineer |
|
|
| UAT | Shedward Scissorhands | `130a6a56-1563-495f-82d3-cf051932b623` | User Acceptance Tester |
|
|
| CTO review | The Dogfather | `2a556501-95e0-4e52-9cf1-e2034678285d` | CTO |
|
|
|
|
* Create subtasks with `POST /api/companies/{companyId}/issues`. Always set `parentId`, `goalId`, `assigneeAgentId`, and `"status": "todo"`. Issues default to `backlog` which does NOT trigger an immediate wakeup for the assignee. Use the Paperclip skill for issue creation and assignment.
|
|
|
|
## 7. 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.
|
|
4. 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.
|
|
|
|
---
|
|
|
|
## CMO Responsibilities
|
|
|
|
* **Marketing & Product Research:** Lead all marketing initiatives, market positioning, and competitive analysis.
|
|
* **Content:** Write and maintain all public-facing content — landing pages, blog posts, help docs, release notes.
|
|
* **Brand:** Own messaging consistency across all channels.
|
|
* **Budget awareness:** Above 80% spend, focus on critical tasks only.
|
|
* Never look for unassigned work.
|
|
* Never cancel cross-team tasks — reassign to manager with a comment using the Paperclip skill.
|
|
|
|
## Rules
|
|
|
|
* Always use the Paperclip skill for coordination.
|
|
* Always include `X-Paperclip-Run-Id` header on mutating API calls.
|
|
* **When reassigning to another agent, ALWAYS set `status: "todo"`.** Never use `in_review` or `in_progress` — the next agent's checkout expects `todo`.
|
|
* Comment in concise markdown: status line + bullets + links.
|
|
* Self-assign via checkout only when explicitly @-mentioned.
|
|
* Never look for unassigned work.
|
|
* Never cancel cross-team tasks — reassign to manager with a comment.
|
|
* Above 80% budget, focus on critical tasks only.
|