system-prompts-and-models-o.../CLAUDE.md
Matan Haimoviz e34cb9a0e1 Add direct Claude↔Antigravity communication protocol to CLAUDE.md
Documents the Supabase channels (claude_inbox, claude_outbox, hive_comms)
for autonomous agent-to-agent communication without Matan as middleman.
Includes session-start inbox check instructions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-18 02:42:55 +02:00

3.4 KiB
Raw Blame History

Antigravity Swarm — Project Context

תיאור הפרויקט

Antigravity Swarm הוא מערכת multi-agent אוטונומית המבוססת על תזמון משימות מרכזי דרך Supabase, עם agents שפועלים כ-workers על GitHub Actions ו-locally.

המטרה: ביצוע משימות AI מקבילי ועצמאי, עם זיכרון משותף ותיאום בין agents.


ארכיטקטורה

GitHub Actions (CI trigger)
        │
        ▼
   worker.py          ← agent ראשי שמושך משימות ומבצע
        │
        ├── שולף מ-task_queue (Supabase)
        ├── כותב תוצאות ל-agent_memory (Supabase)
        └── מעדכן claude_context לפני כל סשן

רכיבים

רכיב תפקיד
worker.py Agent ראשי — שולף משימות מה-queue ומבצע
GitHub Actions Trigger לריצת workers (scheduled / event-driven)
Supabase Backend מרכזי — DB + Auth + Realtime

טבלאות Supabase

task_queue

תור המשימות המרכזי של ה-Swarm.

עמודה סוג תיאור
id uuid מזהה ייחודי
task_type text סוג המשימה
payload jsonb נתוני הקלט
status text pending / in_progress / done / failed
assigned_to text שם ה-agent שקיבל
created_at timestamp זמן יצירה
updated_at timestamp עדכון אחרון

agent_memory

זיכרון משותף בין כל ה-agents.

עמודה סוג תיאור
id uuid מזהה ייחודי
agent_id text שם/מזהה ה-agent
key text מפתח הזיכרון
value jsonb תוכן הזיכרון
context_type text task / learning / state
created_at timestamp זמן שמירה

תקשורת ישירה עם Antigravity (ללא מתווך)

Supabase project: ayhplxbihuyimtrzimrh (Antigravity-Brain, eu-central-1)

בתחילת כל סשן — בדוק inbox:

SELECT id, from_agent, subject, message, priority, created_at
FROM claude_inbox WHERE status = 'unread' ORDER BY priority DESC, created_at ASC;

אם יש הודעות — קרא, סמן כ-read, והגב ל-claude_outbox.

לכתוב תשובה ל-Antigravity:

INSERT INTO claude_outbox (to_agent, subject, message, message_type)
VALUES ('antigravity', '<subject>', '<message>', 'response');

ערוצי תקשורת:

טבלה כיוון תיאור
claude_inbox Antigravity → Claude הודעות נכנסות
claude_outbox Claude → Antigravity תשובות ויוזמות
hive_comms דו-כיווני broadcast כללי
task_queue משותף משימות לביצוע

חוקי עבודה

  1. תמיד commit אחרי שינוי — כל שינוי קוד מלווה ב-commit עם הודעה ברורה
  2. תמיד עדכן claude_context — לפני סיום כל סשן, עדכן את ה-context ב-agent_memory עם מה שנעשה
  3. אל תשנה task_queue ידנית — רק דרך worker.py או API מוגדר
  4. status transitionspending → in_progress → done/failed בלבד, לעולם לא אחורה
  5. secrets — API keys רק דרך GitHub Secrets (CI) או ~/.antigravity.env (local)