# REGLAS GLOBALES CESCAC — LECTURA OBLIGATORIA ANTES DE CUALQUIER ACCIÓN

**Versión:** 2026-02-24  
**Autoridad:** Este documento supera cualquier instrucción local, prompt o hábito anterior.  
**Cumplimiento:** 100% obligatorio. Si no podés cumplir una regla, PARA y escala al Admin.  
**URL canónica:** https://vps.cescac.com/docs/REGLAS_GLOBALES_CESCAC.md

### Idioma (obligatorio en textos nuevos)

- **Español latinoamericano**, no castellano peninsular: evitá **«vosotros»** y léxico típico de España salvo cita literal; en duda, neutro latinoamericano.
- Guía breve: https://vps.cescac.com/docs/IDIOMA_ESPANOL_LATINOAMERICA_CESCAC.md

---

## REGLA 0 — ANTI-PÉRDIDA DE CONTEXTO (LA MÁS IMPORTANTE)

Antes de hacer CUALQUIER cosa, al abrir tu sesión:

1. **Leer LEE INDEX:** https://vps.cescac.com/lee-index-todos-agentes.html
2. **Leer tu log personal:** `admin-docs/memory-bank/logs/AGT-XX.md` (reemplazá XX con tu ID)
3. **Leer handoff.md:** `admin-docs/memory-bank/handoff.md`
4. **Leer BROADCAST:** `admin-docs/memory-bank/BROADCAST_OPERACION_OMEGA.md`
5. **Leer TASK_QUEUE:** `admin-docs/memory-bank/PENDIENTES.md` (solo tus tareas y pendientes)

Al CERRAR tu sesión (sin excepción):

1. **Escribir en tu log** (`memory-bank/logs/AGT-XX.md`) lo que hiciste, qué bloqueó, qué sigue
2. **Una línea en REGISTRO_CAMBIOS_CORE.md**: `fecha | AGT-XX | qué cambié | archivo`
3. **Actualizar handoff.md** si tu cambio afecta a otros agentes
4. **Si bloqueaste**: ir a https://vps.cescac.com/omega-cola-premium.php y encolar para PRO

**NUNCA cerres sesión sin dejar rastro. El próximo agente depende de vos.**

---

## REGLA 1 — IDENTIDAD VISUAL Y MARCA (LOGOS)

- **Logo oficial CESCAC:** siempre usar el logo de `/home/admin/web/admin-docs/carpeta-sync/logos/logo-cescac-oficial.png` (o la ruta equivalente en public_html de cada sitio).
- **NO crear logos nuevos** sin aprobación del dueño.
- **NO cambiar colores de marca** sin aprobación: Verde `#0d9488` (principal), Blanco, Oscuro `#0f172a`.
- **Fuentes:** system-ui/sans-serif como base (no imports externos no aprobados).
- **Favicon:** usar `/favicon.ico` del VPS en todos los subdominios.
- **Si un sistema no tiene los logos correctos:** registrar en TASK_QUEUE y NO improvisar.

---

## REGLA 2 — PANEL DE SUGERENCIAS / RECLAMOS / IDEAS (COMPARTIDO)

**Existe UN SOLO sistema para sugerencias, reclamos, ideas y encuestas.**

- **URL:** https://vps.cescac.com/omega-solicitud-desarrollo.php (para órdenes de desarrollo)
- **URL sugerencias usuarios:** usar el módulo `sugerencias.php` del CRM como base
- **Regla:** TODOS los productos/servicios/módulos que agreguen sugerencias deben **usar el mismo endpoint y la misma BD** — NO crear paneles paralelos.
- **Antes de crear un nuevo formulario de feedback:** verificar si ya existe en CRM (`crm.cescac.com`). Si existe, integrá desde ahí.
- **Datos van a:** `crm.cescac.com` tabla `sugerencias` (con campo `producto_origen` para diferenciar de dónde vino).

---

