# 🤖 PROMPTS OPERACIONALES — Valírica AA-Agent > Kit de prompts optimizados para trabajar con Claude Code de forma eficiente, segura y enfocada por cliente. --- ## 📥 PROMPT DE APERTURA — Inicio de Sesión > **Cuándo usarlo:** Cada vez que abres Claude Code para trabajar en un cliente. > **Para qué:** Limitar contexto a un solo cliente, ahorrar tokens, evitar cambios accidentales en otros proyectos. ### Versión completa ``` CONTEXTO DE TRABAJO — VALÍRICA Estoy trabajando en el repositorio AA-Agent ubicado en: ~/Documents/AA-Agent HOY VOY A TRABAJAR EXCLUSIVAMENTE EN: Cliente: [NOMBRE_CLIENTE] Carpeta: ~/Documents/AA-Agent/[NOMBRE_CARPETA]/ PROTOCOLO DE INICIO: 1. Verifica que estoy en la rama main y actualizada: - git checkout main - git pull origin main 2. Crea un branch nuevo para esta sesión: - git checkout -b feature/[NOMBRE_CLIENTE]-[FECHA] 3. Limita tu contexto SOLO a la carpeta del cliente especificado. No leas, edites ni referencias archivos de otros clientes. 4. Confirma el estado actual: - Branch activo - Archivos presentes en la carpeta del cliente - Último commit relevante 5. Espera mis instrucciones antes de modificar nada. REGLAS DURANTE LA SESIÓN: - Trabaja únicamente en /[NOMBRE_CARPETA]/ - Haz commits incrementales cada cambio significativo - Nunca toques otros directorios del repo - Si necesitas contexto adicional, pregúntame antes de explorar - ⚠️ NO hagas push a main durante la sesión — los commits y push a main SOLO se hacen al ejecutar el PROMPT DE CIERRE. Cada push a main dispara GitHub Actions + deploy completo a cPanel; pushear por cada cambio pequeño desperdicia el workflow. Durante la sesión: commits locales en el branch están bien, y opcionalmente `git push origin ` para respaldo, pero el merge+push a main se reserva para el cierre. ¿Listo? Confirma branch y estado actual para arrancar. ``` ### Versión rápida ``` Voy a trabajar SOLO en ~/Documents/AA-Agent/[CLIENTE]/. Crea branch feature/[CLIENTE]-[FECHA] desde main actualizado. No toques otras carpetas. Confirma estado y espera instrucciones. ``` --- ## 📤 PROMPT DE CIERRE — Finalizar Sesión > **Cuándo usarlo:** Al terminar de trabajar para hacer merge y deploy automático. > **Para qué:** Garantizar push correcto, merge a main sin perder info, disparar deploy a cPanel. ### Versión completa ``` CIERRE DE SESIÓN — DEPLOY PROTOCOL PROTOCOLO DE CIERRE: 1. Resumen del trabajo realizado: - Lista los archivos modificados - Resume los cambios principales 2. Verifica integridad antes de hacer push: - git status - Muestra archivos pendientes de commit 3. Haz commit final con mensaje descriptivo: - git add . - git commit -m "[NOMBRE_CLIENTE]: descripción del cambio principal" 4. Push del branch a GitHub: - git push origin feature/[NOMBRE_CLIENTE]-[FECHA] 5. Merge a main: - git checkout main - git pull origin main (por si hay cambios remotos) - git merge feature/[NOMBRE_CLIENTE]-[FECHA] - git push origin main 6. Confirma que el deploy automático se disparó: - Indícame el link a GitHub Actions para verificar 7. Limpieza opcional: - Pregúntame si quiero eliminar el branch local REGLA DE SEGURIDAD: - Si hay conflictos en el merge, DETENTE y notifícame antes de resolver. - Nunca uses --force en push. - Nunca borres archivos sin confirmación explícita. Ejecuta el protocolo paso por paso, esperando mi confirmación entre cada paso crítico. ``` ### Versión rápida ``` Cierra sesión: commit con resumen, push del branch, merge a main, push a main. Pausa en cada paso para confirmar. Si hay conflicto, detente. ``` --- ## 🎯 EJEMPLO DE USO — Cliente KBPPay ### Al iniciar ``` Voy a trabajar SOLO en ~/Documents/AA-Agent/kbppay/. Crea branch feature/kbppay-2026-05-25 desde main actualizado. No toques otras carpetas. Confirma estado y espera instrucciones. ``` ### Al terminar ``` Cierra sesión: commit con resumen, push del branch feature/kbppay-2026-05-25, merge a main, push a main. Pausa en cada paso para confirmar. Si hay conflicto, detente. ``` --- ## 🌿 NOMENCLATURA DE BRANCHES | Tipo | Formato | Ejemplo | |---|---|---| | Feature | `feature/[cliente]-[fecha]` | `feature/kbppay-2026-05-25` | | Hotfix | `hotfix/[cliente]-[descripcion]` | `hotfix/kbppay-login-bug` | | Refactor | `refactor/[cliente]-[area]` | `refactor/kbppay-checkout` | --- ## ⚠️ REGLAS DE ORO ``` ✅ SIEMPRE git pull antes de empezar ✅ SIEMPRE trabajar en branch (no en main directo) ✅ SIEMPRE commit mensajes descriptivos en español ✅ SIEMPRE verificar Actions después de push a main ✅ SIEMPRE reservar el push a main para el PROMPT DE CIERRE ❌ NUNCA git push --force ❌ NUNCA borrar archivos sin confirmar ❌ NUNCA mezclar trabajo de varios clientes en un branch ❌ NUNCA pushear secretos, tokens o passwords ❌ NUNCA hagas push a main por cada cambio pequeño — dispara el deploy completo a cPanel y desperdicia el workflow. Push a main = solo al cierre de sesión, cuando la tarea está terminada y verificada. ``` --- ## 🔧 COMANDOS GIT DE EMERGENCIA ```bash # Deshacer último commit (sin perder cambios) git reset --soft HEAD~1 # Ver historial visual git log --oneline --graph --all # Descartar todos los cambios no commiteados git checkout . # Recuperar archivo eliminado por error git checkout HEAD -- ruta/al/archivo # Ver qué cambió en el último commit git show HEAD ``` --- ## 📡 ARQUITECTURA DEL DEPLOY ``` Tu Mac (~/Documents/AA-Agent/) ↓ git push GitHub: Juan-valirica/AA-Agent ↓ GitHub Actions (auto) cPanel: dev.valirica.com/AA-Agent/ ✅ ``` --- *Última actualización: Mayo 2026 — Mantenido por F.R.I.D.A.Y. para Valírica* --- --- # 🦁 DM DIARIO — REY GUERRERO · Sesión 2026-05-29 > **Documento de Misión** listo para pegar al inicio de cada sesión sobre este cliente. > Contiene estado real del repo, inventario de assets y fases pendientes. --- ## PROMPT DE APERTURA — REY GUERRERO (versión completa) ``` CONTEXTO DE TRABAJO — VALÍRICA / REY GUERRERO Fecha: 2026-05-29 Branch activo: feature/rey-guerrero-2026-05-29 (ya creado desde main) Repo local: ~/Documents/AA-Agent/ Carpeta del cliente: ~/Documents/AA-Agent/Rey Guerrero/ ═══════════════════════════════════════════════ QUIÉN ES EL CLIENTE ═══════════════════════════════════════════════ Rey Guerrero — Chef e investigador gastronómico del Pacífico colombiano. - Restaurante: Calle 77 #14-24, Bogotá (Ma–Vi 12-22h · Sá 12-23h · Do 12-18h) - Premio: Gourmand World Cookbook Awards 2025 — Best in the World - Libro: "Sabores de Resistencia" (391 pp.) - Contacto: +57-315-852-2818 - Web objetivo: reyguerrero.co - Redes: @reyguerreropg (IG, FB, TikTok) ═══════════════════════════════════════════════ ESTADO ACTUAL DEL PROYECTO ═══════════════════════════════════════════════ ARCHIVOS PRESENTES: Rey Guerrero/ ├── index.html ← Landing principal (7 057 líneas — MUY avanzado) ├── plan-rey-guerrero.md ← Estrategia completa (6 fases) ├── assets.zip ← Backup comprimido de assets ├── menu/ │ ├── index.html ← Menú en HTML puro (1 431 líneas) │ └── style.css ← Estilos del menú (1 530 líneas) └── assets/ ├── img/ │ ├── hero-fogon.png ← Hero principal (fogón) │ ├── AI-cangrejo-fogon.png ← OG image / Social │ ├── Libro-portada.jpg ← Portada del libro │ ├── libro.jpg.webp ← Versión webp del libro │ ├── reyguerrero.png ← Foto del chef │ ├── plato-negro.jpg ← Plato premium oscuro │ ├── guardiana-1.png ← Cocinera tradicional 1 │ ├── guardiana-2.png ← Cocinera tradicional 2 │ ├── guardiana-3.png ← Cocinera tradicional 3 │ ├── cangrejo.jpg / pulpo.jpg / pescado.jpg / langostinos.jpg │ ├── aborrajado.jpg / patacon.jpg / ceviches.jpg / entradas.jpg │ ├── arroces.jpg / arroz-caamrones.jpg / sancochos.jpg / sopas.jpg │ ├── carnes.jpg / filetes.jpg / pescados-enteros.jpg │ ├── bebidas-jugos.jpg / postres.jpg ├── logo/ │ ├── RG-_LOGO-DARK.svg ← Logo completo fondo oscuro │ ├── RG-_LOGO-LIGHT.svg ← Logo completo fondo claro │ ├── RG-_ICON-DARK.svg ← Isotipo fondo oscuro │ └── RG-_ICON-LIGHT.svg ← Isotipo fondo claro └── medios/ ├── blu radio.svg / wradio.svg ├── canal caracol.svg / canal rcn.svg / telepacífico.svg ├── el tiempo.svg / el pais.svg / revista semana.svg └── derspiegel.svg ← Cobertura internacional DESIGN SYSTEM (variables en index.html): --color-bg-dark: #0A0807 (fondo fogón) --color-text-light: #F5F1EB (crema) --color-accent-fire: #D9531E (brasa) --color-accent-gold: #C8601E (tierra quemada) --color-accent-orange: #eda23b (llama) --font-display: 'Playfair Display', serif --font-sans: 'Inter', sans-serif ═══════════════════════════════════════════════ ESTADO POR FASES (plan-rey-guerrero.md) ═══════════════════════════════════════════════ ✅ FASE 1 — Fundación y Design System ✅ FASE 2 — Hero inmersivo + sello Gourmand ✅ FASE 3 — Manifiesto narrativo con scroll ✅ FASE 4 — Ecosistema: libro, menú HTML, guardians ✅ FASE 5 — Motor de conversión (modal contacto + WhatsApp dinámico) ✅ FASE 6 — SEO avanzado (JSON-LD Restaurant + Book + Person) ⚙️ PENDIENTE — Verificar en browser real + optimizaciones pendientes ═══════════════════════════════════════════════ STACK TÉCNICO ═══════════════════════════════════════════════ - HTML5 semántico · CSS3 Vanilla (Custom Properties) · JS Puro - Sin frameworks — máximo rendimiento (<1.5s load) - Deploy destino: reyguerrero.co (cPanel/FTP o GitHub Actions) - Menú separado en /menu/ como sub-página HTML indexable ═══════════════════════════════════════════════ CONTEXTO ESTRATÉGICO ═══════════════════════════════════════════════ El sitio es un "Documental Interactivo Transaccional": → Narrativa cultural afro-pacífica (scroll storytelling) → SEO técnico con Schema.org (Restaurant + Book + Person) → Motor de conversión: reservas, prensa, eventos corporativos → Medios cubiertos: El Tiempo, El País, Revista Semana, Der Spiegel, Canal Caracol, Canal RCN, Telepacífico, Blu Radio, W Radio ═══════════════════════════════════════════════ REGLAS DE SESIÓN ═══════════════════════════════════════════════ - Trabaja ÚNICAMENTE en /Rey Guerrero/ - No toques /Cobs/, /Kbp/, /Valírica/ ni ningún otro cliente - Commits incrementales en español con prefijo "feat(rg):" / "fix(rg):" - Si necesitas verificar algo en browser, usa preview local - Pausa antes de cualquier destructivo (borrar sección, refactor masivo) ¿Listo? Confirma branch activo y espera mis instrucciones. ``` --- ## PROMPT DE APERTURA — REY GUERRERO (versión rápida) ``` Sesión Rey Guerrero · 2026-05-29 Branch: feature/rey-guerrero-2026-05-29 (ya activo) Carpeta: ~/Documents/AA-Agent/Rey Guerrero/ Landing de 7 057 líneas — todas las 6 fases del plan completadas. No toques otras carpetas. Confirma estado y espera instrucciones. ``` --- ## NOTAS DE CONTINUIDAD — REY GUERRERO | Item | Estado | |---|---| | Landing `index.html` | ✅ Construido (7 057 ln) — revisar en browser | | Menú `/menu/` | ✅ HTML puro indexable (1 431 ln) | | SEO JSON-LD | ✅ Restaurant + Book + Person | | Assets imágenes | ✅ Inventario completo (platos, guardianas, libro, chef) | | Logos SVG | ✅ 4 variantes (dark/light · logo/icon) | | Medios SVG | ✅ 9 outlets (CO + internacional) | | Deploy a reyguerrero.co | ⏳ Pendiente configurar | | Google Analytics / eventos | ⏳ Pendiente | | Optimización `.webp` masiva | ⏳ Pendiente |