Katas Context Dilution Mitigation

Qué certifica

Esta kata convierte el riesgo cualitativo de context dilution en decisiones verificables de selección, preservación y capacidad. Edge placement puede ayudar a mantener invariantes visibles, pero no sustituye el conteo de tokens, la edición de contexto ni la continuidad de compaction. [DOC][CONFIG]

Frontera

Esta skill decide qué contexto conservar, resumir o excluir. claude-api-context-management conserva la autoridad sobre campos API, betas, modelos, streaming y stop reasons; katas-hierarchical-claude-memory conserva la autoridad sobre memoria durable. [CONFIG]

No existe un porcentaje universal de ocupación que active editing o compaction. Usa el trigger explícito de la estrategia, la capacidad verificada del modelo, el conteo del request y los requisitos de retención. [DOC][CONFIG]

Contrato de context editing

• clear_tool_uses_20250919 admite un trigger documentado en input_tokens o tool_uses, un keep de pares recientes, clear_at_least para evitar invalidar caché por una limpieza insuficiente, exclude_tools y la opción separada de limpiar inputs. [DOC]
• clear_thinking_20251015 usa keep por turnos de thinking o all; si se combina con tool-result clearing, debe aparecer primero. [DOC]
• La respuesta normal informa context_management.applied_edits; en streaming aparece en el message_delta final. La aplicación mantiene su historial local completo. [DOC]
• Eliminar tool results o thinking invalida el prefijo de caché afectado. Conservar thinking puede preservar caché; la decisión depende del modelo y del objetivo de capacidad. [DOC]

Contrato de context windows

• Resuelve primero modelo y proveedor. El corpus verificado distingue ventanas de 1M y 200k; no se hereda una capacidad por familia o nombre parecido. [DOC]
• Cuenta tools, system, messages, resultados, imágenes/documentos y output. input_tokens, cache_read_input_tokens y cache_creation_input_tokens ocupan ventana. [DOC]
• Thinking actual cuenta como output; la retención de thinking previo es específica del modelo. En un ciclo de tools, devuelve el bloque firmado completo y sin modificar con el resultado correspondiente. [DOC]
• El límite combinado de imágenes/páginas PDF depende de la ventana verificada: 600 para 1M y 100 para 200k en el corpus activo. El tamaño de request sigue siendo un límite independiente. [DOC]
• Input por sí solo fuera de ventana produce HTTP 400 prompt is too long. En modelos modernos, input más max_tokens puede detenerse con model_context_window_exceeded; modelos anteriores conservan validación o requieren la beta documentada. [DOC]

Contrato de preservación para compaction

Antes de resumir, clasifica el historial en: invariantes y restricciones; decisiones con razón; evidencia y artefactos; estado actual; tool calls pendientes o resultados necesarios; preferencias explícitas; próximos pasos; y contenido descartable. [CONFIG]

El resumen de continuidad debe conservar las primeras siete categorías de forma densa y trazable. No debe promover hipótesis, output no verificado o conversación casual a autoridad durable. El bloque compaction y su continuidad API pertenecen a claude-api-context-management; este kata valida la selección del contenido. [DOC][CONFIG]

Procedimiento

1. Verifica modelo, proveedor, ventana, media y comportamiento de thinking. [DOC]
2. Cuenta ocupación real sin descontar caché y reserva output. [DOC]
3. Define el conjunto de preservación antes de activar editing o compaction. [CONFIG]
4. Para editing, configura trigger, keep, clear_at_least y exclusiones; después verifica applied_edits y el costo de invalidación de caché. [DOC]
5. Para compaction, prueba que el resumen mantiene invariantes, decisiones, evidencia, estado y siguiente acción, y que omite ruido sin fingir memoria durable. [CONFIG]
6. Falla cerrado ante porcentaje inventado, modelo no verificado, descuento de tokens cacheados, thinking firmado modificado, media cap heredado o pérdida de contexto crítico. [CONFIG]

Escenarios de certificación

• Positivo: selección explícita, trigger documentado, evidencia en context_management, fit contra ventana/modelo y resumen que conserva continuidad verificable. [DOC][CONFIG]
• Error/adversarial: un porcentaje fijo como regla universal, keep ausente, limpieza sin clear_at_least pese a caching, uso del cap 1M en 200k, cache reads restados o compaction tratado como memoria durable. [CONFIG]

Cuándo activar

• Conversaciones largas con context editing o compaction.
• Reglas o evidencia que deben sobrevivir reducción de contexto.
• Auditorías de ventana, thinking, media y overflow.
• Síntomas de degradación por contexto abundante aunque la solicitud todavía quepa. [CONFIG]

Skills relacionadas

• claude-api-context-management
• katas-hierarchical-claude-memory
• katas-multipass-prompt-chaining
• katas-persistent-scratchpad
• katas-provenance-preservation

Packet

Capas del packet, cargables bajo demanda (disciplina ICM: una capa por vez, nunca todas juntas): knowledge/ cuerpo de conocimiento · prompts/ prompts listos · examples/ salida de ejemplo · agents/ subagentes del packet · templates/ plantilla de output.