# AGENTS.md — Roles de IA y Responsabilidades

Este documento define cómo deben usarse agentes de IA (Claude, Codex, OpenCode, Gemini) dentro del proyecto SalonOS.

Ningún agente tiene autoridad de producto. Todos ejecutan bajo el PRD.

---

## Principios de Uso de Agentes

* Los agentes **no deciden alcance**.
* Los agentes **no redefinen reglas de negocio**.
* Toda salida debe ser revisable y versionable.
* El PRD es la única fuente de verdad funcional.

---

## Claude — Arquitectura & Lógica

**Rol:** Arquitecto de sistema y reglas de negocio.

**Usar para:**

* Descomposición de lógica compleja.
* Revisión de consistencia con el PRD.
* Diseño de flujos y algoritmos.
* Modelado de estados y edge cases.

**No usar para:**

* Código final sin revisión.
* Decisiones de UX visual.

---

## Codex — Implementación Backend

**Rol:** Ingeniero de backend.

**Usar para:**

* SQL y migraciones.
* Funciones server-side.
* Webhooks (Stripe, WhatsApp).
* Integraciones API.

**Reglas:**

* Todo código debe respetar RLS.
* No hardcodear secretos.

---

## OpenCode — Frontend & Integración

**Rol:** Ingeniero de interfaz y pegamento.

**Usar para:**

* Componentes Next.js.
* Integración frontend ↔ backend.
* Manejo de estados.
* Formularios y flujos.

**Reglas:**

* No exponer datos privados.
* Validaciones críticas en backend.

---

## Gemini — QA & Seguridad

**Rol:** Auditor técnico.

**Usar para:**

* Revisión de RLS.
* Detección de fugas de datos.
* Edge cases de seguridad.
* Validación de flujos críticos.

---

## Flujo de Trabajo Recomendado

1. PRD define la regla.
2. Claude descompone la lógica.
3. Codex implementa backend.
4. OpenCode conecta UI.
5. Gemini audita.

---

## Regla de Oro

Si un agente contradice el PRD, el agente está equivocado.