Un prompt para que tu agente revise tu documentación y cómo entra en su ventana, y proponga cambios sin tocar un solo fichero. Funciona en Claude Code, en Codex CLI y en cualquier agente con acceso de lectura al repositorio.
Audita la documentación y la carga de contexto de este proyecto. Esta fase es solo de diagnóstico y propuesta: no modifiques, muevas, borres ni crees archivos. No hagas commits ni ejecutes hooks, scripts de arranque o comandos del repositorio para investigarlos. Usa exclusivamente herramientas de lectura y búsquedas no destructivas permitidas en esta sesión. No accedas a producción, servicios de pago, secretos, datos de clientes ni otros proyectos. OBJETIVO Separar dos decisiones: dónde vive la información y cuándo necesita entrar en el contexto del agente. No presupongas que más archivos significa mejor organización ni que todos los documentos deban leerse al arrancar. 1. INVENTARIO Y RUTAS DE CARGA Empieza por inventariar nombres, encabezados, tamaños y referencias sin volcar todo el repositorio al contexto. Examina los archivos de instrucciones aplicables (por ejemplo, CLAUDE.md y AGENTS.md), configuración de hooks, imports, rules, descripciones de Skills y las memorias accesibles y autorizadas para este proyecto. Sigue sus referencias de forma selectiva. Distingue: contenido inyectado automáticamente; instrucciones que piden una lectura posterior; carga condicionada por scope o activación; y documentos disponibles que solo se leen al consultarlos. No clasifiques un archivo por su nombre. No interpretes un enlace normal como una importación automática ni ignores imports como @ruta en CLAUDE.md. Respeta la fuente compartida de instrucciones que ya use el proyecto. Si AGENTS.md es la fuente canónica y CLAUDE.md la importa, no propongas mantener dos copias del contenido. Comprueba cómo se carga en esta configuración: una importación como @AGENTS.md, una referencia en prosa o soporte nativo del cliente no son el mismo mecanismo. No leas carpetas personales o globales externas sin autorización. Si no puedes revisar una fuente aplicable, indícalo como límite de cobertura. 2. COMPOSICIÓN Y AUTORIDAD Para cada documento relevante, identifica su función: instrucciones, planificación, spec, plan de ejecución, estado actual, historial de progreso, decisión, referencia o aprendizaje persistente. Una función puede estar repartida y un archivo puede contener varias. Evalúa si las secciones necesitan mantenerse o cargarse por separado; no exijas un archivo por concepto. Busca primero fuentes existentes antes de proponer otras nuevas. Identifica hechos mantenidos manualmente en varios documentos, contradicciones y referencias rotas. Propón cuál será la fuente autoritativa y qué documentos deberían enlazarla. Una copia local y su versión remota en Git no son dos fuentes independientes por ese solo hecho. No confundas fecha antigua con contenido incorrecto: verifica contra código, decisiones o fuentes autorizadas; si no es posible, marca sin verificar. 3. PROPUESTA DE ESTRUCTURA Propón qué conservar, fusionar, actualizar, extraer, crear o enlazar. Primero identifica las distintas funciones/secciones del documento grande y compáralas con fuentes ya existentes. Si la información ya tiene un destino adecuado, reconcilia allí lo único, vigente y útil, y propón enlaces desde el origen. Si no existe destino y realmente necesita documento propio, propón crearlo. No asumas un archivo nuevo por cada fragmento ni sobrescribas diferencias sin resolver su significado. Mantén toda información única útil y respeta decisiones del usuario. No propongas borrar documentos únicamente porque no encuentres referencias. Conserva las specs, planes y fuentes existentes que ya cumplan su función. El estado actual y el histórico pueden necesitar consultas distintas: no conviertas un log creciente en lectura obligatoria universal. Incluye una tabla: origen/sección | función | destino existente o nuevo | operación propuesta | evidencia | riesgo. 4. PROPUESTA DE CARGA Define un contexto inicial mínimo con las instrucciones esenciales y punteros útiles. No retires requisitos de seguridad ni límites de permisos. Para cada fuente restante, indica qué tarea o condición justifica consultarla y cómo la encontrará el agente. Describe los mecanismos reales del cliente utilizado. No inventes una taxonomía universal de tres niveles ni asumas que un índice se carga por existir. Propón el mapa dentro del archivo de instrucciones principal cuando quepa con claridad; usa un índice aparte solo si aporta valor y explica cómo se descubre. Los punteros deben indicar propósito, ruta y cuándo consultar. El mapa principal no tiene que listar cada archivo: puede apuntar a índices temáticos que se lean a demanda. No crees una jerarquía de índices innecesaria ni dupliques manualmente el catálogo de Skills o el índice de memoria si el cliente ya los proporciona. Enlaza a las fuentes existentes y conserva su alcance. No identifiques automáticamente una spec con un plan ni obligues a separar el progreso o el registro de decisiones de un plan que ya los mantiene correctamente. No conviertas los documentos bajo demanda en imports que los precarguen todos. Incluye dos ejemplos contrastados de tareas: para cada una, indica qué documentos sería necesario consultar y cuáles no por defecto, considerando dependencias entre áreas. 5. MEDICIÓN Y VALIDACIÓN Separa hechos observados, comportamiento inferido de configuración y estimaciones. Cita archivo y línea o evidencia de sesión para cada hallazgo. Reporta bytes y líneas solo si los has medido. Si no tienes un contador apropiado para el modelo utilizado, no presentes tokens como medición exacta. El tamaño del archivo no demuestra que se haya leído entero. Una orden de lectura tampoco prueba ejecución. No prometas ahorro de cuota, dinero, latencia o mejora de calidad sin comparación. Si hay resultados de /context (o /context all) en Claude Code, úsalos como fotografía de la ocupación actual, no como prueba suficiente de toda la cadena de carga. En Codex CLI, /status muestra el uso de contexto de la sesión; no lo presentes como un desglose idéntico a /context. Usa trazas reales para determinar las lecturas. Propón una comparación antes/después con sesiones nuevas, misma tarea, modelo y configuración, revisando además la traza de lecturas. No ejecutes esa prueba sin autorización. Propón comprobaciones de enlaces, conservación de contenido y tareas representativas, sin imponer un cambio en un log por cada commit ni afirmar que un lint de enlaces prueba frescura semántica. ENTREGA - Diagnóstico priorizado con evidencias y límites de cobertura. - Tabla de operaciones propuestas, sin aplicar nada. - Ejemplo concreto del punto de entrada con instrucciones y mapa. - Contexto inicial propuesto y rutas de consulta para las dos tareas. - Prueba de aceptación antes/después que valide tanto ocupación como que no se omita información necesaria. Termina esperando aprobación. No ejecutes la migración. NOTA DE USO Esta petición de solo lectura no sustituye los permisos de las herramientas. Usa un entorno y permisos de lectura adecuados. No des acceso a producción ni a secretos para ejecutar esta auditoría.
Qué documentos existen y, sobre todo, CÓMO entran en el contexto.
Tienes la sensación de que el agente arranca cargado y no sabes con qué.
Un documento disponible y un documento que se inyecta solo no son lo mismo. El prompt obliga a separar cuatro cosas: lo que entra automáticamente, lo que una instrucción manda leer después, lo que depende de una activación y lo que solo se lee si alguien lo consulta.
Qué función cumple cada documento y cuál manda cuando dos se contradicen.
Un mismo hecho vive a mano en varios sitios y ya no sabes cuál es el bueno.
Un fichero puede llevar dentro instrucciones, spec, plan, estado e histórico a la vez, y cada una de esas cosas cambia a un ritmo distinto. Antes de proponer nada, el prompt busca destinos que ya existen.
Qué conservar, qué fusionar, qué extraer y qué crear. Con una tabla y su evidencia.
Quieres reorganizar sin perder nada y sin acabar con cuarenta ficheros nuevos.
La salida es una tabla de origen, función, destino, operación, evidencia y riesgo. Primero se reconcilia donde ya hay sitio; crear un documento nuevo es la última opción, no la primera.
Qué entra por defecto y qué se consulta, con la condición que lo justifica.
Es la parte que de verdad cambia el coste: dónde vive algo y cuándo se carga son dos decisiones distintas.
Define un contexto inicial mínimo (instrucciones esenciales más punteros) y, para cada fuente restante, qué tarea justifica consultarla y cómo la va a encontrar el agente. Incluye dos tareas de ejemplo contrastadas.
Qué está medido, qué está inferido y qué es una estimación. Con fichero y línea.
Es lo que separa una auditoría de una opinión ordenada.
Separa hechos observados, comportamiento inferido de la configuración y estimaciones, y pide citar fichero y línea o evidencia de sesión en cada hallazgo. Propone una prueba antes/después con la misma tarea, modelo y configuración.
Interactive version by @itsmarbuilds