EN
🏛️ 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 20 Agent Skills profesionales.

Ver en GitHub → Ver Características
💖 Apoya el proyecto: Ko-fi

✅ 100% Gratis · ✅ Open Source (MIT) · ✅ 20 Agent Skills · ✅ 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
  • • 20 Agent Skills aplican best practices

Características Principales

🎯

Cuestionario Interactivo (ES/EN)

58 preguntas que generan tu CONTRATO.md completo automáticamente en 20 minutos. Disponible en Español e Inglés. Validaciones inteligentes y guardado parcial.

⭐

20 Agent Skills TIER 1

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

🔒

CONTRATO Inmutable

Define alcance y nunca cambia. Propuestas de cambio via comando 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 Formal

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

🛡️

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.

❓

Descubribilidad Total

Escribe ayuda en el chat y ve TODOS los comandos disponibles (conversacionales + CLI).

🌍

Multiidioma (ES + EN)

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

🛡️ Calidad Garantizada: Validación en 3 Capas

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

1

Git Hook Pre-Commit (Automático)

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

Validación Completa en `implementar` (1-5 min)

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

CodeRabbit en PR (5-10 min)

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

✅ Resultado: Menos bugs, code reviews más rápidos, aprendizaje continuo

Las 3 capas trabajan juntas para garantizar que solo código de calidad llegue a producción.

20 Agent Skills — La Diferencia

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

Sin Skills

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

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%

🔒 Seguridad (5)

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

🔄 Consistencia (3)

  • • Verification-before-completion ⭐
  • • Code review excellence
  • • Systematic debugging

🎨 Diseño (6)

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

🛠️ Backend (6)

  • • Laravel specialist
  • • React best practices
  • • TDD
  • • API design
  • • PostgreSQL design
  • • Error handling

Instalación Rápida

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

📦

vía npm

RECOMENDADO

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/iapanderson/specleap-framework.git
cd specleap-framework
bash install.sh

✅ Control total del código fuente
✅ Ideal para contribuidores

Flujo de Instalación (Ambos Métodos)

Después de ejecutar cualquiera de los dos comandos, seguirás estos pasos:

1. Cuestionario Interactivo (10-15 min)

El instalador arranca automáticamente y te hace 58 preguntas sobre tu proyecto.

Qué genera:
1. Selecciona idioma (ES/EN)
2. Crea estructura de carpetas
3. CONTRATO.md completo con toda la información
4. Agentes especializados + comandos conversacionales

2. Configurar Sistema de Calidad (OBLIGATORIO) 

# Asana + 20 Agent Skills + CodeRabbit + Git Hooks
bash scripts/setup-mcp.sh

# O configura manualmente:
nano .env

Componentes obligatorios:
✅ Asana (backlog) | ✅ CodeRabbit (code review) | ✅ 20 Skills (best practices) | ✅ Git Hooks (validación local) | ✅ GitHub (control versiones)
Sin estos componentes SpecLeap NO es profesional.
Ver SETUP.md para detalles.

3. Abrir en tu IDE 

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.

1

Ejecuta Cuestionario (20 min)

./scripts/generate-contrato.sh

# Responde 58 preguntas sobre tu proyecto
# Guardado automático cada 10 preguntas

Genera CONTRATO.md completo con toda la información del proyecto.

2

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

Planifica en Asana

# En chat con Claude/Cursor:
planificar

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

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

Documenta

# En chat:
documentar "API de usuarios"

# Genera docs OpenAPI/Swagger
# Actualiza README técnico

Funciona con tu IDE Favorito

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

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.

💖 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

Las donaciones nos ayudan a:

  • ✅ Mantener el framework actualizado
  • ✅ Desarrollar nuevas features
  • ✅ Mejorar documentación
  • ✅ Crear más Agent Skills
  • ✅ Soporte a la comunidad

Empieza Hoy Mismo

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

Ver en GitHub → Leer Documentación