> [!IMPORTANT]
> **ECOSISTEMA POS/ERP INTELIGENTE:** Toda IA debe adherirse estrictamente a este manifiesto. Modificar solo vía Rol 10.
> **HANDOVER AUTOMÁTICO:** Al iniciar sesión, leer `HANDOVER.md` y `AI_STATE.md`. Revisar `soluciones/` para fixes previos.

# 1. Stack Tecnológico y Arquitectura
- **Backend:** Laravel 13.16+, PHP 8.4 (`declare(strict_types=1);`). Service Layer, Thin Controllers, API Resources. **Cero Repositories/DTOs**.
- **Frontend Web:** Laravel Blade, AdminLTE 3, Alpine.js, Livewire v4. DataTables.
- **TV Wall (`/tv`):** Dashboard público panorámico. Regla: `.cursor/rules/tv-wall-display.mdc`.
- **Frontend Móvil:** Vue 3, Quasar, Capacitor, Pinia. Offline-First.
- **Testing:** PHPUnit 12, SQLite. **262 tests, 1436 aserciones en verde**. Verificar con `php artisan test --compact`.
- **BD / Packages:** MySQL (prod), SQLite (test). Spatie, Sanctum v4, Yajra, etc.
- **MCP / AI:** laravel/boost v2, pulse, pail, prompts, mcp (ver `.opencode/mcp.json`).

# 2. Cadena de Mando (Workflows)
Flujo secuencial en `.opencode/workflows/`. Prohibido full-stack en 1 prompt.
- **01/02**: Diseño & BD. **03**: Backend API. **04A/04B/11**: Frontend (Web/Móvil) & UI/UX.
- **05/06**: QA & Seguridad. **07/08**: Ops & Servers. **09/12/13**: Soporte & Debug.
- **10**: Prompt Engineer (Meta-Agente).

# 3. Protocolos Inquebrantables
1. **Modo Caveman & Canary Permanente:** DEBES responder SIEMPRE usando el estilo ultracorto (skill `caveman`) y aplicar SIEMPRE el protocolo antirotura (skill `context-canary`) en CADA respuesta, sin necesidad de comandos. Respuestas hiper-directas.
2. **Contexto Obligatorio:** Cargar skills de `.agents/skills/` antes de codificar. Los skills disponibles son: `apexcharts`, `api-design-principles`, `brainstorming`, `caveman`, `changelog-generator`, `context-canary`, `eloquent-best-practices`, `error-handling-patterns`, `find-skills`, `fuck-slop`, `grill-me`, `impeccable`, `interface-design`, `interface-kit`, `junior-to-senior`, `laravel-best-practices`, `laravel-specialist`, `loop-factory`, `pulse-development`, `quasar-skilld`, `software-design-philosophy`, `systematic-debugging`, `tailwindcss-development`, `ui-ux-pro-max`, `verification-before-completion`, `writing-plans`.
3. **Verificación Estricta:** TDD Agéntico obligatorio (`php artisan test`).
4. **Cierre Atómico:** Actualizar `AI_STATE.md`, `HANDOVER.md` y `soluciones/YYYY_MM_DD_R[XX]_nombre.md` al terminar.
5. **Resources:** Todo a `App\Http\Resources\V1\{Modulo}\`.
6. **SQLite Queries:** Usar `whereBetween` / `whereDate` (no `MONTH()`).
7. **Roles Seed:** Crear `Super Admin`, `Administrador`, `Gerente` en tests/seeders antes de usarlos.
8. **Date cast:** En SQLite usar `$model->fecha->toDateString()` para assertions.
9. **PHP 8.4:** `declare(strict_types=1)` y sin coerción implícita.
10. **Tooltips:** Atributo `title` obligatorio en botones/iconos de vistas Blade (máx 10 palabras).
11. **Blindaje BD Tests:** PROHIBIDO `Artisan::call('config:clear')` en setup de tests (borra DB MySQL).
12. **Manual Usuario:** Funcionalidad nueva debe documentarse en `/ayuda` para usuario final.

---
> [!NOTE] 
> Las extensas directivas de **Laravel Boost** han sido separadas para optimizar contexto. 
> Consultar `.agents/laravel-boost-guidelines.md` si requieres reglas específicas del MCP.