EN
SpecLeap
Framework Open Source

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 profesionales.

Ver en GitHub → Ver Características

✅ 100% Gratis · ✅ Open Source (MIT) · ✅ 34 Agent Skills (20 TIER 1 + 14 TIER 2) · ✅ Español + English

0
Agent Skills
0
Preguntas Máx.
0
Capas Validación
0
Comandos

❌ 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 (20 TIER 1 + 14 TIER 2) aplican best practices
Qué incluye

Características
Principales

01 · Killer Feature
34
TIER 1 + TIER 2

Agent Skills

Seguridad (OWASP, STRIDE), diseño profesional (Vercel-style), consistencia DRY, TDD, Laravel/React best practices.

02

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.

03

CONTRATO Inmutable

Define alcance y nunca cambia. Propuestas de cambio via refinar o CLI openspec.

04

Comandos en Español

refinar planificar implementar documentar

Workflow natural conversacional.

05

Agentes Especializados

Backend, Frontend, Producto. Cada uno con reglas específicas de su dominio.

06

Integración Asana

Genera backlog automáticamente desde CONTRATO.md. Épicas, user stories y tasks listos para sprint.

07

Monorepo Multi-Proyecto

Cada proyecto independiente en proyectos/ con su CONTRATO, context/ y código.

08

Standards Globales

PHP/Laravel, JavaScript/React, CSS/Tailwind, documentación. Consistencia en todos los proyectos.

09

OpenSpec CLI

Workflow formal con propuestas de cambio, delta specs, verificación y archivado. Perfecto para equipos enterprise.

10

Descubribilidad Total

Escribe ayuda en el chat y ve TODOS los comandos disponibles.

11 Destacado

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.

12 ES · EN

Multiidioma

Todo el framework traducido: instalador, cuestionario, comandos, documentación. Selecciona tu idioma preferido en el primer paso.

Cuestionario adaptable

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.

Modo 1 · Rápido

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.

Recomendado
Modo 2 · Empresarial

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.

Modo 3 · Conversacional

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.

Calidad garantizada

Validación en
3 Capas

SpecLeap valida automáticamente tu código en 3 niveles progresivos antes de llegar a producción.

1
< 5 seg
Automático

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

2
1-5 min
Pre-push

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

3
5-10 min
En PR

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. 1. .coderabbit.yaml ya incluido
  2. 2. Instala app GitHub
  3. 3. Abre PR → Revisa automáticamente
Resultado

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.

La diferencia

34 Agent
Skills

Agent Skills son extensiones especializadas que transforman la calidad del código generado por IA.

20
Tier 1
+
14
Tier 2
✕
Antes

Sin Skills

  • — Bootstrap genérico
  • — Vulnerabilidades básicas
  • — Duplicación de código frecuente
  • — APIs inconsistentes
  • — Coverage <60%
✓
Después

Con Skills TIER 1

  • → Estilo Vercel/Linear profesional
  • → OWASP Top 10 + STRIDE threat modeling
  • → DRY automático, verifica antes de crear
  • → REST/GraphQL best practices
  • → TDD methodology, coverage ≥90%
Desglose Tier 1

20 skills en 4 categorías

5
🔒

Seguridad

  • → SAST config
  • → STRIDE threat
  • → Security extraction
  • → Backend/API security
  • → Frontend/Mobile security
3
⚙

Consistencia

  • → Verification-before-completion
  • → Code review excellence
  • → Systematic debugging
6
◆

Diseño

  • → Web design (Vercel)
  • → Frontend (Anthropic)
  • → UI/UX pro max
  • → Tailwind system
  • → shadcn/ui
  • → Responsive design
6
⚡

Backend

  • → Laravel specialist
  • → React best practices
  • → TDD
  • → API design
  • → PostgreSQL design
  • → Error handling
Empieza en 10 min

Instalación
Rápida

Listo en 10-15 minutos. Elige tu método: npm (más rápido) o GitHub (desarrollo).

Recomendado
Método A

vía npm

Instalación automática con un solo comando.

npx specleap-framework@latest

✅ Descarga + instalador interactivo

✅ Siempre la última versión estable

Método B

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

Después de instalar

3 pasos para arrancar

Ambos métodos siguen este flujo.

1
10-15 min

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 markitdown para 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
2
Obligatorio

Configurar Sistema de Calidad

Asana + 34 Agent Skills + CodeRabbit + Git Hooks. 

# Asana + 34 Agent Skills (20 TIER 1 + 14 TIER 2) + CodeRabbit + Git Hooks
bash scripts/setup-mcp.sh

# O configura manualmente:
nano .env

Componentes obligatorios

Asana CodeRabbit 34 Skills Git Hooks GitHub

Sin estos componentes SpecLeap NO es profesional.

Ver SETUP.md para detalles.

3
¡Listo!

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.

End-to-end

Workflow
Completo

De idea a código funcionando en pasos claros.

1
20 min

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 preguntas

Genera CONTRATO.md completo con toda la información del proyecto. Puedes pasar de un modo a otro tras generarlo.

2
Obligatorio

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.

3
Asana

Planifica en Asana

# En chat con Claude/Cursor:
planificar

# Genera backlog automático desde CONTRATO.md
# Crea secciones + user stories + tasks
4
Código

Implementa Según Spec

# En chat:
implementar "login con Google"

# Verifica si está en CONTRATO
# Lee context/ para contexto
# Genera código siguiendo standards
5
Docs

Documenta

# En chat:
documentar "API de usuarios"

# Genera docs OpenAPI/Swagger
# Actualiza README técnico
Tu IDE, tu elección

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.

VSCode ✦ Cursor ✦ JetBrains ✦ Vim ✦ Zed ✦ Copilot ✦ Continue ✦ Codeium ✦ Gemini ✦ Tabnine ✦

Estos son solo algunos ejemplos. Si tu IDE tiene IA, SpecLeap funciona.

V

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
C

Cursor / Continue

IDEs nativos con Claude integrado. Soporte completo out-of-the-box.

  • → Comandos conversacionales nativos
  • → Memory-bank en context/
  • → Agent Skills integradas
G

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
Lo importante

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.

Donaciones

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 →
Tu aporte ayuda a
  • 01 Mantener el framework actualizado
  • 02 Desarrollar nuevas features
  • 03 Mejorar documentación
  • 04 Crear más Agent Skills
  • 05 Soporte a la comunidad
Preguntas frecuentes

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:

Proveedor IA

Anthropic, OpenAI, Google, Meta

Asistente

Claude Code, Continue.dev, Copilot, Cmd-K

IDE

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.

¿Tu pregunta no está aquí? Escríbenos a info@specleap.com o abre un issue en GitHub.

Sin excusas

Empieza
hoy mismo

100% gratuito. Sin registro. Sin tarjeta de crédito. Solo clona y empieza.

Ver en GitHub → Leer Documentación
Comunidad

Colabora con
SpecLeap

SpecLeap es open source y se mantiene gracias a la comunidad. Aporta con código, documentación o una donación.

Formulario

Únete como contribuidor

Déjanos tus datos y te contactaremos para incorporarte al equipo. Código, docs, testing, diseño: toda ayuda suma.