docs: Project Constitution Global Enforcement (.cursorrules & README)

.cursorrules

@@ -0,0 +1,23 @@
+# 🎭 Global AI Instructions (.cursorrules)
+
+You are an expert full-stack developer working on the XAMLÉ AI project. You MUST follow these rules regardless of your model type.
+
+## 🚀 SESSION STARTUP
+1. **MANDATORY**: Read `.claude/CLAUDE.md` and `tasks/lessons.md` first.
+2. **MANDATORY**: Read `tasks/todo.md` to understand the current state.
+3. If these don't exist, create them before any code changes.
+
+## 🛡️ CORE PRINCIPES
+- **Atomic First**: Never send WhatsApp messages before successful Prisma DB updates.
+- **Async-First**: API Webhooks must respond `200 OK` in < 100ms.
+- **Idempotency**: Use Redis locks (300s) for all long-running tasks.
+- **Root Cause Only**: No temporary fixes. If it's a bug, find the root and fix it elegantly.
+
+## 🔄 WORKFLOW
+1. **Plan first** in `tasks/todo.md` for any task > 3 steps.
+2. **Verify strictly**: Never mark a task as done without log proof or test validation.
+3. **Auto-Learning**: Update `tasks/lessons.md` after every bug fix using format: `[date] | what went wrong | rule to avoid`.
+
+## 🧪 TECHNICAL PRIMER
+Refer to `.claude/primer.md` for the project stack (Gemini, BullMQ, Redis, Prisma).
+Refer to `tasks/hindsight.md` for historical user mandates and philosophy.

README.md

@@ -8,10 +8,21 @@ pinned: false
 app_port: 7860
 ---
 
-# EdTech Backend API & Worker
+# EdTech Backend (XAMLÉ AI)
+
+## 🤖 AI Development Rules (MANDATORY)
+This project uses a specialized memory and rules system for all AI assistants. Any AI model (Claude, Cursor, GPT, Gemini) working on this codebase **MUST** follow:
+- [CLAUDE.md](.claude/CLAUDE.md) : Project Constitution (Core Rules).
+- [primer.md](.claude/primer.md) : Technical Architecture & Business Profile.
+- [lessons.md](tasks/lessons.md) : Technical history of crashes and fixes.
+- [hindsight.md](tasks/hindsight.md) : Historical User Mandates.
+
+**Strict Session Flow**: 1. Read Lessons -> 2. Read Todo -> 3. Plan in `tasks/todo.md` -> 4. Execute.
+
+---
 
 This Space hosts the backend for the EdTech platform, including:
-- **Fastify API**: Handles WhatsApp Webhooks and enrollment logic.
-- **WhatsApp Worker**: Background job processor for sending daily content.
-- **Database**: Connects to Neon PostgreSQL.
-- **Queue**: Uses external Redis for BullMQ.
+- **Fastify API**: Handles WhatsApp Webhooks (Async-First).
+- **WhatsApp Worker**: Background logic processor (Atomic DB First).
+- **Database**: Azure Neon PostgreSQL.
+- **Queue**: BullMQ with managed Redis.