Vercel publicó konsistent como proyecto open source el 1 de julio de 2026. La descripción parece pequeña: un CLI linter para TypeScript que valida convenciones estructurales. Pero el ángulo útil para builders de agentes es más profundo: cuando un agente toca un repositorio grande, no basta con que TypeScript compile y ESLint no se queje. También necesita entender la forma esperada del proyecto.

La intención de búsqueda aquí es clara: konsistent, structural linter TypeScript, AI coding agents code conventions, Vercel AI SDK conventions. No hay SEO tooling conectado en esta corrida, así que la demanda se infiere por señales actuales: changelog oficial de Vercel, repo público en GitHub, discusión de herramientas para coding agents y el hecho de que Vercel lo usa en AI SDK y Chat SDK.

El hueco que deja ESLint

ESLint, Biome, TypeScript y tests cubren partes distintas del problema. Detectan tipos rotos, patrones de archivo, imports sospechosos o fallas de comportamiento. Lo que normalmente queda fuera es la estructura de producto: que cada adapter exporte la misma forma, que cada carpeta con cierto archivo tenga otro archivo compañero, o que cada clase en una ruta implemente un tipo específico.

Flujo de CI con reglas estructurales aplicadas antes de aceptar cambios de un agente

Ese contrato estructural importa más cuando entra un agente. Un humano con contexto histórico puede reconocer que "todos los providers se ven así" aunque no exista una regla. Un agente puede imitar el patrón si lo vio en suficiente contexto, pero también puede saltarse un export, crear una carpeta incompleta o inventar una variante que compila hoy y rompe el siguiente feature.

konsistent convierte parte de ese conocimiento tácito en un archivo konsistent.json. Según Vercel, permite declarar reglas como: archivos que coinciden con un patrón deben exportar funciones específicas; carpetas que tienen un archivo también deben tener otro; o clases exportadas desde ciertos archivos deben implementar un tipo. Esa es una capa distinta a "estilo de código". Es forma de sistema.

Por qué esto ayuda a agentes

Para equipos que ya usan Codex, Claude Code, Copilot, Cursor u otros agentes de coding, la promesa práctica no es que konsistent vuelva al agente más inteligente. La promesa es que le pone un riel verificable.

Un agente puede recibir una tarea como "agrega un nuevo adapter al paquete de herramientas". Si el repo tiene diez adapters existentes, el agente puede copiar la forma general. Pero si la convención no está codificada, el cierre depende de revisión humana. Con un linter estructural, el agente puede correr una validación rápida, leer el error y corregir antes de abrir PR.

Reglas de harness y exports obligatorios como control antes de que un agente cierre una tarea

La diferencia se nota en tareas repetibles:

crear providers, tools, adapters o harnesses con forma común;
migrar paquetes donde cada módulo debe exponer el mismo contrato;
mantener ejemplos y fixtures alineados con el runtime real;
bloquear PRs generados que "parecen correctos" pero rompen convenciones invisibles.

Lo que no conviene automatizar a ciegas

El riesgo es tratar a konsistent como una capa mágica de calidad. No valida producto, seguridad ni intención. Una regla puede estar mal escrita y congelar una mala arquitectura. También puede volverse fricción si cada carpeta necesita excepciones.

La forma sensata de adoptarlo es empezar por convenciones de alto valor y baja discusión: exports obligatorios, pares de archivos, nombres de factories, shape de adapters, tipos base y rutas donde los cambios agentic se repiten. Después se amplía solo si evita bugs reales.

Checklist corto

Elige una familia de archivos que los agentes suelen tocar.
Escribe reglas para la estructura que hoy revisas manualmente.
Corre pnpm konsistent en CI y en el prompt operativo del agente.
Guarda ejemplos de errores para que el agente pueda autocorregir.
Revisa reglas cada vez que el patrón del repo cambie.

Si todavía estás armando la base de herramientas y validación, empieza por el curso gratis. La lección de konsistent es directa: los agentes mejoran cuando el repo no depende solo de memoria tribal.