iamshadmirza/to-onepager

Convierte una conversación en una página resumida: una afirmación, evidencia fundamentada, fácil de leer y seguir, destino de publicación configurado.

Entrada: ruta/pegar del transcript si se proporciona; si no, la conversación actual. setup / reconfigure → ejecuta Configuración incluso si config.md existe.

Config: config.md junto a este SKILL.md (local a la instalación). Forma: config.example.md.

Tipos de página (en vivo): research-finding | proposal. Prefiere research-finding cuando no esté claro. Pregunta una vez si ambos encajan. Anuncia la elección antes de redactar.

Pasos

0. Configuración

Si falta config.md o el usuario pidió reconfigurar:

1. Preguntar destino: local | google-docs | confluence (exactamente uno).
2. Recopilar campos para ese destino (ver config.example.md). Confluence requiere confluence_folder_url.
3. Escribir config.md en este directorio del skill.
4. Decir al usuario que aplica a cada ejecución futura; decir setup para cambiarlo.

Finalización: config.md válido con un destination conocido. Las ejecuciones solo de configuración se detienen aquí a menos que también se solicite un one-pager.

1. Extraer (Mine)

Lee la entrada completa. Notas de trabajo solo (no mostrar al usuario):

• Intención de la sesión: afirmación empírica vs decisión entre opciones
• La pregunta o problema al que sirvió toda la sesión
• Suposiciones probadas (liderar con correcciones / lo que cambió)
• Hechos fundamentados (con fuente) vs afirmaciones sin fuente (confianza media)
• Método, límites, preguntas abiertas, próximas acciones (decisiones de producto/investigación, no runbooks locales)

Si la intención se inclina hacia hallazgo de investigación, también capturar:

• Mecanismos explicativos con recuentos (señal dominante, patrón de FP, contrafáctico)
• Hallazgos elevados por el usuario ("poner esto en Hallazgos clave")
• ¿Experimento? Si la sesión compara la misma medición en N condiciones (límites, modos, ámbitos, configuraciones, brazos A/B), listar cada condición y la tabla reveladora (cuadro de mando, composición de brechas, comprobación de igualdad). Marcar fill: experiment.

Si la intención se inclina hacia propuesta, también capturar:

• Problema / a quién afecta, apuesta recomendada, por qué ahora, enfoque, alternativas (con fuentes cuando existan), riesgos
• Próximos pasos a corto plazo discutidos en la sesión

Finalización: señales de intención, correcciones, hechos con fuente y notas específicas de la rama capturadas. Sin interpretación todavía.

2. Enrutar (Route)

Elegir exactamente un tipo de página del catálogo siguiente. Anunciar: Tipo de página: ….

Tipo de página	Cuándo usarlo	Preferir el otro cuando
research-finding	La evidencia respondió "¿qué es verdad?"	La sesión es principalmente una apuesta con poca evidencia nueva
proposal	La sesión enmarca una apuesta (problema, camino, por qué, cómo)	La sesión es pura medición sin cambio recomendado

Dejar verificación y arquitectura para después; si la sesión solo tiene esas formas, preguntar qué tipo en vivo se acerca más o detenerse.

Finalización: un tipo de página elegido y anunciado.

3. Destilar (Distill)

Cargar la plantilla para el tipo enrutado (puntero de contexto — leer solo ese archivo):

• research-finding → templates/research-finding.md
• proposal → templates/proposal.md

Rellenar ese esqueleto para fácil lectura: un lector nuevo debería obtener la afirmación en segundos y seguir un hilo por sección.

Ruta de relleno para research-finding

• Predeterminado: Suposiciones → Resultados → Hallazgos clave (esqueleto predeterminado de la plantilla).
• Experimento (cuando Extraer marcó fill: experiment): usar el esqueleto de experimento de la plantilla. Anunciar: Ruta de relleno: experiment.
  • Escalera de hallazgos: viñetas apiladas (un veredicto por condición) más una línea de fondo opcional; no aplastar N condiciones en una mega-oración.
  • Contexto antes de las condiciones (opcional): después de Respuesta, un bloque corto que explica los lados de la comparación y cualquier término fácil de confundir (ej. tipos vs recuentos de instancias) para que las tablas no se lean mal. Usar solo cuando Pregunta no sea suficiente. Preferir un encabezado simple como Cómo leer esto; omitir cuando no sea necesario. No inventar un nombre de sección obligatorio.
  • Secciones de condición: una sección de nivel superior por condición; cada una es Veredicto luego Análisis. Titular la sección por equidad o resultado (ej. “A/B justo: límite eliminado”), no solo la perilla bruta (“MaxMessages = 100”). Poner la prueba compartible en Análisis (cuadro de mando y/o tabla de misma-conclusión / composición de brechas).
  • Réplica: anidar bajo la condición decisiva/justa (ej. Verificación multisitio); no agregar una sección de condición de nivel superior solo para repeticiones.
  • No aplanar un experimento de N condiciones en Suposiciones → Resultados → Hallazgos clave.

