haxzie/prequel

Investigación para el blog

Un informe es la diferencia entre un post que afirma cosas y un post que afirma cosas que alguien puede comprobar. Cada precio, cada queja citada y cada "la mayoría de las herramientas se quedan en 60 fps" en el blog es una afirmación sobre el producto de otro, y una incorrecta desacredita a todas las correctas en la página. Esta habilidad produce la lista verificada a partir de la cual trabaja el escritor, y nada más: no escribe el post.

Los hechos de Prequel no provienen de la web. Provienen del repositorio, y la primera sección a continuación indica dónde. Buscar "Prequel screen recorder" encuentra una reseña desactualizada o un producto diferente con el mismo nombre.

Dónde van las cosas

Ruta	Qué es
.context/research/<slug>.md	El informe. Ignorado por git; andamio, no se publica
apps/web/src/content/competitors.ts	Precios y funciones verificados para los seis con páginas
.claude/skills/comparison-posts/assets/quotes.json	Cada cita de Reddit ya capturada
apps/web/src/content/posts.ts	Lo que el blog ya cubre

El informe no se confirma porque el post lleva su propia evidencia: precios bajo la tabla con una fecha de verificación, hilos de Reddit enlazados en la cita, y cualquier cosa que deba sobrevivir al post movida a competitors.ts o quotes.json. Un informe confirmado queda obsoleto la primera vez que un precio se mueve y nadie lo actualiza, y entonces es una segunda fuente de verdad que está en desacuerdo con la página.

Fase 1: el mapa del tema

Antes de buscar cualquier cosa, escribe qué es el post y confírmalo. Tres líneas, en la respuesta:

• La búsqueda que responde. "screen recorder mac no watermark", "how to record system audio on mac". El post está construido para esta consulta, y decide el slug, la pregunta definitoria y las FAQ.

• El género. Una comparativa va a [[comparison-posts]]; un post de "mejores alternativas a " a [[alternatives-posts]]; un tutorial, explicador o pilar a [[guide-posts]]. Requieren investigación diferente: una comparativa necesita precios para diez herramientas, una guía necesita los hechos de macOS y las quejas.

