Kill AI Slop

¿Qué hace Kill AI Slop?

El slop de IA es feo de una manera específica: acumula todos los estilos y detalles posibles sin definir un enfoque. Un degradado, un brillo, una mascota, un emoji, un muro de tarjetas brillantes, cada opción por defecto activada a la vez, hasta que cada producto parece la misma plantilla chillona. Se lee como "diseñado" en una miniatura y se desmorona en cuanto alguien lo mira. Tu trabajo es reducirlo a algo que una persona elegiría realmente.

Los principios que debes seguir en cada corrección:

1. Decide antes de decorar. Cada elección visual debe poder explicarse.
2. Un acento, una voz.
3. Jerarquía a partir de escala y espacio. Colorear palabras o cambiar fuentes es un atajo.
4. Primero resta. El primer paso para no ser feo es eliminar cosas.
5. Lo específico vence a lo impactante en el texto.
6. La decoración debe significar algo — los iconos, las insignias y los recuadros son señales.

Flujo de trabajo

Sigue estos pasos en orden. No hagas ediciones masivas antes de que el usuario haya visto el informe.

1. Alcance

Confirma qué escanear. Por defecto, se escanea la fuente de la aplicación/sitio (omite node_modules, dist, build, .git, vendor, lockfiles, archivos minificados). Pregunta si el proyecto mezcla varias aplicaciones.

2. Escaneo

Ejecuta el escáner incluido, que busca en el código base las señales a nivel de código de cada indicio e imprime los resultados agrupados por archivo:línea:

node scripts/scan.mjs <raíz>          # informe legible para humanos
node scripts/scan.mjs <raíz> --json   # formato máquina, para clasificación

Es Node puro (sin dependencias) y nunca edita archivos. Usa su salida como un mapa inicial, no como una verdad absoluta: confirma cada coincidencia leyendo el código.

Para acotar un escaneo: --only=01,06 / --skip=19 filtra por id de indicio, y --exclude=legacy descarta rutas (coincidencia de subcadena en la ruta relativa al proyecto). --rules=extra.mjs carga indicios adicionales específicos del proyecto o lenguaje (scripts/rules.ru.mjs es un ejemplo de copia en ruso incluido y la plantilla para los tuyos propios). Las coincidencias que el usuario haya confirmado como intencionales se pueden fijar en el código fuente con comentarios deslop-ignore, deslop-ignore-next-line 06 o deslop-ignore-file; prefiere las formas con ámbito de id para que sigan apareciendo nuevos indicios.

3. Clasificación

Para cada coincidencia, abre el archivo y decide slop vs. intencional. Este es el paso que diferencia este skill de una regla de lint. Un degradado, una serifa o un emoji pueden ser una elección real y defendible. Conserva todo lo que el usuario haya elegido claramente (tokens de marca, un logotipo, una ilustración deliberada). Marca solo los valores predeterminados.

Lee references/taxonomy.md para saber qué es cada indicio y por qué se percibe como hecho por una máquina, y references/detection.md para los patrones exactos y sus falsos positivos comunes.

4. Informe

Antes de cambiar nada, proporciona al usuario un resumen agrupado: cada indicio, las coincidencias archivo:línea que confirmaste, una frase sobre por qué y la corrección propuesta. Sigue el formato:

slop  src/Hero.tsx:12   degradado indigo→violeta        → un acento sólido
slop  src/Hero.tsx:31   titular con recorte degradado   → tinta sólida, escalar
slop  src/Note.tsx:8    recuadro border-l-4 ×3          → 1 nota al margen, el resto es cuerpo
slop  copy.md:1         "no solo X, es Y"               → di la cosa específica
→ 4 grupos, 11 coincidencias.

Luego pregunta qué grupos aplicar, o si se procede con todos.

5. Corrección

Aplica el cambio mínimo que elimine el indicio preservando la intención y la funcionalidad. Usa references/fixes.md para el patrón antes→después de cada indicio.

• Prefiere editar tokens/componentes compartidos en lugar de tocar cada sitio de llamada.
• Nunca inventes nuevos colores de marca; si una paleta debe cambiar, propón neutros + el acento existente del proyecto y deja que el usuario lo confirme.
• Mantén el significado del texto; hazlo específico, no lo elimines sin más.
• Vuelve a ejecutar el escáner después de corregir para confirmar que el recuento ha bajado, y anota cualquier coincidencia que hayas dejado intencionadamente (con el motivo).

Barreras de seguridad

• Respeta la autoría. Trata los archivos desconocidos y los adornos deliberados como una elección de alguien. Cuando no estés seguro de si algo es slop, pregunta, no lo elimines.
• Diffs pequeños y revisables. Nunca reformatees código no relacionado. Nunca ejecutes git add -A; prepara solo los archivos explícitos y deja el trabajo en curso de otros en paz.
• Sin nuevas dependencias para realizar este trabajo.
• Verifica visualmente cuando sea posible. Si existe un servidor de desarrollo, mira el antes y el después; un escaneo exitoso no es lo mismo que una página mejorada.

Referencias

• references/taxonomy.md — los 35 indicios: qué es cada uno, por qué es slop, la corrección.
• references/detection.md — patrones concretos de ripgrep/regex + falsos positivos.
• references/fixes.md — patrones de remediación antes→después.
• scripts/scan.mjs — el escáner sin dependencias.