¿Qué es ZeeSpec?
ZeeSpec es el método de Vishal Mysore para el desarrollo guiado por especificaciones: 60 preguntas en seis grupos (qué, dónde, cuándo, quién, por qué, cómo), diez por grupo, pensadas para responderse en una hora más o menos, de modo que a un agente no le quede ningún comportamiento sin definir que adivinar. Un pequeño CLI en Node.js genera ocho plantillas en Markdown en una carpeta .spec/, las une en AGENTS.md y copia el prompt al portapapeles.
La app de navegador en vishalmysore.github.io/zeespec/app tiene tres pestañas. Spec Builder recorre las preguntas y puede redactar AGENTS.md con un modelo local en WebGPU. EPIC Score puntúa una especificación, un repositorio público de GitHub o un texto pegado según una versión heurística de la rúbrica EPIC de un artículo de arXiv de octubre de 2026: 40 prácticas en 10 dimensiones, con una nota sobre 30. SpecGuard recrea SpecGuardBench en miniatura: 16 tareas de JavaScript que comprueban si el arnés de validación de un modelo rechaza una implementación con errores y acepta dos correctas. El repositorio tiene 14 commits y ninguna release; el último commit fue el 16 de noviembre de 2026.
¿Merece la pena ZeeSpec?
La idea útil aquí es la pestaña SpecGuard, no el método. Muestra, en un navegador y sin GPU, el fallo que documenta un artículo llamado SpecGuardBench: pídele a un modelo que escriba tests a partir de una implementación de referencia y reflejará la referencia, errores incluidos. De las tres líneas base integradas, reflejar la referencia obtiene un 0% de fidelidad, repetir el test existente obtiene un 0% y solo un oráculo escrito a mano llega al 100%. Cada arnés se ejecuta en un worker sin red y con límite de tiempo, y se puede editar y volver a ejecutar. Como demostración de por qué los tests escritos por agentes aprueban errores, es más clara que la mayoría de la prosa sobre el tema.
La pestaña EPIC Score es más modesta de lo que sugiere su insignia. Es una reimplementación heurística de la rúbrica del artículo, no la herramienta de los autores, y la app lo dice; el hallazgo del artículo de que las especificaciones de la franja alta dedicaban el 11,8% de los commits a corregir errores, frente al 20,4% de la franja baja, es una correlación sobre 114 repositorios.
Las 60 preguntas son buenas preguntas, las que haría un responsable técnico cuidadoso: qué no debe guardarse nunca, quién no debe actuar nunca, cuándo debe bloquear el sistema. La promesa de una hora queda matizada por el propio descargo de responsabilidad del proyecto.
La pega: el comando de instalación del README, `npx spec-cli init`, descarga un paquete de npm sin relación llamado spec-cli, publicado por otro autor en 2024 y que apunta a otro repositorio; ZeeSpec en sí no está en npm. Ejecutarlo ejecuta el código de un desconocido. Clona el repositorio y ejecuta bin/spec.js en su lugar. El proyecto tiene 18 estrellas y 14 commits.
Nuestra opinión: trata ZeeSpec como una hoja de trabajo y una demostración para clase. Spec Kit de GitHub es la herramienta de producción para el mismo trabajo.
Dónde se gana su sitio
Una responsable de ingeniería que organiza un taller interno sobre tests escritos por agentes
Enseñar a los desarrolladores por qué los tests generados a partir del código no detectan los errores de ese código
Abre la pestaña SpecGuard, activa el modo mirror trap y ejecuta en directo las tres líneas base: el oráculo obtiene un 100% de fidelidad y las otras dos un 0%. Gratis, sin nada que instalar, y cada arnés se ejecuta aislado en el navegador.
Un desarrollador en solitario que empieza una pequeña app de reservas con Claude Code
Escribir una especificación lo bastante completa para que el agente deje de inventarse reglas
Recorre las 60 preguntas en Spec Builder, exporta AGENTS.md, compruébalo en la pestaña EPIC Score y pega su prompt de corrección en el agente. Para el CLI, clona el repositorio en lugar de usar npx.
Antes de decidirte
- Puesta en marcha
- Abre la app web en un navegador con WebGPU para el modelo local, o clona el repositorio y ejecuta `node bin/spec.js init`. No ejecutes `npx spec-cli`: ese nombre en npm pertenece a un paquete sin relación.
- Integraciones
- Genera AGENTS.md para cualquier agente que lo lea; EPIC Score lee estructuras de Spec Kit, Kiro, ZeeSpec y AGENTS.md en repositorios públicos de GitHub; WebLLM para el modelo local opcional.
- Datos y privacidad
- La app afirma que nada sale de tu navegador; la descarga del modelo y las lecturas de repositorios de GitHub son el único tráfico de red. Los arneses de SpecGuard se ejecutan en workers sin red. Licencia MIT.
- Límites
- SpecGuard tiene 16 tareas de JavaScript frente a las 291 tareas de Python del artículo, así que las puntuaciones no son comparables; la puntuación EPIC es heurística; sin paquete en npm ni releases etiquetadas.
Lo bueno
- SpecGuard muestra con claridad los fallos de los tests espejo
- La app de navegador funciona en local, con workers de test sin red
- 60 preguntas concretas que destapan comportamientos sin definir
- Honesto sobre la puntuación heurística y sus límites
Lo malo
- El comando npx del README instala un paquete de npm sin relación
- La puntuación EPIC es una heurística, no la herramienta del artículo
- Proyecto diminuto: 18 estrellas, 14 commits, sin releases
- Descarga del modelo local de entre 1 y 2 GB
Ideal para
Responsables técnicos y docentes que quieren una lista de comprobación estructurada para especificaciones y una demostración clara de cómo los agentes escriben tests que dejan pasar errores.
Alternativas a ZeeSpec
ZeeSpec: preguntas frecuentes
- ¿Merece la pena ZeeSpec?
- Las preguntas de ZeeSpec son una lista de comprobación sólida y su pestaña SpecGuard es una pequeña herramienta didáctica muy afilada, pero la línea de instalación del CLI apunta al paquete de otra persona. Le damos un 3.3 sobre 5.
- ¿Cuánto cuesta ZeeSpec?
- Gratis y de código abierto (MIT). La app web funciona en tu navegador; su modelo local opcional se descarga una vez y ocupa entre 1 y 2 GB.
- ¿Qué inconvenientes tiene ZeeSpec?
- El comando npx del README instala un paquete de npm sin relación; la puntuación EPIC es una heurística, no la herramienta del artículo; proyecto diminuto: 18 estrellas, 14 commits, sin releases; descarga del modelo local de entre 1 y 2 GB.
- ¿Para quién es ZeeSpec?
- Responsables técnicos y docentes que quieren una lista de comprobación estructurada para especificaciones y una demostración clara de cómo los agentes escriben tests que dejan pasar errores.
- ¿Es ZeeSpec seguro para los datos de la empresa?
- La app afirma que nada sale de tu navegador; la descarga del modelo y las lecturas de repositorios de GitHub son el único tráfico de red. Los arneses de SpecGuard se ejecutan en workers sin red. Licencia MIT.
- ¿Cuáles son las mejores alternativas a ZeeSpec?
- Las alternativas más cercanas que hemos analizado son Spec Kit y Agent Skills (Addy Osmani).
Respuestas comprobadas el 21 nov 2026.