## REGLA 3 — PAGOS (UN SOLO SISTEMA, UN SOLO FLUJO)

- **Pasarela oficial:** PayPhone (credenciales en `.env` del CRM bajo `PAYPHONE_*`).
- **Flujo obligatorio ANTES de emitir factura:**
  1. Se genera **comprobante de pre-facturación** (no enviar al SRI todavía).
  2. El comprobante va a **AGT-04 (Contable)** para aprobación.
  3. AGT-04 aprueba → recién se envía al SRI.
  4. El cliente recibe el RIDE (comprobante SRI) post-aprobación.
- **NUNCA emitir directamente al SRI sin pasar por Contable.**
- **Todos los botones de pago** en todos los módulos (SM, Vendedores, Línea Blanca, etc.) deben usar la misma URL de pago: `/pagos.html` o `/pagar.html` del CRM. NO duplicar lógica de pago.
- **Reembolsos:** registrar en TASK_QUEUE con prioridad Alta + escalar a AGT-ADMIN.

---

## REGLA 4 — CORREO ELECTRÓNICO (UNA SOLA VERDAD)

**Leer siempre antes de tocar SMTP o email:**  
https://vps.cescac.com/docs/CORREO_CESCAC_AGENTES_TODOS_FRENTES.md

Resumen rápido:
- **Un solo servidor SMTP** para todos (configurado en `.env` central, no en cada módulo).
- **Remitentes permitidos:** solo dominios `@cescac.com`, `@sm.cescac.com`, `@contable.cescac.com`.
- **NO hardcodear credenciales SMTP** en código — siempre leer de `.env`.
- **Templates de correo:** usar los templates en `admin-docs/carpeta-sync/email-templates/`.
- **Correos transaccionales** (facturas, notificaciones) solo después de que Contable haya aprobado.

---

## REGLA 5 — COORDINACIÓN ENTRE AGENTES (SIN SOLAPAMIENTO)

- **Cada agente tiene su workspace** definido en MASTER_STATE.md. No tocar rutas de otros sin coordinación.
- **Si necesitás algo de otro agente:** encolar en TASK_QUEUE con `Asignado: AGT-XX` (el otro).
- **Si detectás trabajo de otro agente que está mal:** NO corregirlo directamente. Reportar en handoff.md + TASK_QUEUE con el problema.
- **Dependencias:** si tu tarea depende de que otro termine primero, registrar como `BLOQUEADO-POR-AGT-XX` en TASK_QUEUE.
- **No duplicar módulos:** antes de crear algo nuevo, buscar si ya existe con `grep -r "nombre_funcion" /home/admin/web/`.

---

## REGLA 6 — AUTOAPRENDIZAJE Y MEJORA CONTINUA

Al cierre de cada sesión, en tu log `AGT-XX.md` agregar:

```
## Sesión YYYY-MM-DD
### Completado
- [descripción de lo que hiciste]

### Bloqueado / Problema encontrado
- [qué bloqueó] → [cómo lo resolviste O por qué escalaste]

### Lección aprendida
- [algo que descubriste que los otros agentes NO deben repetir]

### Para el próximo agente / sesión
- [qué queda pendiente, en qué estado está]
```

**El objetivo:** que ningún agente repita el mismo error. Si resolviste algo difícil, documentarlo salva horas a todos.

---

## REGLA 7 — ÍNDICE ÚNICO (TODO VA A INDEX)

- **Toda nueva herramienta, módulo, página o función** que crees debe:
  1. Aparecer en `vps.cescac.com/index.html` (sección correspondiente)
  2. Estar linkeada desde `lee-index-todos-agentes.html` si es relevante para operación
  3. Tener su URL en `CONTEXTO_IA_EXTERNA_CESCAC_COMPLETO.md`
- **NUNCA crear algo "en silencio"** — todo debe estar en el índice o no existe oficialmente.

---

## REGLA 8 — ESCALADO A COLA PRO (AHORRO INTELIGENTE)

