system-prompts-and-models-o.../CLAUDE.md
Matan Haimoviz 13e1317ce5 Add CLAUDE.md with Antigravity Swarm project context
Documents the multi-agent architecture (worker.py, GitHub Actions, Supabase),
task_queue and agent_memory schemas, and working rules including commit discipline
and claude_context updates.

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

2.5 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 זמן שמירה

חוקי עבודה

  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)