VibeSpec 🧠

El estándar abierto de colaboración agéntica humano-IA para mitigar la deuda técnica cognitiva.

🌍VibeSpec Repository in English

---

🧭 ¿Qué es VibeSpec?

VibeSpec es el estándar abierto para la colaboración entre humanos y sistemas de inteligencia artificial. Nace en 2026, cuando producir con IA ya no consiste en escribir el resultado a mano sino en dirigir intención, y los agentes de IA se han convertido en compañeros de equipo.

Nació en el desarrollo de software — sigue siendo su caso de uso insignia y el más maduro dentro del estándar — pero sus principios no dependen del código: se aplican a cualquier disciplina donde una persona dirige a un agente de IA y necesita conservar el control de calidad y seguridad sobre el resultado (escritura, traducción, análisis de datos, documentos legales, diseño, investigación, etc.). Lo que cambia entre disciplinas no es el método, sino la compuerta de verificación concreta que se aplica en cada una — ver Skills para Hermes Agent más abajo para el detalle de este diseño.

Define principios, roles, listas de verificación y métricas que permiten a cualquier equipo —independientemente de su tamaño, disciplina, nivel de experiencia o herramienta elegida—:

• Traducir ideas en especificaciones ejecutables (Spec‑Driven Development)
• Mantener el control humano sobre la calidad y la seguridad
• Aprender a colaborar con agentes de IA de forma progresiva
• Escalar desde un prototipo rápido hasta un sistema de misión crítica

---

🚀 ¿Por qué VibeSpec?

Situación actual	Con VibeSpec
Cada herramienta tiene su propio vocabulario y flujo	Glosario unificado que mapea conceptos comunes a todas las plataformas
El "vibe coding" produce entregables sin revisión que llegan a producción	Checklists obligatorias que evitan riesgos sin frenar la creatividad
No está claro qué rol juega la persona frente a la IA	Nuevo rol del profesional como arquitecto, auditor y tomador de decisiones
Falta de trazabilidad en las decisiones de la IA	Traza completa desde la intención hasta el resultado final
Curva de aprendizaje empinada y desorganizada	Ruta de adopción Lite → Pro con métricas de madurez

Los ejemplos concretos de checklists y métricas de esta tabla están desarrollados hoy para desarrollo de software (el caso de uso más maduro del estándar); el mecanismo se traslada igual a otras disciplinas conforme se definan sus propias compuertas.

---

📁 Estructura del repositorio

vibespec\
├── checklists\
│   ├── templates\
│   │   ├── ejemplo-desviacion.md
│   │   ├── template-markdown.md
│   │   └── template-yaml.yaml
│   ├── README.md
│   └── vibespec-check.md
├── governance\
│   ├── adopcion.md
│   ├── desviaciones.md
│   ├── evolucion.md
│   └── README.md
├── skills\
│   ├── README.md
│   ├── vibespec-lite.md
│   └── vibespec-pro.md
├── hermes-skills\
│   └── vibespec\
│       ├── README.md
│       ├── vibespec-lite\
│       │   └── SKILL.md
│       └── vibespec-pro\
│           └── SKILL.md
├── standard\
│   ├── glosario.md
│   ├── plantillas-prompts.md
│   ├── vibespec-lite.md
│   └── vibespec-pro.md
├── LICENSE.md
├── README.md
└── TRADEMARK.md

---

⚡ Empieza en 2 minutos

1. Elige tu nivel

   • Si eres principiante o estás en un proyecto pequeño → standard/vibespec-lite.md
   • Si trabajas en un entorno empresarial o de alta criticidad → standard/vibespec-pro.md

2. Descarga la checklist maestra checklists/vibespec-check.md y pégala en tu próxima entrega (PR, borrador, informe...).

3. Crea tu archivo de contexto Añade un AGENTS.md o .cursor/rules con las instrucciones que la IA debe seguir.

4. Instala la Skill de VibeSpec en tu agente (Cursor, Windsurf, Claude Code) para automatizar los recordatorios.

5. Usa las Skills de Hermes (ver abajo) si tu agente es Hermes Agent, para cargar el estándar como skill nativa.

---

🤖 Skills para Hermes Agent

Además de los system prompts para otros IDEs, VibeSpec incluye Skills nativas de Hermes Agent en hermes-skills/vibespec/:

