diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..cee182ac
--- /dev/null
+++ b/CLAUDE.md
@@ -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)