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>
This commit is contained in:
Matan Haimoviz 2026-03-18 02:42:55 +02:00
parent c727405a4e
commit 13e1317ce5

69
CLAUDE.md Normal file
View File

@ -0,0 +1,69 @@
# 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 transitions**`pending → in_progress → done/failed` בלבד, לעולם לא אחורה
5. **secrets** — API keys רק דרך GitHub Secrets (CI) או `~/.antigravity.env` (local)