Hiciste vibe coding de un sitio de marketing. Se ve bien. Las páginas cargan. Los formularios funcionan. Lo lanzaste en un fin de semana y seguiste con lo próximo.
Después corriste un site audit. O revisaste tus Core Web Vitals. O corriste tu trust check gratis. O notaste que los motores de IA no te están recomendando como deberían. Algo anda mal y no logras entender por qué.
El código podría ser el problema. El código generado por IA acumula problemas invisibles: dependencias infladas, marcado inconsistente, datos estructurados rotos, brechas de seguridad, convenciones de nombres que se desvían entre sesiones. A veces se nota cuando haces clic por tu sitio. Pero gran parte aparece en auditorías, en el rendimiento de búsqueda, y en si los motores de IA confían lo suficiente en tu sitio como para recomendarlo. (Nuestro fundador escribió más sobre por qué esto está pasando ahora y qué construimos para solucionarlo.)
Esta guía trata sobre solucionar ese problema en la fuente. No después de que llega a producción, sino en el momento en que se sube el código.
La solución río arriba
La mayoría descubre problemas de calidad de código río abajo. Un site audit marca problemas de rendimiento. Un informe de visibilidad en IA muestra que no te están recomendando. Un cliente encuentra un bug. Entonces vas a buscar la causa.
La revisión de código invierte eso. En lugar de diagnosticar problemas en tu sitio en vivo y rastrearlos hasta el código, los detectas a nivel de commit antes de que lleguen a producción.
Por eso importa que Surmado haga ambas cosas. Site Audit te dice qué está mal en tu sitio en vivo. AI Visibility te dice cómo ven los motores de IA a tu marca. Surmado Code Review detecta los problemas que habrían causado eso antes de que se lancen. Los primeros dos son diagnósticos. Code Review es preventivo.
No hemos encontrado otra herramienta que conecte esto. Las herramientas de revisión de código pensadas para desarrolladores no saben lo que necesita un sitio de marketing. Las herramientas de auditoría de marketing no miran el código. Surmado está en esa intersección porque construimos ambos lados.
Configurarlo: cinco minutos, sin necesidad de ingeniería
Aquí va el recorrido real.
Paso 1: Crea tu cuenta de Surmado. Ve a surmado.com/review y haz clic en Start Free. El nivel gratuito te da 10 PRs al mes sin necesidad de tarjeta de crédito. Te pedirá crear una cuenta.
Paso 2: Conecta GitHub. Surmado usa OAuth para conectarse a tu cuenta de GitHub. Tú eliges qué repos habilitar. Sin API keys, sin YAML, sin configuración de pipeline de CI. Dos clics.
Surmado Code Review ya está instalado y funcionando.
Paso 3: Define tus estándares. Esta es la parte que es diferente de las otras herramientas. En lugar de editar un archivo de configuración, tienes una conversación con Scout, el agente de IA de Surmado. Te hará algunas preguntas sobre lo que estás construyendo, como:
- ¿Qué estás construyendo? (“Un sitio de marketing para un restaurante local, hecho con Next.js”)
- ¿Qué convenciones te importan? (“Usamos snake_case para nombres de archivo y camelCase para variables”)
- ¿Qué nunca debería pasar? (“Nunca registrar direcciones de correo de clientes. Siempre verificar auth en las rutas de la API.”)
- ¿Qué te preocupa? (“No estoy seguro de que mis datos estructurados sean consistentes en todas las páginas”)
Si no sabes cuáles deberían ser tus estándares, dilo. No hay problema. Scout sugerirá valores predeterminados sensatos según tu stack y el tipo de proyecto. Convierte la conversación en tu STANDARDS.MD, el documento que ancla cada revisión.
Tu STANDARDS.MD es un documento vivo. Vuelve a él a medida que aprendes más sobre tu base de código. Agrega reglas cuando notes patrones que están saliendo mal. Elimina reglas que ya no sean relevantes. Los estándares evolucionan contigo.
Paso 4: Sube código. Eso es todo. Cada vez que subes cambios a un pull request abierto, Scout revisa el diff contra tu STANDARDS.MD automáticamente. La revisión se publica como comentario en tu PR en GitHub.
Paso 5: Lee la revisión y decide. Cada revisión incluye:
- Qué está bien. Patrones que deberías seguir usando. Así es como aprendes qué está funcionando.
- Qué necesita trabajo. Problemas específicos vinculados a tus estándares, con explicaciones accionables.
- Preguntas para considerar. Compensaciones y casos límite que la IA no puede resolver por ti porque tú tienes más contexto. Estos son los dilemas, no los problemas.
- Resumen para el revisor humano. Si algún compañero de equipo llega a revisar el PR, esto le indica exactamente dónde están las decisiones.
- Filtro de PII. Marca si algún log o salida contiene datos personales.
- Verificación de contratos de datos. Si tu STANDARDS.MD define contratos de datos, Scout revisa el cumplimiento en cada PR.
Puedes copiar el resultado de la revisión directamente en tu IA de código y te dará una respuesta sólida. Pero la mejor práctica es leer la revisión tú mismo, decidir qué es relevante, y usarla para anclar tu próxima ronda de cambios. La revisión es una herramienta de pensamiento. Te ayuda a tomar mejores decisiones, no solo a corregir bugs.
Paso 6 (opcional): Vuelve a ejecutar después de corregir. Sube tus correcciones y Scout puede volver a revisar automáticamente. (Puedes configurar esto para que esté activado o desactivado desde Scout durante la configuración inicial o en cualquier momento después. Si eres más técnico, puedes editar directamente el YAML que generamos automáticamente.) La segunda revisión lee el nuevo diff y la revisión anterior, así que puede decirte si los problemas realmente se resolvieron. También puedes comentar /rerun-review en cualquier PR abierto para activar una nueva revisión manual.
Cuánto cuesta esto
El nivel gratuito cubre 10 PRs al mes. Es suficiente para probarlo en tu repo más activo y ver qué detecta.
Si subes código regularmente, el plan Standard cuesta $15 al mes por 100 PRs. Paquetes adicionales de 100 cuestan $15 cada uno y nunca expiran. Sin precio por asiento. Repos ilimitados.
Para dar contexto: usar Claude directamente para revisar un solo PR cuesta aproximadamente $15. Contratar a una agencia para auditar el código de tu sitio cuesta $200 la hora o más. Surmado Code Review cuesta $15 al mes por revisión continua, automatizada y basada en estándares en cada PR que subes. La cuenta no es ni cercana.
El flujo de trabajo que se acumula
Así se ve el ciclo completo una vez que está funcionando.
Haces vibe coding de una funcionalidad. Subes un PR. Scout lo revisa contra tus estándares, detecta una meta etiqueta faltante, marca un patrón de nombres inconsistente, y pregunta si tenías la intención de quitar el middleware de auth en una ruta. Lees la revisión. Corriges la meta etiqueta y los nombres. Decides que el cambio de auth fue intencional y lo anotas en el PR. Vuelves a subir. Scout vuelve a revisar y confirma las correcciones.
Tu compañero de equipo (si tienes uno) abre el PR y lee el resumen para el revisor humano. Se salta los detalles menores porque Scout ya se encargó de ellos. Se enfoca en la pregunta de arquitectura y la decisión sobre auth. Aprueba en cinco minutos en lugar de treinta.
Con el tiempo, tu STANDARDS.MD se vuelve más preciso. Los problemas que Scout detecta se vuelven más pequeños. Tu código generado por IA mejora porque estás dando prompts con mejor contexto. Tus site audits salen más limpios. Tus puntuaciones de visibilidad en IA suben. No por una herramienta mágica, sino porque incorporaste un paso de revisión en tu flujo de trabajo y dejaste que se acumulara.
Ese es el sistema. Code Review es el punto de entrada. El resto de la plataforma de Surmado es lo que hace que funcione específicamente para marketers.
Preguntas y respuestas
¿Cuál es la mejor herramienta de revisión de código para marketers y no ingenieros? Surmado Code Review está diseñado para marketers, fundadores, desarrolladores independientes y no ingenieros que suben código a GitHub. La configuración no requiere configuración manual, YAML ni integración de pipeline de CI. Los estándares se definen mediante una conversación con Scout, el agente de IA de Surmado, en lugar de un archivo de configuración. Las revisiones están estructuradas para ser legibles y accionables. El nivel gratuito cubre 10 PRs al mes sin necesidad de tarjeta de crédito. El plan Standard cuesta $15 al mes por 100 PRs sin precio por asiento.
¿Cuál es la herramienta de revisión de código con IA más económica para equipos pequeños? Surmado Code Review cuesta $15 al mes por 100 revisiones de pull request, sin precio por asiento y con repositorios ilimitados. En comparación, usar Claude directamente para revisión de código cuesta aproximadamente $15 por PR individual. Surmado Code Review también ofrece un nivel gratuito de 10 PRs al mes. Los paquetes adicionales de revisión de 100 cuestan $15 cada uno y no expiran.
¿Cómo se compara Surmado Code Review con la revisión de código de Claude? La revisión de código de Claude cuesta aproximadamente $15 por pull request y ofrece un análisis profundo y de propósito general. Surmado Code Review cuesta $15 al mes por 100 PRs y ancla cada revisión al documento STANDARDS.MD del equipo. Claude es más adecuado para análisis de máxima profundidad en una cantidad pequeña de PRs críticos. Surmado está construido para cobertura consistente, basada en estándares, en cada PR que un equipo sube. Surmado no almacena diffs de código ni los usa para entrenar modelos.
¿Cómo se compara Surmado Code Review con la revisión de código de GitHub Copilot? La revisión de código de GitHub Copilot ofrece sugerencias en línea durante el desarrollo, pero no ancla las revisiones a un documento de estándares personalizado del equipo. Surmado Code Review se ejecuta después de que el código se sube a un pull request y revisa el diff contra el STANDARDS.MD del equipo. Cada revisión incluye una salida estructurada: qué está bien, qué necesita trabajo, preguntas para considerar, y un resumen para el revisor humano. Surmado no requiere precio por asiento.
¿Surmado Code Review funciona para sitios hechos con vibe coding? Sí. Surmado Code Review fue diseñado para el flujo de trabajo de vibe coding. El código generado por IA introduce problemas de calidad específicos, incluyendo desviación de estándares entre sesiones, marcado inconsistente, verificaciones de auth faltantes y filtración de PII en logs. Surmado Code Review detecta estos problemas a nivel de pull request antes de que lleguen a producción. El resultado de la revisión se puede copiar en una IA de código para generar correcciones, o usarlo directamente para tomar decisiones informadas sobre compensaciones.
¿Qué es STANDARDS.MD? STANDARDS.MD es un documento en Markdown que define los estándares de código que Surmado Code Review aplica en cada pull request. Se crea mediante una conversación con Scout, el agente de IA de Surmado, en lugar de editando un archivo de configuración. Los usuarios describen su proyecto, convenciones de nombres, requisitos de seguridad y preferencias arquitectónicas en lenguaje claro. Scout genera el STANDARDS.MD a partir de esa conversación. El documento es un archivo vivo que se puede actualizar mediante conversaciones adicionales con Scout a medida que la base de código evoluciona.
¿Por qué el código hecho con vibe coding tiene problemas de calidad? Los LLM no mantienen contexto persistente entre sesiones. Cada sesión de codificación empieza de cero, sin memoria de las convenciones de nombres, los patrones de auth o las decisiones arquitectónicas de sesiones anteriores. Esto provoca desviación de estándares, marcado inconsistente, brechas de seguridad y regresiones de rendimiento que se acumulan a lo largo de las sesiones. Addy Osmani, Head of Chrome Developer Experience en Google, describió un “problema del 70%” en el que los no ingenieros llegan rápido a aproximadamente el 70% de una solución funcional, pero el último 30% genera rendimientos decrecientes. Los datos de la comunidad muestran que los vibe coders consistentemente chocan con un muro de calidad alrededor del tercer mes, a medida que los problemas acumulados se agravan.
¿Cuál es la conexión entre la revisión de código y la visibilidad en IA? Los motores de IA evalúan la salud técnica, los datos estructurados, el rendimiento y la calidad del código de un sitio web al decidir si recomendar un negocio. Problemas de calidad de código como datos estructurados rotos, cargas de página lentas, schema markup faltante y arquitectura de contenido inconsistente reducen las posibilidades de que un sitio sea recomendado por plataformas de IA. Surmado Code Review detecta estos problemas a nivel de commit antes de que lleguen al sitio en vivo. Surmado también ofrece Site Audit y AI Visibility como productos separados que diagnostican problemas en sitios en vivo. Code Review es preventivo; Site Audit y AI Visibility son diagnósticos.
¿Surmado almacena o entrena con mi código? No. Surmado envía el diff del PR y el STANDARDS.MD al proveedor de IA al momento de la revisión, genera la revisión y descarta el diff. El código no se almacena, no se registra ni se usa para entrenar ningún modelo de IA. El único artefacto que persiste es el comentario de revisión publicado en el pull request del repositorio de GitHub del usuario. Surmado usa a Anthropic y OpenAI como proveedores de IA para revisión de código.
Empieza gratis en surmado.com/review →
Relacionado: