Context Master

¿Qué hace Context Master?

Habilidad universal de gestión de contexto y planificación para tareas complejas, sesiones largas y proyectos con múltiples archivos. Funciona de la misma manera ya sea que estés en la aplicación Web, la API o Claude Code CLI; las bonificaciones específicas de CLI se encuentran en references/claude-code-cli.md.

Este SKILL.md es intencionadamente corto. El material detallado está en references/ — carga solo lo que necesites.

Cuándo activarlo

Actívalo proactivamente siempre que la solicitud coincida con una de las siguientes:

• Proyecto con múltiples archivos (3+ archivos relacionados, websites, apps, APIs, conjuntos de documentación).
• Decisión de arquitectura o tecnología ("deberíamos usar X o Y", "qué enfoque…").
• Análisis de investigación / comparación / compensaciones.
• Trabajo de refactorización o migración.
• Sesión larga de codificación donde la eficiencia del contexto importa.
• Cualquier tarea con 3+ pasos secuenciales o dependencias compartidas.

Si la solicitud es un solo archivo sin dependencias, omite esta habilidad.

El flujo de trabajo de 5 pasos (memorízalo)

Para cualquier proyecto con múltiples archivos — websites, apps, APIs, conjuntos de documentación — ejecuta estos cinco pasos en orden:

1. ALTO — no crees ningún archivo todavía.
2. PLANIFICA — utiliza pensamiento extendido o un documento de planificación (ambos igualmente válidos; consulta references/multi-file-planning.md).
3. ANUNCIA — indica la lista de archivos y el orden de creación al usuario.
4. CREA — escribe los archivos en el orden óptimo (fundaciones antes que dependientes).
5. VERIFICA — comprueba que cada referencia se resuelva; corrige los problemas antes de declarar finalizado.

Ejemplo resuelto (website portafolio)

Usuario: "Crea un portafolio con páginas de inicio, acerca de, proyectos y contacto."

Paso 1 ALTO    -- no empieces con index.html.
Paso 2 PLANIFICA    -- "Piensa mucho en la arquitectura: se necesitan 5 archivos,
                  styles.css es la dependencia compartida."
Paso 3 ANUNCIA -- "Crearé:
                  1. styles.css       (estilos compartidos)
                  2. index.html       (referencia a styles.css)
                  3. about.html
                  4. projects.html
                  5. contact.html"
Paso 4 CREA   -- escribe los archivos en ese orden.
Paso 5 VERIFICA   -- cada archivo HTML enlaza a styles.css; la navegación se resuelve.

Resultado: sin refactorizar, sin re-exportar, sin enlaces rotos.

La plantilla completa, los patrones de orden óptimo por tipo de proyecto (website / React / API backend / etc.) y las listas de verificación se encuentran en references/multi-file-planning.md.

Principios fundamentales (una línea cada uno)

1. Planifica antes de escribir — pensamiento extendido o documento de planificación, nunca omitir ambos.
2. Fundaciones primero — las dependencias compartidas (CSS, configuración, clases base, esquemas) preceden a los dependientes.
3. Delega el análisis profundo a contextos aislados — subagentes (CLI) o artefactos de pensamiento (Web/API) mantienen limpio el hilo principal.
4. Límites de fase — nombra cada fase ("Fase 1 completada; pasando a Fase 2: …") para que el contexto no se difumine.
5. Artefactos sobre contenido en línea — el código largo o la documentación va en artefactos/archivos, no en el historial del chat.
6. Divulgación progresiva — pide un fragmento a la vez; no agrupes pasos no relacionados.
7. Señales de reinicio — di "dejando de lado el enfoque anterior…" cuando cambies de dirección.
8. Reflexiona después de proyectos grandes — ¿se planificó? ¿Se rompieron las referencias? Usa la lista de verificación posterior al proyecto en references/multi-file-planning.md.

Justificación completa y ejemplos para cada principio: references/universal-best-practices.md.

Regla general de ahorro de tokens

Tamaño del proyecto	Sin planificación	Con planificación	Ahorro
Pequeño (3-4 archivos)	~6.000 tokens	~2.500 tokens	~58%
Mediano (7-8 archivos)	~12.000 tokens	~4.500 tokens	~63%
Grande (20+ archivos)	~35.000 tokens	~12.000 tokens	~66%

Una ventana de contexto de 200K tokens alberga aproximadamente 16-17 proyectos medianos con planificación, 7-8 sin ella — un aumento efectivo de 2.1x. Números y metodología en references/multi-file-planning.md.

Arquitectura pasiva de pensamiento profundo

