Skip to content

Commit dde572e

Browse files
author
CLAWDINATOR
committed
feat(heartbeat): add SITREP structure with delta tracking
- HEARTBEAT.md: detailed checklist with sitrep-latest.md workflow - Triage skill: updated output format with fires/now/dashboard/changes - Chat output: 3-5 lines with link to full sitrep - Tracks changes since last sitrep (new/closed/updated)
1 parent de39420 commit dde572e

File tree

2 files changed

+69
-31
lines changed

2 files changed

+69
-31
lines changed

clawdinator/workspace/HEARTBEAT.md

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,28 @@
33
Hourly SITREP checklist:
44

55
1. Read AGENTS.md comms rules (terse chat, details to files)
6-
2. Read `/memory/index.md` and today's daily file for context
7-
3. Persist any relevant channel updates to daily memory file
6+
2. Read `/memory/index.md` and `/memory/sitrep-latest.md` for context
7+
3. Persist any relevant channel updates to today's daily memory file
88
4. Run triage skill (`skills/triage/SKILL.md`):
99
- Read `/memory/github/prs.md` and `/memory/github/issues.md`
10-
- Identify Now/Next/Later priorities
11-
5. Write detailed sitrep to today's daily memory file
12-
6. Post terse summary to chat (1-3 lines max, no tables)
13-
7. If nothing needs attention, reply HEARTBEAT_OK
10+
- Compare against previous sitrep for changes
11+
5. Write SITREP to `/memory/sitrep-latest.md` (overwrite):
12+
```markdown
13+
# SITREP YYYY-MM-DDTHH:MMZ
14+
15+
## 🔥 Fires
16+
- Active issues needing immediate attention
17+
18+
## ⚡ NOW
19+
- Single most important action to take
20+
21+
## 📊 Dashboard
22+
- PRs: X open (Y approved waiting)
23+
- Issues: X open (Y bugs, Z features)
24+
25+
## 🔄 Changes since last SITREP
26+
- NEW/CLOSED/UPDATED items
27+
```
28+
6. Append summary to today's daily file (`/memory/daily/YYYY-MM-DD.md`)
29+
7. Post terse summary to chat (3-5 lines, link to sitrep-latest.md)
30+
8. If nothing needs attention, reply HEARTBEAT_OK

clawdinator/workspace/skills/triage/SKILL.md

Lines changed: 46 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ You are a maintainer triage agent for the clawdbot org. Your job is to read the
1212
Trigger on:
1313
- "triage", "priorities", "what's hot", "what needs attention"
1414
- "status", "what's happening", "project health"
15-
- "what should I work on", "where do I start"
15+
- Hourly heartbeat SITREP
1616

1717
## Context Sources
1818

@@ -22,20 +22,24 @@ Read these files to understand current state:
2222
- `/memory/github/prs.md` — all open PRs across clawdbot org
2323
- `/memory/github/issues.md` — all open issues across clawdbot org
2424

25-
2. **Project context**:
25+
2. **Previous SITREP** (for delta):
26+
- `/memory/sitrep-latest.md` — last hourly sitrep
27+
28+
3. **Project context**:
2629
- `/memory/project.md` — project goals and priorities
2730
- `/memory/architecture.md` — architecture decisions
2831

29-
3. **Discord signals**:
30-
- Recent messages are already in your conversation context from lurk channels
32+
4. **Discord signals**:
33+
- Recent messages in conversation context from lurk channels
3134
- Cross-reference with GitHub issues where relevant
3235

3336
## Your Task
3437

35-
1. **Read AGENTS.md communication rules first** — they govern how you deliver output
38+
1. **Read AGENTS.md communication rules first** — they govern output delivery
3639
2. Read the raw data from memory files
37-
3. Reason about what's urgent, ready, blocked, or stale
38-
4. Produce a prioritized summary with clear recommendations
40+
3. Compare against previous sitrep for changes (new/closed/updated)
41+
4. Reason about what's urgent, ready, blocked, or stale
42+
5. Produce SITREP in the format below
3943

4044
## Priority Guidance
4145

@@ -45,34 +49,51 @@ Read these files to understand current state:
4549
- PRs with approvals waiting to merge = quick wins
4650
- Issues with no activity = potential neglect
4751

48-
## Output Format
52+
## Output Format (SITREP)
53+
54+
Write to `/memory/sitrep-latest.md`:
55+
56+
```markdown
57+
# SITREP YYYY-MM-DDTHH:MMZ
58+
59+
## 🔥 Fires
60+
- [#NNN](<url>) brief description (age, comment count)
61+
62+
## ⚡ NOW
63+
Single most important action: [describe with link]
4964

50-
Produce a concise Now/Next/Later summary:
65+
## 📊 Dashboard
66+
- PRs: X open (Y approved waiting, Z draft)
67+
- Issues: X open (Y bugs, Z features)
68+
- Sync: [timestamp from prs.md]
5169

52-
### NOW (needs attention today)
53-
- What: [item with link]
54-
- Why: [reason it's urgent]
55-
- Action: [recommended next step]
70+
## 🔄 Changes since last SITREP
71+
- NEW: #NNN description
72+
- CLOSED: #NNN description
73+
- UPDATED: #NNN significant update
5674

57-
### NEXT (this week)
58-
- What: [item with link]
59-
- Why: [reason it's important]
60-
- Action: [recommended next step]
75+
## 📋 Queue
76+
- **NOW:** [#NNN](<url>) — action needed
77+
- **NEXT:** [#NNN](<url>) — description
78+
- **LATER:** [#NNN](<url>) — description
79+
```
6180

62-
### LATER (backlog)
63-
- What: [item]
64-
- Notes: [any context]
81+
## Chat Output
6582

66-
### Quick Wins
67-
- [Approved PRs ready to merge, easy fixes, etc.]
83+
After writing sitrep-latest.md, post terse summary to chat (3-5 lines):
84+
```
85+
🔥 1 fire: #531 config bug
86+
⚡ NOW: Review #530 (macOS keychain)
87+
📊 6 PRs, 8 issues | Details: /memory/sitrep-latest.md
88+
```
6889

69-
### Signals
70-
- [Notable Discord mentions, patterns, community concerns]
90+
If nothing needs attention: `HEARTBEAT_OK`
7191

7292
## Constraints
7393

7494
- Be concise. Maintainers are busy.
75-
- Always include links to issues/PRs.
95+
- Always use masked links: `[#NNN](<url>)`
96+
- No markdown tables (use bullet lists).
7697
- If data is stale (>1hr old sync), note it.
7798
- If something is unclear, say so — don't guess.
7899
- Advisory only: don't take actions, just recommend.

0 commit comments

Comments
 (0)