SpecLeap Framework
Transforma VSCode, Cursor, JetBrains, Vim, Zed o cualquier IDE con asistente de IA en una máquina de desarrollo spec-first. CONTRATO inmutable, agentes especializados y 34 Agent Skills curados.
✅ 100% Gratis · ✅ Open Source (MIT) · ✅ 34 Agent Skills curados · ✅ Español + English
❌ Sin SpecLeap
- • La IA improvisa código sin contexto
- • Specs incompletas → implementación incorrecta
- • Sin memoria → repite errores
- • Cambios de scope sin control
- • Código genérico y vulnerable
✅ Con SpecLeap
- • CONTRATO define alcance inmutable
- • Context/ guarda decisiones arquitectónicas
- • Agentes especializados siguen standards
- • Comandos conversacionales guían el flujo
- • 34 Agent Skills curados aplican best practices del stack
Características
Principales
Agent Skills
Laravel + React + TypeScript + PostgreSQL + shadcn. Verification-before-completion, TDD, code review, security review, GDPR — sin invenciones, todos los skills existen en repos públicos.
Cuestionario en 3 Modos
MVP (58 preguntas), Proyecto Serio (93 preguntas con governance/SLAs/compliance) o Modo Creativo (describes en un párrafo y la IA extrae lo dicho). ES/EN, validaciones inteligentes, guardado parcial.
CONTRATO Inmutable
Define alcance y nunca cambia. Propuestas de cambio via refinar o CLI openspec.
Comandos en Español
refinar planificar implementar documentar Workflow natural conversacional.
Agentes Especializados
Backend, Frontend, Producto. Cada uno con reglas específicas de su dominio.
Integración Asana
Genera backlog automáticamente desde CONTRATO.md. Épicas, user stories y tasks listos para sprint.
Monorepo Multi-Proyecto
Cada proyecto independiente en proyectos/ con su CONTRATO, context/ y código.
Standards Globales
PHP/Laravel, JavaScript/React, CSS/Tailwind, documentación. Consistencia en todos los proyectos.
OpenSpec CLI
Workflow formal con propuestas de cambio, delta specs, verificación y archivado. Perfecto para equipos enterprise.
Descubribilidad Total
Escribe ayuda en el chat y ve TODOS los comandos disponibles.
Validación Automática 3 Capas
Git hooks pre-commit (<5 seg), validación completa en implementar (1-5 min), CodeRabbit en PR (5-10 min). Calidad garantizada.
Multiidioma
Todo el framework traducido: instalador, cuestionario, comandos, documentación. Selecciona tu idioma preferido en el primer paso.
Elige cómo
crear tu CONTRATO
Tres modos según el tipo y la madurez del proyecto. Empieza simple, crece después: puedes pasar de un modo a otro en cualquier momento.
MVP
Prototipo / Side-project / Equipo pequeño
- → 58 preguntas estructuradas
- → 15-20 minutos
- → Stack, features core, diseño, deploy básico, restricciones
- → Guardado automático cada 10 preguntas
Ideal cuando ya tienes claro el alcance y quieres CONTRATO en menos de media hora.
Proyecto Serio
Equipo + Departamentos + Compliance
- → 93 preguntas (las 58 de MVP + 35 extra)
- → 25-35 minutos
- → Governance, departamentos involucrados, integraciones empresariales (SSO, ERP, CRM, BI)
- → SLAs (uptime, RTO, RPO, DR, on-call)
- → Compliance (GDPR, HIPAA, PCI, SOC2, ISO27001)
- → Roadmap por fases, deploy strategy (canary, blue-green), observabilidad, multi-tenant/región/i18n
Ideal para producto enterprise con varios equipos, requisitos regulatorios o SLAs comprometidos.
Creativo
Tú Lo Cuentas · La IA Extrae
- → Describes el proyecto en uno o varios párrafos
- → 5-10 minutos
- → La IA extrae stack, audiencia, features, restricciones de tu texto
- → Te muestra un resumen para validar y solo pregunta los huecos críticos
- → Sin alucinaciones: si no lo dices, te lo pregunta
Ideal cuando ya tienes claro qué quieres y prefieres conversar antes que rellenar formulario.
Puedes saltar entre modos
Al terminar el cuestionario, SpecLeap te ofrece ampliar a Serio (añadir governance, compliance, SLAs sin repetir lo ya respondido) o añadir Contexto Adicional en modo Creativo (un párrafo libre que se anexa al CONTRATO). Iterativo: lo repites las veces que necesites hasta que el CONTRATO refleje exactamente tu proyecto.
Validación en
3 Capas
SpecLeap valida automáticamente tu código en 3 niveles progresivos antes de llegar a producción.
Git Hook Pre-Commit
Se ejecuta antes de cada commit. Validación rápida en menos de 5 segundos.
Valida
- → Sintaxis (PHP, JS/TS)
- → Linters (ESLint, PHPStan)
- → Formatters (Prettier, PHP-CS-Fixer)
- → CONTRATO.md no se modifica
- → Sin console.log / var_dump
Instalación
bash scripts/install-git-hooks.sh❌ Si falla: Rechaza el commit
Validación Completa en implementar
Se ejecuta al terminar una feature antes de push. Validación exhaustiva.
Valida
- → Tests unitarios
- → Tests de integración
- → Cumplimiento vs CONTRATO.md
- → Cumplimiento vs specs
- → Coverage ≥ 80%
Resultado
✅ Si pasa: Commit + Push + Crea PR
❌ Si falla: NO hace push, muestra errores
CodeRabbit Review
Se ejecuta automáticamente al crear PR en GitHub. Revisión profunda.
Valida
- → Arquitectura y patrones
- → Seguridad (vulnerabilidades)
- → Lógica de negocio
- → Complejidad ciclomática
- → Documentación
Setup
- 1. .coderabbit.yaml ya incluido
- 2. Instala app GitHub
- 3. Abre PR → Revisa automáticamente
Menos bugs. Reviews más rápidos.
Aprendizaje continuo.
Las 3 capas trabajan juntas para garantizar que solo código de calidad llegue a producción.
34 Agent
Skills
Skills curados, cada uno mantenido por su autor en un repo público. Sin invenciones, sin contar dos veces lo mismo. Activación automática cuando el contexto los necesita.
Sin Skills
- — Bootstrap genérico
- — "Listo" sin verificar tests ni evidencia
- — Duplicación de código frecuente
- — APIs inconsistentes
- — Coverage <60%
Con los 34 Skills
- → Diseño con ui-ux-pro-max, impeccable y design-taste-frontend
- → Iron law: evidencia fresca antes de claim "completado"
- → Stack specialist: Laravel + React + PostgreSQL + shadcn
- → Code review, security review, GDPR compliance
- → TDD methodology, coverage ≥90%
34 skills en 6 categorías
Core / Quality
- → verification-before-completion
- → systematic-debugging
- → requesting-code-review
- → receiving-code-review
- → test-driven-development
Backend
Laravel + PostgreSQL
- → laravel-specialist
- → api-designer
- → database-optimizer
- → supabase-postgres-best-practices
Frontend
React + TS + shadcn
- → react-expert
- → typescript-pro
- → vercel-react-best-practices
- → shadcn
Diseño
- → ui-ux-pro-max
- → impeccable
- → design-taste-frontend
- → emil-design-eng
- → animate, animation-performance
- → break-ui, mobile-native
- → frontend-design, web-design-guidelines, extract-design-system
Seguridad
- → security-reviewer
- → gdpr-dsgvo-expert
Proceso
- → code-reviewer, brainstorming
- → writing-plans, executing-plans
- → using-git-worktrees
- → subagent-driven-development
- → dispatching-parallel-agents
- → finishing-a-development-branch
Instalación
Rápida
Listo en 10-15 minutos. Elige tu método: npm (más rápido) o GitHub (desarrollo).
vía npm
Instalación automática con un solo comando.
npx specleap-framework@latest✅ Descarga + instalador interactivo
✅ Siempre la última versión estable
vía GitHub
Para contribuir o desarrollo local.
git clone https://github.com/ConceptualCreative/specleap-framework.git
cd specleap-framework
bash install.sh✅ Control total del código fuente
✅ Ideal para contribuidores
3 pasos para arrancar
Ambos métodos siguen este flujo.
Cuestionario Adaptable (3 modos)
Cuando dices Hola, la IA te pregunta qué tipo de proyecto vas a montar y elige el cuestionario adecuado: MVP, Proyecto Serio o Modo Creativo.
Qué genera
- 1.Selecciona idioma (ES/EN) y oferta opcional de
markitdownpara reducir tokens al procesar PDF/Word/Excel - 2.Crea estructura de carpetas para tu proyecto
- 3.Pregunta el modo y aplica el cuestionario correspondiente
- 4.CONTRATO.md completo + agentes + comandos conversacionales
- 5.Permite saltar entre modos después: empezar simple y crecer, o al revés
Configurar Sistema de Calidad
Asana + 34 Agent Skills + CodeRabbit + Git Hooks.
# Asana + 34 Agent Skills curados + CodeRabbit + Git Hooks
bash scripts/setup-mcp.sh
# O configura manualmente:
nano .envComponentes obligatorios
Sin estos componentes SpecLeap NO es profesional.
Ver SETUP.md para detalles.
Abrir en tu IDE
Abre el proyecto en tu editor favorito con asistente de IA.
code . # VSCode
cursor . # Cursor
# En el chat:
ayuda ¡Listo! Escribe ayuda para ver todos los comandos disponibles.
Workflow
Completo
De idea a código funcionando en pasos claros.
Ejecuta Cuestionario
# Dile "Hola" a Claude Code y elige modo:
# MVP → 58 preguntas (15-20 min)
# Serio → 93 preguntas (25-35 min, governance + SLAs + compliance)
# Creativo → describe en un párrafo, la IA extrae y solo pregunta huecos
#
# Guardado automático cada 10 preguntasGenera CONTRATO.md completo con toda la información del proyecto. Puedes pasar de un modo a otro tras generarlo.
Push a GitHub (OBLIGATORIO)
git init
git add .
git commit -m "init: CONTRATO.md + context/"
git push origin main
# El CONTRATO.md es tu source of truth
# Debe estar versionado desde el inicio⚠️ El CONTRATO debe estar en GitHub antes de continuar.
Planifica en Asana
# En chat con Claude/Cursor:
planificar
# Genera backlog automático desde CONTRATO.md
# Crea secciones + user stories + tasksImplementa Según Spec
# En chat:
implementar "login con Google"
# Verifica si está en CONTRATO
# Lee context/ para contexto
# Genera código siguiendo standardsDocumenta
# En chat:
documentar "API de usuarios"
# Genera docs OpenAPI/Swagger
# Actualiza README técnico
Funciona con
cualquier IDE
SpecLeap es agnóstico al IDE. Funciona con cualquier editor que tenga asistente de IA: VSCode, Cursor, JetBrains, Vim, Zed, o lo que uses.
Estos son solo algunos ejemplos. Si tu IDE tiene IA, SpecLeap funciona.
VSCode + Claude Code
Instala la extensión Claude Code en VSCode. SpecLeap funciona automáticamente con comandos conversacionales y Agent Skills.
- → Lee
CLAUDE.md - → Comandos:
refinar,planificar, etc. - → Agent Skills automáticas
Cursor / Continue
IDEs nativos con Claude integrado. Soporte completo out-of-the-box.
- → Comandos conversacionales nativos
- → Memory-bank en
context/ - → Agent Skills integradas
GitHub Copilot
Usa .github/copilot-instructions.md + CLI openspec.
- → Standards globales en
rules/ - → Workflow vía CLI
- → Funciona en VSCode, JetBrains, Vim
Cualquier IDE con IA
Gemini Code Assist, Codeium, Tabnine, o tu herramienta preferida.
- → Lee archivos .md de instrucciones
- → Standards en
rules/ - → CLI openspec siempre disponible
No importa qué IDE uses. SpecLeap funciona porque lee archivos de tu proyecto (CONTRATO.md, rules/, context/), no porque dependa de una herramienta específica.
Apoya el
Proyecto
SpecLeap es 100% gratuito y open-source. Si te resulta útil, puedes apoyar su desarrollo con una donación.
Apoya en Ko-fi →- 01 Mantener el framework actualizado
- 02 Desarrollar nuevas features
- 03 Mejorar documentación
- 04 Crear más Agent Skills
- 05 Soporte a la comunidad
FAQ
Las dudas que aparecen al evaluar SpecLeap. Si la tuya no está, escribe a info@specleap.com.
01 Vendor lock-in ¿Soy cautivo de Anthropic / OpenAI / Google?
No. SpecLeap es agnóstico de proveedor por construcción, no como añadido posterior. El framework no llama a ningún API de modelo: cero tráfico hacia api.anthropic.com, api.openai.com o cualquier otro proveedor.
Todo el "conocimiento" del proyecto vive en archivos .md y .sh dentro de tu repo. Cada asistente lee su archivo de instrucciones específico: Claude lee CLAUDE.md, Cursor lee .cursorrules, GitHub Copilot lee .github/copilot-instructions.md, y así con 9+ asistentes soportados.
La especificación es el activo, no el modelo que la procesa.
02 SDD vs vibe coding ¿Por qué SDD si "vibe coding" con IA es más rápido?
Vibe coding es rápido al principio y caro al final. Después de 50-100 iteraciones, la IA pierde el contexto, contradice patrones existentes, reinventa utilidades. Tú te conviertes en el sistema de memoria a largo plazo.
SDD captura una sola vez la intención del proyecto en un CONTRATO inmutable. La IA puede iterar 1000 veces, pero siempre vuelve al mismo norte. Vibe coding escala con tiempo del developer; SDD escala con calidad de la spec.
03 Tamaño del proyecto ¿Sirve para proyectos pequeños o solo enterprise?
Hay un mínimo a partir del cual SpecLeap se rentabiliza: aproximadamente 1 semana de trabajo real.
- → Side-project de un fin de semana: probablemente no — el cuestionario inicial es overhead que no recuperas.
- → Proyecto de 1-4 semanas: sí, claramente — un solo ciclo de "no era esto" ya cuesta más que las 20 min iniciales.
- → Multi-mes con varios contributors: fundamental.
- → Enterprise / regulado: especialmente — la trazabilidad de specs versionadas es lo que piden auditorías.
04 Sin Claude Code ¿Funciona sin Claude Code? ¿Qué pierdo?
Sí, funciona con Cursor, Continue.dev, GitHub Copilot, Gemini, Codeium, Tabnine, Cline y cualquier asistente que lea archivos de instrucciones del proyecto.
Lo que pierdes sin Claude Code: integración nativa con los 34 Agent Skills (en otros asistentes los .md siguen accesibles pero no se cargan automáticamente) y el hook spec-guard.sh que se engancha al runtime de Claude Code (la protección equivalente la cubre el git hook pre-push independiente).
Lo que NO pierdes: CONTRATO, agentes, comandos, memory-bank, specs, integración Asana/CodeRabbit, cuestionario, CLI openspec — todo igual.
05 Cambiar de proveedor ¿Y si quiero cambiar de proveedor IA en medio del proyecto?
Lo haces sin perder nada. Pero el "cómo" depende de tu setup, porque proveedor IA, asistente y IDE son tres capas distintas:
Anthropic, OpenAI, Google, Meta
Claude Code, Continue.dev, Copilot, Cmd-K
VSCode, Cursor, JetBrains, Vim
Si usas Cursor o Continue.dev, cambiar proveedor es un click en sus settings. Si usas Claude Code y te pasas a OpenAI, cambias de extensión (no necesariamente de IDE). Si cambias de IDE entero, abres el repo en el nuevo y todo el contexto sigue ahí. Los .md y .sh del repo se quedan intactos pase lo que pase.
06 Asana ¿Necesito Asana obligatoriamente?
Para algunos comandos sí (crear-tickets, planificar, actualizaciones de estado en implementar). Para el grueso del framework, no.
Sin Asana funcionan: cuestionario, CONTRATO, agentes, comandos refinar / documentar / explicar / compliance / adoptar, los 34 Agent Skills, el CLI openspec completo, memory-bank, standards globales y la pipeline de validación 3 capas. Si tu equipo usa Linear, Jira, Notion o GitHub Issues, puedes gestionar el backlog manualmente.
07 Equipo + CONTRATO ¿Cómo escala con un equipo? ¿Conflictos en CONTRATO?
El CONTRATO es inmutable por diseño, así que los conflictos clásicos sobre ese archivo no existen. Los cambios al alcance original van a ANEXOS.md (append-only, versionado). Las decisiones técnicas a context/decisions.md con fecha y autor.
Cada feature en su rama feature/<proyecto>-<ticket>-<desc>, PR contra stage, después PR contra main. CodeRabbit revisa contra CONTRATO + standards. La pipeline de 3 capas valida antes del merge.
08 TDD / Agile ¿Reemplaza a TDD / Agile / Scrum?
No, los complementa. Cada uno opera en una capa distinta:
- → SDD (SpecLeap): memoria a largo plazo del proyecto — qué se construye y por qué.
- → TDD: cómo escribes el código (test first).
- → Agile / Scrum: cómo organizas el trabajo en el tiempo.
SpecLeap es la capa que faltaba en el stack metodológico ahora que la IA escribe el código. Conviven sin fricción: tu CONTRATO no choca con tu sprint board, tus tests TDD no chocan con tus specs, y tu Definition of Done de Scrum se enriquece con la pipeline de validación 3 capas.
09 Precio ¿Cuesta algo? ¿Qué licencia tiene?
SpecLeap es gratis y open source (MIT). No hay cuenta, plan de pago ni tarjeta. Clonas el repo o lo instalas con npm y el código es tuyo.
El único coste es el del asistente que ya uses —Claude, Cursor, Copilot u otro—. SpecLeap no intermedia esa suscripción ni añade una propia.
10 Requisitos ¿Qué tengo que tener instalado? ¿Funciona en Windows?
Hace falta Node.js 18 o superior, Git y Bash. El setup completo lleva 10-15 minutos. PHP, Composer, PostgreSQL o Docker solo entran si el proyecto que vas a construir los usa.
En Windows instala Git for Windows: trae Git Bash y el instalador lo detecta solo. Si al renombrar la carpeta Windows la tiene en uso, el setup sigue con el nombre actual. Lo más fiable es clonar ya con el nombre final: git clone <url> mi-proyecto. macOS y Linux ya traen Bash.
11 Proyecto a medias ¿Sirve si el proyecto ya está empezado?
Sí. El comando adoptar lee el código que ya existe y redacta un CONTRATO retroactivo: qué hay, qué queda fuera y cuáles son las reglas a partir de ahora.
No reescribe la aplicación. Documenta lo que ya está construido para que el alcance deje de moverse en silencio en los siguientes cambios.
12 Me equivoqué ¿Y si contesto mal el cuestionario o cambia el alcance?
El cuestionario guarda el progreso cada 10 preguntas. Al terminarlo puedes ampliar de MVP a Proyecto Serio —añade governance, SLAs y compliance sin repetir lo ya dicho— o anexar un párrafo libre en modo Creativo.
Cuando el CONTRATO ya está aprobado, no se edita. Un cambio de alcance se registra en ANEXOS.md con el comando refinar. Así se distingue qué se pidió al principio y qué se añadió después.
13 Otro stack ¿Tengo que usar Laravel, React y PostgreSQL?
No es obligatorio. Los standards y parte de los skills están afinados para Laravel, React, TypeScript, PostgreSQL y shadcn, y el cuestionario te deja declarar otro stack. A partir de ahí manda el CONTRATO.
Los skills de calidad, proceso, seguridad y diseño siguen aplicando. Los de Laravel o React aportan menos si tu proyecto no usa ese stack.
14 Tus datos ¿SpecLeap sube mi código o mi CONTRATO a algún sitio?
No tiene servidor ni cuenta. El CONTRATO y el código se quedan en tu repositorio. El framework no llama a APIs de modelos. Durante el setup, el instalador clona los 34 skills desde repos públicos de GitHub a ~/.claude/skills/.
Lo que sale después de tu máquina es lo que tú conectas: el asistente de IA que ya pagas, GitHub si haces push, Asana si pegas el token, CodeRabbit si instalas la app. Si vuelves a lanzar el instalador, solo se actualizan los skills del catálogo. Uno tuyo, con otro nombre, no se toca.
¿Tu pregunta no está aquí? Escríbenos a info@specleap.com o abre un issue en GitHub.
Empieza
hoy mismo
100% gratuito. Sin registro. Sin tarjeta de crédito.
Solo clona y empieza.
Colabora con
SpecLeap
SpecLeap es open source y se mantiene gracias a la comunidad. Aporta con código, documentación o una donación.
Únete como contribuidor
Déjanos tus datos y te contactaremos para incorporarte al equipo. Código, docs, testing, diseño: toda ayuda suma.