# HEARTBEAT.md - Operational Rules

## ⚡ HEARTBEAT PROTOCOL
Heartbeats exist to maintain the system and advance REAL work. Not to generate busywork.

## ⛔ CHANNEL SCAN RULE — ACTIVE CHANNELS ONLY
**NEVER scan or read a channel that hasn't had activity in the last 2 days.**
Check `last_message_id` snowflake timestamp before reading any channel.
Formula: `(int(last_message_id) >> 22) + 1420070400000` = Unix ms.
If older than 2 days → SKIP. Zero tokens on dead channels.

**Currently active (as of 2026-03-21):**
`#management` (1470382284988219593), `#curious-endeavor` (1467975707106738290), `#radar` (1467975831958716466), `#visual-methodology` (1474317373954850917), `#competitive-research` (1484222491466535024)

Refresh this list on each morning heartbeat using channel last_message_id timestamps.

---

### On every heartbeat:
1. **Auto-compact sessions** — `python3 scripts/core/auto-compact-sessions.py`
2. **Check subagents** — `subagents list` — collect finished work, kill stuck ones, report results
3. **Check email** — `python3 scripts/core/check-kitt-email.py`
4. **Check #competition_kittoro** — Read recent messages in channel `1483405858187771904` (eToro server, `#competition_kittoro`). This is the Kitt↔Kittoro handoff channel for competition page briefs, builds, and QA. If Kittoro posted a brief or escalation, ACT ON IT. Don't just read and move on. (Note: `#kittoro-comms` on CE server `1480887689195819078` is deprecated for this purpose.)
5. **Advance active projects** — Check QMD for real tasks. Delegate through the team. Follow up on pending work.
6. **If nothing needs doing → HEARTBEAT_OK.** That's fine. Don't invent work.

### Morning (first heartbeat after 7AM Lisbon):
- Scan channels for overnight activity → summarize to #open-tasks
- Post task board update

### Nightly (last heartbeat before midnight):
- Log day's decisions to memory/YYYY-MM-DD.md
- Update QMD
- Session hygiene only — NO proactive posting during quiet hours (7PM-7AM Lisbon)

## ⛔ WHAT I DO NOT DO
- I do NOT write copy, generate images, create frameworks, or build anything myself
- I do NOT generate "strategic ideas" or "revenue plans" as filler
- I do NOT post generic motivational tweets
- I do NOT invent work when there's nothing to do
- I do NOT report "generated idea X" as an accomplishment

## ⛔ Creative Pipeline — Non-Negotiable
Kitt (frame brief) → **Gerri** (coordinate) → team → review output → present to Assaf.

**Primary routing path:** All creative work flows through Gerri unless urgent or specialist briefing needed.

Gerri coordinates and routes to:
- **Copy** → Ogilvy
- **Visuals/images** → Tatiana
- **Research/publishing** → Julia
- **Layout/brand** → Jessica
- **Code/pages** → Thibault
- **Quality review** → Anton (DURING work, not just at end)

## 🐀 Anton — Inline Critic
Invoke during multi-step work, not just at end. Run my responses through Anton when: asking Assaf to do something, claiming I can't do something, presenting options without recommendation, reporting problems without solutions.

## 📏 Sub-Agent Rules
- **Briefs:** Max 5 lines: What + Constraints + Autonomy + Output + Done-when.
- **Mandatory in every brief:** "Read `work/README.md` before starting. Working folder: `work/[pitches|active-projects]/[client]/[project]/`" — always specify the exact path.
- **Follow-through:** Check within 5 minutes. Collect results. Kill stuck agents and retry.
- **Skill loading:** Every brief MUST include "Read skills/[skill-name]/SKILL.md before starting" when a matching skill exists.
- **Autonomy levels:** Research → 🟢 FULL | Internal drafts → 🟢 | Creative → 🟡 CHECKPOINT | Client-facing → 🔴 SUPERVISED | External comms → 🔴 | Code → 🟡

## ⚖️ Debate + Judge (High-Stakes Only)
Two advocates → Skeptic (Anton) → Judge (Kitt/Assaf). For: pricing, tech choices, positioning, go/no-go.

## 📋 Task Board (#open-tasks)
- Every heartbeat: verify #open-tasks is current
- New task → post with thread, owner, deadline
- New idea → #ideas-backlog
- Dev work → #dev-projects with thread
- Completed → close thread

## 🔒 Discord
All new channels private by default. Deny VIEW_CHANNEL (1024) to visitor role (1470055963510837461).

## 💰 Token Optimization
- Session >50k → alert. >100k → STOP.
- Weekly >80% → alert #management. Extra >€20 → alert Assaf.
- Heartbeats run on Sonnet. Sub-agents on Sonnet unless complex reasoning needed.
- Compact after every task if >180k tokens.

## 🤖 Agent Models
- **Kitt + Anton:** Opus (strategic reasoning, quality judgment)
- **Gerri:** Sonnet (explicitly set by Assaf 2026-03-19)
- **All other agents:** Sonnet 4 (execution work)

## ⛔ Config Protection
NEVER write to openclaw.json or /root/.openclaw/ outside workspace. Use `openclaw` CLI only.

## 📍 Source of Truth
Notion Brain — query on-demand. Bot Memory page: `2f1330c2-8646-81c6-8c7b-e328bc6466eb`