• La pregunta definitoria. Cada post abre una sección ## ¿Qué es <cosa>? y la pregunta debe ser única en el blog. Busca en los posts existentes antes de proponer una:

  grep -h "^## ¿Qué es\|^## Cómo se" apps/web/src/content/blog/*.mdx
  

Luego el pilar bajo el que se sitúa, desde posts.ts. Hoy hay tres: screen-recording-on-mac, product-demo-videos, screen-recording-for-youtube. Un post sin pilar es un pilar, y esa es una decisión del usuario, no del informe.

Presenta esto y espera. Investigar sobre el género incorrecto es una hora perdida.

Fase 2: los hechos de Prequel, desde el repositorio

Lee estos antes que la web, para que el informe contraste a los competidores contra lo que Prequel realmente envía, no contra lo que un motor de búsqueda recuerda:

Hecho	Fuente
Resolución, fps, códecs, salida	SPECS en apps/web/src/components/landing/LandingBody.tsx
Lo que hace la primera pasada automática	ALREADY_DONE en el mismo archivo. Nada más es automático.
Precio, duración de prueba	apps/web/src/lib/pricing.ts, nunca un número de memoria
Respuestas del producto	apps/web/src/lib/faq.ts
Filas de funciones y lo que afirmamos	FEATURE_ROWS en competitors.ts
Requisitos	Apple Silicon, macOS 14 o posterior, permiso de grabación de pantalla

Dos reglas de [[no-dead-air-claim]] y [[site-copy]] se aplican tanto al informe como al post. Prequel no corta, recorta ni elimina silencios; el corte es una pasada manual en la línea de tiempo. Y nada va en el informe como una deficiencia de Prequel: donde un rival realmente gana en algo, el informe lo registra para que el escritor sepa no mencionar el tema, marcado no escribir.

Fase 3: los flujos de búsqueda

Firecrawl es la herramienta de búsqueda. firecrawl_search devuelve títulos, fragmentos y URLs; firecrawl_scrape obtiene una página como markdown; firecrawl_map lista las páginas de un sitio cuando un vendedor oculta los precios tres clics abajo. Ejecuta los flujos que el género necesita, en paralelo como subagentes cuando hay más de tres herramientas que cubrir, en línea en caso contrario.

Flujo 1, hechos del vendedor. Para cada herramienta que el post menciona: la página de precios del propio vendedor, obtenida y leída. Registra cada nivel con su período de facturación, porque una cifra mensual citada sin la anual es el error más dañino que una comparativa puede cometer, y es verificable con un clic. Registra la fecha. Si la página es renderizada con JS y firecrawl_scrape devuelve un caparazón, dilo y obténla con Chrome sin interfaz ([[headless-chrome-screenshots]] en memoria). Para los seis en competitors.ts, compara con lo que hay y señala cualquier desviación; la solución es una edición en ese archivo, no un número en el informe.

Los hechos que importan para este blog, por herramienta, porque son aquellos en los que Prequel gana: la resolución y velocidad de fotogramas más altas en cada plan, marca de agua en el nivel gratuito o prueba, límite de duración de grabación, si el renderizado es local o se sube, licencia única o suscripción, si la cámara es una pista separada que se puede reencuadrar después de la toma.

Flujo 2, de qué se queja la gente. Reddit a través de firecrawl_search con includeDomains: ["reddit.com"], más Hacker News, G2 (las reseñas de dos y tres estrellas, donde están las quejas específicas) y X. Para un post de alternativas, registra suficiente de cada uno para dibujar una tarjeta: título textual, subreddit o usuario, autor, antigüedad, puntuación, número de comentarios, primer párrafo. [[alternatives-posts]] los renderiza. firecrawl_scrape rechaza reddit.com directamente, así que el título, fragmento y URL de un hilo es todo lo que vuelve, y eso es suficiente para una cita. Consultas que funcionan: "<tool> pricing" reddit, "<tool> alternatives", "<tool> watermark", "<tool> slow", record system audio mac reddit.

Prefiere una queja genuina a un post de lanzamiento. Varios hilos de Loom en la búsqueda son fundadores que anuncian su propia alternativa con un título que parece una queja. Revisa quotes.json primero: un hilo ya capturado allí tiene una captura de pantalla en public/blog/quotes/ y no necesita trabajo nuevo.

Flujo 3, lo que el blog ya dice. Lee posts.ts y los MDX existentes para cualquier cosa sobre el tema. El informe lista los posts a los que el nuevo debe enlazar (cinco o más, con el texto del ancla), el pilar, y cualquier frase en un post existente que el nuevo contradeciría. Dos posts que discrepan sobre el nivel gratuito de Loom es peor que cualquiera de los dos esté equivocado solo.

Flujo 4, los hechos de macOS. Para una guía, qué puede y no puede hacer QuickTime y Cmd+Mayús+5 en el macOS actual, desde las páginas de soporte de Apple, con la URL. Estos cambian por versión y el blog los presenta como hechos.

Flujo 5, números. Cualquier estadística en la que el post pueda apoyarse (tiempo de visualización con sonido apagado, tasas de finalización de vídeos demo) rastreada hasta su fuente primaria, fechada, y descartada si tiene más de tres años o si el rastro termina en otro blog. Un número que el escritor no puede enlazar es un número que el escritor no puede usar.

Lo que una fuente debe superar

• Viva, y cargando el contenido que el informe dice que tiene. firecrawl_scrape lo obtiene; un 200 que sirve "El acceso está temporalmente restringido" no es una fuente. G2, Capterra y Trustpilot responden así a una obtención sin interfaz y no son utilizables aquí.
• Página del vendedor sobre sitio de reseñas. Página de detalle sobre resumen. Discrepan más a menudo de lo que esperarías.
• Fechada. Precios, estadísticas y comportamiento de macOS llevan la fecha de verificación.
• Una cita de Reddit o HN es la URL del hilo más el subreddit o usuario. Una paráfrasis sin enlace no es una cita, y una captura de pantalla tampoco.
• Nada que el post enlazará. El blog solo enlaza hosts de citas: reddit.com, news.ycombinator.com, x.com, g2.com, y github.com o producthunt.com para una cifra de escala. Las URLs de vendedores van en el informe para verificación y en ningún otro lugar.

Fase 4: el informe

# Informe de investigación: <título de trabajo>

Consulta de búsqueda: <la consulta>
Género: guía | comparativa | comparación | pilar
Pregunta definitoria: ## ¿Qué es <cosa>?     (confirmada única)
Pilar: <slug> | ninguno (este es un pilar)

## Hechos de Prequel utilizados
<viñetas, cada una nombrando el archivo del que proviene>

## No escribir
<cualquier punto donde un rival supere a Prequel, para que el escritor evite el tema>

## Herramientas
### <herramienta>
Precio: <cada nivel y período de facturación>. Verificado <fecha>. <URL del vendedor>
Hechos: <resolución, fps, marca de agua, límite de duración, local o subida, licencia>
Prequel gana en: <el contraste que esta sección debe llevar>
Quejas: <título del hilo> (r/<sub>) <URL>    <- en quotes.json? sí/no

## Hechos de macOS
<viñetas, cada una con la URL de Apple y la fecha>

## Números
<estadística> <URL de la fuente primaria> <fecha de publicación>

## Posts existentes a enlazar
/blog/<slug>  "<texto del ancla>"  (por qué encaja)

## Contradicciones
<cualquier cosa que un post existente diga y que este contradeciría>

## Candidatos para FAQ
<pregunta como la escribiría alguien en un cuadro de búsqueda> (de: URL del hilo o PAA)

## Enfoques
<tres a cinco, desde los vacíos entre lo que la gente pregunta y lo que existe>

Escríbelo en .context/research/<slug>.md y termina con la única pregunta que el escritor necesita responder: qué habilidad lo toma después, [[guide-posts]] o [[comparison-posts]], y si la lista de enfoques necesita recorte primero.