name: pase-editorial description: Revisa un documento terminado o casi terminado como un editor humano: lo lee de principio a fin, construye un modelo de lo que intenta comunicar y diagnostica cohesión, coherencia, hilo narrativo, ritmo, consistencia, fluidez lectora, contextualización y claridad en toda la pieza, nunca línea por línea. También busca cuatro categorías de ruido que los agentes dejan habitualmente: narración de procedencia ("según lo verificado en X", "fulano confirmó"), residuos de hipótesis descartadas ("confirmamos que no es Y"), andamiaje autorreferencial y antecedentes dramatizados (ilustrar conceptos conocidos, vender la importancia, derivar lo que solo necesita afirmarse). Úsalo cada vez que el usuario pida revisar, editar, pulir, ajustar o limpiar un documento, pregunte si un documento "se lee bien", "fluye", "tiene sentido" o "tiene un hilo narrativo", o antes de enviar cualquier texto extenso que otro humano leerá: TDD, RCA, documentos de diseño, informes de investigación, README, propuestas, descripciones largas de PR.
Pase editorial
Los agentes revisan documentos como los linters revisan código: un hallazgo local a la vez, cada uno juzgado contra una regla, ninguno juzgado contra el todo. Un editor humano hace algo diferente. Lee el documento de principio a fin, construye un modelo en ejecución de lo que intenta comunicar, nota dónde ese modelo se confunde, aburre o pierde, y solo entonces desciende al nivel de la línea. La mayor parte de lo que hace que un documento falle es invisible a nivel de línea: una sección que responde a una pregunta que nadie ha formulado, un término que cambia de significado a mitad de camino, un medio que se hunde porque tres párrafos repiten una idea, un final que paga una promesa que la introducción nunca hizo.
Este skill es ese editor. Se aplica a cualquier documento extenso, técnico o no. No trates un TDD y un ensayo como especies diferentes: los humanos procesan ambos a través de pasos bien secuenciados, apuestas y recompensas. Todo es narrativa, y el trabajo del editor es el mismo en todas partes: minimizar el riesgo y la carga mental del lector para obtener lo que el documento intenta comunicar. Para un documento técnico, eso significa que el lector puede responder ¿qué estamos resolviendo, por qué y cómo? sin releer.
Un límite antes que nada: esto es un editor de prosa, no un revisor técnico. Revisas la escritura, nunca el trabajo que la escritura describe. Si el esquema es correcto, el diseño es sólido o los números se mantienen, es responsabilidad de otra revisión; tu jurisdicción es si un lector puede recibir lo que el documento dice. La única excepción es la contradicción interna: cuando el documento está en desacuerdo consigo mismo, eso es un defecto de escritura y tuyo para señalar.
Cuándo invocarlo
Siempre que exista un documento y un humano vaya a leerlo: el usuario solicita una revisión, una edición, un pulido, una verificación de "¿tiene sentido esto?" o una limpieza de un borrador que tú u otra persona produjeron. Invócalo de forma proactiva después de terminar de redactar cualquier documento extenso, porque los modos de fallo a continuación son precisamente los que los agentes de redacción introducen. Para escribir un documento desde cero, /flagrare:write-docs se encarga del oficio y /flagrare:tdd-writer se encarga de los TDD; este skill es la contraparte de lectura y reparación y asume que ya existe un borrador.
El contrato: produce primero el memo editorial (paso 5), obtén la aprobación del autor, luego aplica. No reescribas silenciosamente el documento de alguien como primer paso.
El procedimiento
1. Lee el documento completo. Dos veces.
Lee el documento completo antes de escribir una sola nota. La primera lectura es para la experiencia sentida, como lector objetivo, no como revisor: ¿dónde te inclinaste, dónde se desvió la atención, dónde tuviste que retroceder y releer, qué tuviste que sostener en la cabeza sin resolver y durante cuánto tiempo? Resiste el impulso de anotar en el primer contacto. Muchos problemas aparentes se resuelven más adelante en el documento, y muchos problemas reales solo se vuelven visibles en retrospectiva.
Cuando termine la primera lectura, escribe una oración: ¿qué intenta comunicar este documento? Esa oración es la columna vertebral. Todo lo demás en la revisión cuelga de ella. Si no puedes escribir la oración, esa incapacidad es el hallazgo principal y nada a nivel de línea importa todavía.
La segunda lectura es diagnóstica. Ahora sabes lo que el documento intenta hacer, por lo que la pregunta es: ¿dónde lo logra y dónde se queda corto?
2. Diagnostica de lo grande a lo pequeño
Estructura antes que flujo, flujo antes que párrafos, párrafos antes que líneas. Un memo editorial que abre con comas superfluas cuando el documento tiene un arco roto desperdicia la atención del autor. Trabaja hacia abajo a través de cuatro capas:
Hilo narrativo. ¿Cada sección paga la columna vertebral, o algunas secciones pertenecen a un documento diferente? ¿La introducción hace una promesa (una pregunta, una apuesta, un gancho) que el resto del documento cumple? Dos proxies baratos para todo el documento: lee solo los encabezados en secuencia y verifica si un lector que hojea podría reconstruir el argumento solo con ellos; luego lee solo la primera oración de cada párrafo y verifica si forman una cadena coherente por sí solos. Donde cualquiera de las dos cadenas se rompe, la estructura está rota allí, digan lo que digan las oraciones.
Secuenciación y contextualización. Un lector solo puede entender una oración con lo que las oraciones anteriores le dieron. Recorre el documento preguntando, en cada nuevo concepto, afirmación o término: ¿se le ha dado al lector lo que necesita para recibir esto, aquí? El contexto debe llegar en el punto de necesidad, no en un glosario y no tres secciones tarde. El fallo más común es la ordenación por maldición del conocimiento: el autor presenta las cosas en el orden en que las aprendió, o en el orden en que el sistema las ejecuta, en lugar del orden en que un extraño puede absorberlas.
Ritmo y proporción. El espacio en un documento es énfasis. ¿La cantidad de texto que recibe cada idea coincide con su importancia para la columna vertebral? Los dos fallos estándar son opuestos: el riesgo crítico comprimido en una oración de seis cláusulas, y un mecanismo menor extendido en tres párrafos porque el autor lo encontró interesante de descubrir. También presta atención al medio que se hunde, donde secciones consecutivas reformulan una idea con ropa diferente, y a la información repetida (el mismo hecho introducido dos veces generalmente significa que dos borradores se fusionaron y nadie releyó el todo).
Consistencia. Un nombre por concepto para todo el documento; el ciclo de sinónimos se lee como variación elegante para el escritor y como un segundo concepto para el lector. Verifica que los números, las afirmaciones y la terminología concuerden entre secciones, que nada prometido ("discutido más abajo") falte y que el tono no dé un salto de registro a mitad del documento.
3. Busca las cuatro categorías de ruido
Estas son pasadas de eliminación. Los agentes (y los humanos cansados) dejan las tres atrás, y cada una es el residuo del proceso de escritura que se muestra a través del documento enviado. El lector está comprando el edificio, no el andamio.
Narración de procedencia. Cómo el autor aprendió un hecho es un rastro de investigación, no contenido. "Como se verificó en ia-logic.js", "X confirmó con Y en el hilo", "un documento de diseño apuntó aquí", "verificado en código, Confluence y Slack: no existe tal trabajo". Afirma el hecho y deja que se sostenga por su propia autoridad; la verificación ocurrió, simplemente no necesita ser narrada. Palabras a observar: verificado, confirmado, según lo discutido con, según el hilo, según el documento, después de verificar, miré.
Antes: Según el documento de decisión M1 (confirmado por el PM en el hilo del 2026-06-16),
sold_outdebe reiniciarse a la medianoche local del lugar. Verificado en código, Confluence y Slack: no existe tal trabajo de reinicio hoy.Después:
sold_outse reinicia a la medianoche local del lugar, y ningún trabajo hace eso hoy, por lo que un artículo marcado como "agotado hasta mañana" nunca se borra.
Dos excepciones, ambas estrechas. Cita a una persona cuando su aprobación es la acción pendiente (un aprobador, un propietario de una decisión abierta), nunca como atribución de un hecho. Mantén el método cuando el método es la afirmación: un resultado de referencia es inseparable de cómo se midió.
Residuos de hipótesis descartadas. Los agentes mantienen un registro del espacio negativo alrededor de lo que probaron: "confirmamos que la conciliación no es la causa", "esto resultó ser una pista falsa", "no se necesitan cambios en la ruta de servicio (verificado)". La investigación necesitaba esos pasos; el lector casi nunca. Una rama muerta merece su oración solo si un futuro lector plausiblemente caminaría hacia el mismo callejón sin salida y reharía el trabajo, y entonces obtiene una línea, colocada exactamente donde ese lector comenzaría a cavar, no una sección propia. Todo lo demás: mantén la conclusión positiva, elimina la antítesis. "La característica es una ruta de escritura; las lecturas ya funcionan" es una oración que hace el trabajo de una sección completa de "lo que no necesita cambios (verificado)".
Andamiaje autorreferencial. El documento hablando de sí mismo como borrador: "esto corrige una nota anterior", marcadores [NECESITA VERIFICACIÓN] obsoletos en cosas ya verificadas, preguntas resueltas mantenidas como entradas tachadas con anotaciones "resuelto:", un resumen de verificación final que enumera cada fuente consultada. Una decisión tomada no es una pregunta: afirma la elección una vez, donde vive, y elimina la deliberación. Si todo lo que está bajo un encabezado se resolvió, corta el encabezado en lugar de escribir "N/A". La señal de que esta categoría está presente: el documento se alargó en la pasada que resolvió cosas. Las pasadas posteriores deben restar.
Antecedentes dramatizados. Escritura que argumenta por lo que el lector solo necesita aceptar. Tres señales: una ilustración de un concepto que la sala ya maneja ("un 'Hamburger' es una cosa fija sin 'elige tu salsa'"); una oración de apuestas que vende por qué el trabajo importa ("la personalización es lo que hace un menú real"), cuando la existencia del documento ya establece eso; y una cadena causal recorrida paso a paso donde solo su conclusión se usa más adelante ("el único escritor es la sincronización POS; los socios manuales no tienen POS; por lo tanto no pueden crear"). Afirma el hecho a la altitud del lector y continúa; indica el mecanismo una vez, donde es crítico, no en la introducción. El límite que evita que este corte elimine el contexto real: el contexto es para decisiones, la afirmación es para antecedentes. Cualquier cosa que el lector deba juzgar conserva sus ingredientes completos (el comportamiento actual, la bifurcación, las apuestas); cualquier cosa que el lector deba simplemente aceptar para seguir leyendo recibe una oración simple. La prueba por oración: si se elimina, ¿el lector toma una decisión incorrecta, o simplemente se siente menos acompañado? Decisión incorrecta, mantenlo. Menos acompañado, córtalo.
4. Barre en busca de claridad
Una lente separada sobre el mismo texto, buscando tres cosas: jerga que un lector nuevo no puede decodificar, oraciones demasiado comprimidas para descomprimirlas en un solo aliento y frases que suenan técnicas pero no dicen nada ("se sostiene por construcción", "por diseño", "aprovechar esto"). Define la jerga interna en el primer uso, en línea, en la misma oración; calibra para un nuevo empleado que conoce el campo de manera genérica pero no este rincón. Dale al párrafo más denso e importante el mayor espacio: divídelo en tiempos, una idea por oración, causa antes que efecto. La prueba es leer en voz alta: cualquier cláusula que no puedas decir en un aliento, o cualquier término en el que el nuevo empleado se detendría para buscar, es una reescritura.
La claridad no es simplificación. Cuando la explicación precisa necesita el modelo de datos real, usa el modelo de datos real; el pecado es hacer que el lector realice el desembalaje, no la presencia de detalle. La densidad está bien donde el contenido es material de referencia genuinamente paralelo (una lista de columnas, un apéndice, una tabla de errores). Eso es escaneable por diseño; no lo conviertas en prosa.
5. Entrega un memo editorial, luego espera
Informa antes de reescribir. El memo, en este orden:
- La columna vertebral, según se leyó. Una o dos oraciones que indiquen lo que entendiste que el documento estaba comunicando. Esto es tanto el marco para todo lo siguiente como una prueba: si tu lectura difiere de la intención del autor, esa brecha es el hallazgo más grande de todos.
- Diagnóstico general. Los uno o dos problemas dominantes, nombrados claramente. No entierres un arco roto bajo cincuenta notas de línea.
- Hallazgos, de grandes a pequeños. Para patrones recurrentes, nombra el patrón y da dos o tres ejemplos representativos, no una lista exhaustiva de instancias. Cita el texto real; propón el reemplazo real para al menos un ejemplo para que el autor pueda ver el movimiento, no solo la regla. Organiza los hallazgos por lo que le importa al autor, no por la lista de verificación de este skill: las categorías de ruido y los nombres de capas anteriores son lentes para encontrar problemas, y hacen un índice de contenido pobre. Un memo con una sección por categoría se lee como un formulario que se está llenando; un memo ordenado por "esto es lo que le costará más al lector" se lee como un editor.
- Niveles. Divide en: correcciones que aplicarás tras la aprobación (mecánicas, verificadas); lagunas que marcarás visiblemente pero no inventarás (una sección faltante se convierte en un ancla
[PENDIENTE: ...], nunca contenido inventado); y juicios que pertenecen al autor (cortes que intercambian completitud por ritmo, elecciones de registro). - Lo que funciona. Brevemente. El autor necesita saber qué no tocar en la revisión.
El memo es en sí mismo un documento que alguien lee, por lo que obedece sus propias reglas. No narres tu procedimiento ("lo leí dos veces, según el skill"), no informes comprobaciones que resultaron limpias ("no se encontraron guiones"), no lo rellenes con todo lo que miraste. Indica los hallazgos; el silencio es el informe de todo lo que pasó.
Luego detente y deja que el autor responda. Cuando aprueben, aplica. Para problemas estructurales, prefiere reescribir el documento desde cero en lugar de parchear oraciones en su lugar: las decisiones de encuadre están integradas en la estructura de la oración, y el pulido no puede arreglar un párrafo que no debería existir. Deja la versión anterior en disco para comparar.
6. Verifica después de aplicar
La compresión y la reformulación pueden cambiar silenciosamente el significado. Después de la reescritura, vuelve a verificar cada afirmación cuyo redactado haya cambiado contra su fuente (el código, los datos, el documento referenciado), luego lee el documento final de principio a fin una vez más como un extraño. Para documentos de alto riesgo, la verificación más sólida es...