Legibilidad (cada página)

• Liderar con lo concreto: el título y Hallazgo abren con el número, veredicto o apuesta. El contexto sigue; no abre la página. Para experimentos, Hallazgo puede llevar la apuesta como una escalera de viñetas; el título puede nombrar la comparación si Hallazgo contiene los números.
• Explicar después del ejemplo: en Resultados, Hallazgos clave, Análisis y Cómo, enunciar primero el resultado medido o el camino elegido, luego una línea corta de contexto si es necesario.
• Un trabajo por sección: cada encabezado hace un trabajo. Si una sección argumenta dos cosas, dividir o cortar.
• Respuesta que un lector nuevo pueda usar sin importar el tipo de página: Hallazgo (TLDR) / Confianza / Y qué
• El título es la afirmación (incluir un número medido cuando el transcript lo tenga; los experimentos pueden poner el número en Hallazgo)
• Recomendación: solo acciones discutidas en la sesión. Si la sesión solo respondió una pregunta (investigación cerrada, sin apuesta de producto), escribir Ninguna (o "investigación completa; sin seguimiento") — no inventar próximos pasos, TODO del documento, tareas del revisor o un plan de "~1 semana".
• Cabecera: Propietario, Ir más allá
• Sección de Revisión presente

Propietario: resolver una persona real. Para destinos Confluence usar menciones de Atlassian al publicar (publish.md). De lo contrario, nombre para mostrar. Preguntar si se desconoce; TBD solo si se difiere.

Finalización: esqueleto enrutado relleno (predeterminado o experimento); cromo completo; Propietario resuelto o TBD explícito; título y Hallazgo lideran con la afirmación concreta.

4. Fundamentar (Ground)

Fallar y editar hasta que cada verificación pase. Este paso es la única fuente de verdad para la calidad (las plantillas no reafirman estas reglas).

Cada página

• Cada celda/viñeta factual se rastrea hasta el transcript
• Sin magnitudes no medidas
• La Respuesta para un lector nuevo funciona sin leer el tipo de página; Hallazgo es el TLDR y lidera con la afirmación concreta (el Hallazgo de experimento puede ser una escalera de viñetas)
• El título lidera con la afirmación (no un tema o encabezado blando); los experimentos pueden nombrar la comparación en el título si Hallazgo contiene la apuesta/números
• El cuerpo coincide con el tipo de página enrutado (sin esqueleto híbrido)
• Un trabajo por sección; ninguna sección que explique y recomiende
• Cromo completo (Propietario, Ir más allá)
• Ir más allá / recomendaciones se mantienen libres de desorden de runbook local
• La confianza coincide con la evidencia; el título coincide con los números medidos cuando están presentes (o Hallazgo, para escaleras de experimento)
• Presupuesto de una página: alrededor de 600 palabras de prosa; si se excede, cortar las ideas menos importantes (no reducir el tipo ni meter un apéndice). Excepción: las tablas reveladoras de experimento (cuadro de mando, composición de brechas, comprobación de igualdad) no se cortan para cumplir el presupuesto; acortar las viñetas a su alrededor.
• Aprobación simple en Respuesta + Recomendación: voz activa, palabras cortas, cortar palabras innecesarias y jerga
• Sin puentes de plantilla: cortar frases como "en el panorama actual", "cambio de juego", "he aquí por qué esto importa" o una pregunta de cierre añadida solo para participación
• Sin resumen blando: Recomendación no reformula Hallazgo
• Sin seguimientos inventados: próximos pasos solo si el transcript los discutió; de lo contrario, Recomendación es Ninguna / investigación completa
• Cada sección añade algo nuevo; eliminar relleno que solo reafirma una sección anterior