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

70 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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)