Skill	Nivel	Qué hace
vibespec-lite	Lite	Aplica la compuerta C1‑C6 y exige verificación humana antes del commit.
vibespec-pro	Pro	Aplica la verificación por fases (P/R/F/D/DP) leyendo el checklist maestro.

Consulta hermes-skills/vibespec/README.md para el diseño (una skill parametrizada por disciplina, no una por campo). Hoy ambas skills leen el checklist único de checklists/vibespec-check.md, centrado en desarrollo de software; el diseño deja espacio para sumar checklists de otras disciplinas sin tener que crear skills nuevas.

Instalación en tu perfil de Hermes (local):

# Copia la carpeta de la skill a tu perfil
cp -r hermes-skills/vibespec/vibespec-lite \
     ~/.hermes/profiles/<tu-perfil>/skills/vibespec/
cp -r hermes-skills/vibespec/vibespec-pro \
     ~/.hermes/profiles/<tu-perfil>/skills/vibespec/

O, desde una sesión de Hermes, pídele que cargue la skill con skill_view(name="vibespec-lite"). El agente leerá el checklist canónico desde checklists/vibespec-check.md en vez de hardcodearlo, así la skill no se desincroniza cuando actualices el estándar.

---

🎯 Principios fundamentales

1. Intención explícita antes de ejecución
2. Verificación humana obligatoria en cada ciclo
3. Contexto como activo versionable del proyecto
4. Trazabilidad y control de cambios de todas las decisiones
5. Seguridad desde el diseño (Secure‑by‑Design)
6. Gobernanza humana de las decisiones arquitectónicas
7. Mejora continua del propio proceso

Estos siete principios son deliberadamente agnósticos de disciplina: no mencionan código, texto ni ningún artefacto concreto. Lo que sí es específico de cada campo son las checklists de compuerta que los implementan (hoy, la de desarrollo de software).

Ver desarrollo completo →

---

🧑‍🚀 El nuevo rol del profesional

Quien dirige al agente ya no es un mero ejecutor de tareas: es el arquitecto de contexto, el auditor de seguridad y estabilidad, el curador de calidad y el tomador de decisiones finales. La IA propone, pero la responsabilidad —técnica, legal y ética— sigue siendo humana.

En desarrollo de software esto se traduce en que el programador deja de ser un tecleador de código para convertirse en ese arquitecto/auditor; en otras disciplinas el mismo cambio de rol aplica al editor que dirige la redacción de un agente, al analista que audita un pipeline de datos generado por IA, o a cualquier profesional que supervise un flujo de trabajo agéntico.

---

📊 Métricas de madurez

Nivel	Checklist activa	Conformidad esperada
Lite	C1‑C6	≥ 90 % de entregables
Estructurado	Lite + Planificación + Funcionalidad	≥ 85 % de entregables
Pro	Todas las fases (incluye despliegue)	≥ 80 % de entregables

La unidad de medida ("entregable") sustituye aquí al "PR" original para no asumir que la salida siempre es código; en desarrollo de software un entregable sigue siendo, en la práctica, un PR.

Guía de adopción progresiva →

---

🤝 Contribuir

VibeSpec es un estándar vivo. Si encuentras un área de mejora, un nuevo riesgo que cubrir, quieres compartir una plantilla útil, o quieres proponer el checklist de una disciplina distinta a software:

1. Abre un issue describiendo la propuesta.
2. Comenta y debate durante dos semanas (cambios menores) o un mes (cambios mayores).
3. Si hay consenso, se integra en la siguiente revisión.

Consulta governance/evolucion.md para el proceso completo.

---

📜 Licencia

El contenido del estándar está bajo Creative Commons BY 4.0. Los fragmentos de código, bajo MIT. La marca VibeSpec™ tiene una política de uso en TRADEMARK.md.

---

💖 Apoyo y Donaciones

VibeSpec es un estándar gratuito y abierto, creado para resolver un problema real: poner orden en el caos de producir con IA.

Si este estándar te ahorra horas de revisión, te ayuda a entregar con seguridad o te da un marco para enseñar a tu equipo, considera invitarnos un café a través del siguiente enlace:

Cada contribución nos permite mantener, mejorar y compartir VibeSpec con la comunidad.

---

Diseñado con precisión de estándar y pasión por el trabajo bien hecho.

Creado por Franklin A. Lara P. (@FrkL81)