repo_Claude/.claude/CLAUDE.md

Preferencias globales

Aplican a todas las sesiones de Claude Code, en cualquier proyecto.

Idioma

• Háblame SIEMPRE en español, sin importar el idioma del prompt, del código o de las instrucciones del proyecto.

Modo caveman (plugin caveman)

• El estilo caveman aplica SOLO a tus mensajes de chat conmigo.
• Todo texto que escribas DENTRO de archivos va en prosa normal y completa, nunca en estilo caveman: código, comentarios, docstrings, archivos .md y documentación, mensajes de commit, cuerpos de PR y descripciones de issues.
• Nombres de función/variable, paths, comandos, flags y mensajes de error citados se mantienen literales (no se traducen ni se comprimen).

Nota de mantenimiento: estas preferencias también están reforzadas en el plugin caveman (skills/caveman/SKILL.md + src/hooks/caveman-mode-tracker.js). Las copias del plugin en ~/.claude/plugins/{cache,marketplaces}/caveman/ se sobrescriben al ejecutar claude plugin update; este archivo es el hogar durable de las preferencias y no se pierde.

Navegación web — usa SIEMPRE el MCP del navegador

Para CUALQUIER tarea de navegación, lectura o automatización web (abrir páginas, login, scraping, rellenar formularios, reconocimiento de endpoints) usa SIEMPRE el MCP browser_mcp. NUNCA CDP crudo inline (heredoc WebSocket, Runtime.evaluate a mano), NUNCA Playwright/Selenium, NUNCA lanzar chromium/google-chrome a pelo para esto.

• El MCP opera sobre un Chrome aislado (puerto 9333) separado del navegador diario.
• Navegar: tab_new / tab_navigate (+ tab_select para elegir pestaña, nav_back / nav_forward).
• Esperar: page_wait_load (DOM listo) / page_wait_idle (red en reposo; ya ignora WebSocket/EventSource, no cuelga en SPAs).
• Leer (por defecto, SIN capturas): page_perceive (accessibility tree → outline indentado con marcadores #ref accionables) y page_get_text (texto visible, truncable). NO uses page_screenshot para leer: hoy guarda la imagen a archivo y el agente no la ve; las capturas son solo para depuración visual puntual, no para percepción.
• Actuar: dom_click_ref / dom_type_ref / dom_hover_ref (por el #ref del outline de page_perceive), dom_find_ref_by_text, press_key, scroll. El bucle natural es: page_perceive → decidir sobre los #ref → dom_*_ref → page_perceive de nuevo (auto-observa el efecto).

Si el MCP no expone una capacidad concreta, usa fn run cdp_<x> antes de escribir CDP crudo: hay 46 funciones del dominio browser indexadas en el registry (incluidas cdp_navigate, cdp_get_text, cdp_perceive_outline, cdp_click_ref). El registry SÍ tiene navegación CDP genérica — si no la encuentras por búsqueda, mejora la búsqueda, no reinventes con un heredoc.

Requisito de disponibilidad: el browser_mcp debe estar registrado en el .mcp.json accesible a la sesión (hoy en projects/web_scraping/.mcp.json). Si trabajas en otra carpeta y las tools browser_*/page_*/dom_* no aparecen, registra el MCP en el .mcp.json de esa sesión.