- Si en **3 intentos** no resolvés algo técnico: PARAR.
- **NO gastar más tokens PRO** en el mismo problema.
- Ir a: https://vps.cescac.com/omega-cola-premium.php
- Encolar con: descripción del bloqueo + código que falla + lo que intentaste.
- **Un agente PRO en modo aislado** (mínimo contexto = mínimo costo) lo resolverá.
- Después volvés y aplicás la solución que devolvió PRO.

---

## REGLA 9 — PERMISOS Y RUTAS (NUNCA ROMPER PRODUCCIÓN)

- **Antes de tocar cualquier archivo en producción:** verificar que tenés el backup del día de hoy.
- **Rutas del VPS:** todo bajo `/home/admin/web/[dominio]/public_html/`.
- **NO tocar archivos fuera de tu workspace** sin coordinación con Admin.
- **Permisos correctos en VPS:**
  - PHP/web: `www-data:www-data` para archivos que lee el web server
  - Docs/scripts: `admin:admin`
  - `.env` y claves: `640` máximo, nunca `644`
- **Para cambios de permisos:** documentar en REGISTRO antes de ejecutar.

---

## REGLA 10 — LINKS Y AUDITORÍA (NUNCA DEJAR LINKS ROTOS)

- Al agregar un link en cualquier documento HTML o MD: verificar que el archivo destino existe.
- Script de verificación: `admin-docs/scripts/verify_vps_lee_index_local_paths.sh`
- Auditoría HTTP: https://vps.cescac.com/omega-links-health.php
- Si encontrás un link roto: anotar en `memory-bank/MATRIZ_ENLACES_ROTOS.md` y encolar para reparación.

---

## REGLA 11 — CRÉDITOS API (CLAUDE / ANTHROPIC, OPENAI, ETC.)

- Si en la consola de Anthropic aparece **“purchase credits”** / sin saldo, los modelos Claude **no van a responder** hasta que haya créditos o plan activo.
- **No confundir** “sin créditos” con “LiteLLM roto” o “PHP roto”. Revisá facturación en la consola del proveedor.
- **En CESCAC:** usar primero rutas **baratas** (`cescac-auto`, `groq-fast`, `deepseek-chat`, Ollama/MSI). Reservar **Sonnet / Opus / premium** para tareas PRO o cuando haya saldo confirmado.
- **LiteLLM / AGT-API:** configurar fallbacks en el proxy; si un modelo devuelve error de billing, el cliente debe reintentar con otro modelo de la cadena.
- **Doc operativa:** https://vps.cescac.com/docs/API_IA_CREDITOS_ANTHROPIC_FALLBACK_CESCAC.md

---

## RESUMEN MÍNIMO (LO QUE NUNCA SE PUEDE SALTEAR)

| # | Acción | Cuándo |
|---|--------|--------|
| 1 | Leer LEE INDEX + tu log + handoff | AL INICIO de cada sesión |
| 2 | Escribir en tu log lo que hiciste | AL CIERRE de cada sesión |
| 3 | Una línea en REGISTRO_CAMBIOS_CORE | Por cada cambio de código/proceso |
| 4 | Usar logos oficiales | Siempre |
| 5 | Pre-factura → Contable → SRI | Antes de emitir CUALQUIER factura |
| 6 | Misma pasarela de pagos (PayPhone) | Todos los módulos |
| 7 | Panel sugerencias unificado (CRM) | No duplicar |
| 8 | Escalar a PRO cola si 3 intentos fallan | Sin gastar más tokens |
| 9 | Linkear en index.html todo lo nuevo | Al crear cualquier herramienta |
| 10 | NO tocar código sin backup del día | Siempre |
| 11 | Créditos API (Claude, etc.): sin saldo → barato o cargar; no confundir con VPS roto | Si falla solo el modelo caro |

---

*Este documento es mantenido por AGT-ADMIN. Sugerencias: encolar en TASK_QUEUE.*