El patrón más poderoso para la eficiencia del contexto: encamina el razonamiento profundo a un espacio aislado y devuelve un resumen breve al hilo principal.

• Claude Code CLI: /agent deep-analyzer "Ultrathink about [decisión]" — ~5K tokens de razonamiento ocurren fuera de banda; el contexto principal recibe un resumen de ~200 tokens (~23x eficiencia).
• Web / API: "Crea un artefacto de análisis profundo y ultrathink about [decisión]" — misma idea, artefacto en lugar de subagente.

Disparadores, anti-patrones y prompts listos: references/thinking-delegation.md.

Flujos de trabajo comunes (solo indicaciones)

Cada uno de estos tiene un procedimiento paso a paso en references/workflows.md:

• Flujo de trabajo 0 — Creación de website/proyecto con múltiples archivos (el predeterminado — los mismos 5 pasos anteriores con más detalle).
• Flujo de trabajo 1 — Toma de decisiones complejas (arquitectura, elección tecnológica).
• Flujo de trabajo 2 — Desarrollo de funcionalidades complejas (análisis → diseño → implementación → prueba → integración).
• Flujo de trabajo 3 — Investigación y evaluación tecnológica.
• Flujo de trabajo 4 — Generación e iteración de código mediante artefactos.
• Flujo de trabajo 5 — Refactorización con análisis aislado.

Anti-patrones (evítalos)

Lista rápida — ejemplos y soluciones en references/anti-patterns.md:

1. Crear archivos antes de planificar — desperdicia contexto en refactorizaciones.
2. Preguntar todo a la vez — sobrecarga el contexto y produce resultados superficiales.
3. Incluir código/documentación largos en el chat — infla el historial; usa artefactos/archivos.
4. Dejar que el razonamiento profundo ocurra en el hilo principal — cuesta ~5K tokens que podrían ser ~200.
5. Sin límites de fase — el contexto se difumina entre subtareas no relacionadas.

Solución de problemas

Cuando las sesiones se desvían (respuestas sin foco, conversaciones demasiado largas, código que se regenera en lugar de editarse, pensamiento extendido que no se activa), consulta references/troubleshooting.md para una tabla de síntoma → remedio que cubre Web/API y CLI por separado.

Bonificaciones de Claude Code CLI

Si estás ejecutando en Claude Code CLI, también obtienes:

• /clear, /compact, /continue — controles de contexto incorporados.
• /agent <nombre> — delega a un subagente aislado.
• CLAUDE.md — memoria persistente del proyecto.
• Scripts auxiliares para generar CLAUDE.md y definiciones de subagentes.

Detalles, invocaciones de scripts y los patrones de delegación de análisis profundo: references/claude-code-cli.md.

Los patrones de integración habilidad-subagente (cuando ambos están disponibles) se encuentran en references/agent-skills-integration-2025.md. Estrategias de contexto de formato largo y patrones de prompts para subagentes: references/context_strategies.md y references/subagent_patterns.md.

Mapa de referencias

Archivo	Úsalo cuando
references/multi-file-planning.md	Necesites plantilla de planificación, patrones de orden óptimo por tipo de proyecto, listas de verificación, reflexión posterior al proyecto.
references/universal-best-practices.md	Necesites la justificación o ejemplos de cualquiera de los 8 principios fundamentales.
references/workflows.md	Necesites un procedimiento paso a paso para un escenario específico (decisión, funcionalidad, investigación, refactorización).
references/thinking-delegation.md	Estés diseñando una delegación de análisis profundo o escribiendo el prompt de pensamiento.
references/anti-patterns.md	Estés revisando si el enfoque actual está desperdiciando contexto.
references/troubleshooting.md	La sesión esté desviándose, sea lenta o produzca demasiada explicación.
references/claude-code-cli.md	Estés ejecutando en Claude Code CLI y quieras herramientas de subagente / CLAUDE.md.
references/agent-skills-integration-2025.md	Estés combinando habilidades con subagentes en CLI.
references/context_strategies.md	Notas de estrategia de formato largo.
references/subagent_patterns.md	Patrones de prompts para subagentes.

Indicadores de éxito

• Anunciaste el plan antes de crear cualquier archivo.
• Los archivos fundamentales (CSS, configuración, esquemas) se escribieron antes que los dependientes.
• Ninguna referencia se rompió en la primera ejecución; no se necesitó refactorización.
• El razonamiento profundo ocurrió en un subagente o artefacto, no en el hilo principal.
• Las fases se nombraron a medida que las cruzabas.

Si alguno de esos falló, repasa references/anti-patterns.md y la sección posterior al proyecto de references/multi-file-planning.md antes de la siguiente tarea.