specleap-framework 2.1.0 → 2.1.5

package/openspec/templates/design.md

@@ -0,0 +1,181 @@
+# [CHANGE-XXX] Diseño Técnico: Título del Cambio
+
+| Campo | Valor |
+|-------|-------|
+| ID | CHANGE-XXX |
+| Propuesta | `proposal.md` |
+| Fecha | YYYY-MM-DD |
+| Estado | draft / review / approved |
+| Arquitecto | nombre |
+
+## Resumen del Diseño
+
+Descripción técnica de alto nivel de cómo se implementará la propuesta.
+
+## Arquitectura
+
+### Diagrama de Componentes
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│ Componente A│────▶│ Componente B│────▶│ Componente C│
+└─────────────┘     └─────────────┘     └─────────────┘
+```
+
+### Componentes Afectados
+
+| Componente | Tipo de Cambio | Descripción |
+|------------|----------------|-------------|
+| ComponenteA | Nuevo / Modificado | Qué cambia |
+| ComponenteB | Modificado | Qué cambia |
+
+## Modelo de Datos
+
+### Nuevas Entidades
+
+```typescript
+interface NuevaEntidad {
+  id: string;
+  campo1: string;
+  campo2: number;
+  createdAt: Date;
+  updatedAt: Date;
+}
+```
+
+### Cambios en Entidades Existentes
+
+```diff
+interface EntidadExistente {
+  id: string;
+  campoExistente: string;
++ nuevoCampo: string;      // Añadido
+- campoEliminado: string;  // Eliminado
+}
+```
+
+### Migraciones de Base de Datos
+
+```sql
+-- Migration: YYYYMMDDHHMMSS_descripcion
+ALTER TABLE tabla ADD COLUMN nuevo_campo VARCHAR(255);
+```
+
+## API / Interfaces
+
+### Nuevos Endpoints
+
+```
+POST /api/v1/recurso
+GET  /api/v1/recurso/:id
+PUT  /api/v1/recurso/:id
+DELETE /api/v1/recurso/:id
+```
+
+### Contratos de API
+
+```typescript
+// POST /api/v1/recurso
+interface CreateRecursoRequest {
+  campo1: string;
+  campo2: number;
+}
+
+interface CreateRecursoResponse {
+  id: string;
+  campo1: string;
+  campo2: number;
+  createdAt: string;
+}
+```
+
+## Flujo de Datos
+
+### Secuencia Principal
+
+```
+Usuario → Frontend → API → Service → Repository → Database
+                              ↓
+                         Validación
+                              ↓
+                      Lógica de Negocio
+```
+
+### Casos de Error
+
+| Código | Escenario | Respuesta |
+|--------|-----------|-----------|
+| 400 | Validación fallida | `{ error: "Campo X inválido" }` |
+| 404 | Recurso no encontrado | `{ error: "No encontrado" }` |
+| 500 | Error interno | `{ error: "Error del servidor" }` |
+
+## Seguridad
+
+### Autenticación/Autorización
+- Método de autenticación requerido
+- Roles con acceso: admin, user, etc.
+
+### Validación de Inputs
+- Campo1: string, max 255 chars, sanitizado
+- Campo2: number, min 0, max 1000
+
+### Consideraciones de Seguridad
+- [ ] CSRF protection
+- [ ] Rate limiting
+- [ ] Input sanitization
+- [ ] SQL injection prevention
+
+## Performance
+
+### Estimaciones de Carga
+- Requests esperados: X/segundo
+- Tamaño de datos: X registros
+
+### Optimizaciones
+- Índices de base de datos necesarios
+- Caché strategy
+- Paginación
+
+## Testing Strategy
+
+### Unit Tests
+- [ ] Service layer: lógica de negocio
+- [ ] Validators: validación de inputs
+- [ ] Utils: funciones auxiliares
+
+### Integration Tests
+- [ ] API endpoints
+- [ ] Database operations
+
+### E2E Tests (si aplica)
+- [ ] Flujo principal del usuario
+
+## Plan de Rollback
+
+### Pasos para Revertir
+1. Revertir código (git revert)
+2. Revertir migración de BD
+3. Limpiar caché
+
+### Datos a Preservar
+- Qué datos no se pueden perder
+- Estrategia de backup
+
+## Decisiones Técnicas (ADR)
+
+### ADR-001: Elección de X sobre Y
+
+**Contexto:** Necesitamos decidir entre X e Y para...
+
+**Decisión:** Elegimos X porque...
+
+**Consecuencias:**
+- Positivo: ...
+- Negativo: ...
+
+## Referencias
+
+- Propuesta: `proposal.md`
+- Spec principal: `openspec/specs/domain/spec.md`
+- Delta specs: `specs/domain/spec.md`
+- Documentación externa: links

package/openspec/templates/proposal.md

@@ -0,0 +1,79 @@
+# [CHANGE-XXX] Propuesta: Título del Cambio
+
+| Campo | Valor |
+|-------|-------|
+| ID | CHANGE-XXX |
+| Fecha | YYYY-MM-DD |
+| Estado | draft / review / approved / rejected |
+| Autor | nombre |
+| Prioridad | critical / high / medium / low |
+| Ticket | TICKET-XXX |
+
+## Resumen Ejecutivo
+
+Descripción breve (2-3 oraciones) de qué se propone y por qué.
+
+## Contexto y Problema
+
+### Situación Actual
+Descripción del estado actual y por qué necesita cambiar.
+
+### Problema a Resolver
+- Problema 1
+- Problema 2
+
+### Impacto si No se Resuelve
+Qué pasa si no hacemos nada.
+
+## Propuesta de Solución
+
+### Descripción General
+Qué se va a hacer a alto nivel.
+
+### User Stories Afectadas
+
+#### US-01: Como [rol], quiero [acción] para [beneficio]
+- Criterios de aceptación:
+  - [ ] CA-01: ...
+  - [ ] CA-02: ...
+
+## Alcance
+
+### Incluido
+- Funcionalidad A
+- Funcionalidad B
+
+### Excluido (fuera de alcance)
+- Funcionalidad X (se hará en otra propuesta)
+- Funcionalidad Y (no es necesaria)
+
+## Riesgos y Mitigaciones
+
+| Riesgo | Probabilidad | Impacto | Mitigación |
+|--------|--------------|---------|------------|
+| Riesgo 1 | Alta/Media/Baja | Alto/Medio/Bajo | Cómo mitigar |
+
+## Dependencias
+
+- [ ] Depende de CHANGE-XXX (descripción)
+- [ ] Depende de integración externa X
+
+## Estimación Inicial
+
+| Concepto | Estimación |
+|----------|------------|
+| Esfuerzo | S / M / L / XL |
+| Tiempo | X días/semanas |
+| Complejidad | Baja / Media / Alta |
+
+## Decisión
+
+- [ ] **Aprobada** — Fecha: YYYY-MM-DD
+- [ ] **Rechazada** — Motivo: ...
+- [ ] **Pendiente de revisión**
+
+## Referencias
+
+- Spec relacionada: `openspec/specs/domain/spec.md`
+- Documentación: link
+- Diseño: `openspec/changes/CHANGE-XXX/design.md`

package/openspec/templates/tasks.md

@@ -0,0 +1,193 @@
+# [CHANGE-XXX] Tareas: Título del Cambio
+
+| Campo | Valor |
+|-------|-------|
+| ID | CHANGE-XXX |
+| Propuesta | `proposal.md` |
+| Diseño | `design.md` |
+| Fecha | YYYY-MM-DD |
+| Sprint | Sprint X |
+
+## Resumen
+
+Total de tareas: X  
+Estimación total: X story points  
+Ticket Epic: [proyecto]-XXX
+
+## Tareas
+
+### 🏗️ Setup & Scaffolding
+
+#### TASK-001: Crear estructura base
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 1 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente / 🔄 En progreso / ✅ Completada
+- **Branch:** `feat/TICKET-XXX-estructura-base`
+
+**Subtareas:**
+- [ ] Crear carpeta de feature
+- [ ] Configurar rutas
+- [ ] Crear archivos base
+
+**Criterios de aceptación:**
+- [ ] Estructura creada según design.md
+- [ ] Rutas registradas
+- [ ] Tests de humo pasan
+
+---
+
+### 📊 Backend / API
+
+#### TASK-002: Implementar modelo de datos
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 2 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente
+- **Branch:** `feat/TICKET-XXX-modelo-datos`
+
+**Subtareas:**
+- [ ] Crear entidades/modelos
+- [ ] Crear migraciones
+- [ ] Crear seeders (si aplica)
+
+**Criterios de aceptación:**
+- [ ] Migraciones ejecutan sin error
+- [ ] Modelo tiene validaciones según spec
+- [ ] Tests unitarios del modelo
+
+---
+
+#### TASK-003: Implementar endpoints API
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 3 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente
+- **Branch:** `feat/TICKET-XXX-api-endpoints`
+
+**Subtareas:**
+- [ ] POST /api/recurso
+- [ ] GET /api/recurso/:id
+- [ ] PUT /api/recurso/:id
+- [ ] DELETE /api/recurso/:id
+
+**Criterios de aceptación:**
+- [ ] Endpoints responden según contrato en design.md
+- [ ] Validación de inputs
+- [ ] Manejo de errores
+- [ ] Tests de integración
+
+---
+
+### 🎨 Frontend / UI
+
+#### TASK-004: Implementar componentes UI
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 3 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente
+- **Branch:** `feat/TICKET-XXX-ui-components`
+
+**Subtareas:**
+- [ ] Componente de lista
+- [ ] Componente de formulario
+- [ ] Componente de detalle
+
+**Criterios de aceptación:**
+- [ ] Componentes renderizan correctamente
+- [ ] Responsive design
+- [ ] Accesibilidad WCAG 2.1
+- [ ] Tests de comportamiento
+
+---
+
+### 🧪 Testing
+
+#### TASK-005: Tests unitarios
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 2 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente
+- **Branch:** `feat/TICKET-XXX-unit-tests`
+
+**Cobertura requerida:**
+- [ ] Lógica de negocio: 80%+
+- [ ] Validadores: 90%+
+- [ ] Utils: 90%+
+
+---
+
+#### TASK-006: Tests de integración
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 2 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente
+- **Branch:** `feat/TICKET-XXX-integration-tests`
+
+**Escenarios:**
+- [ ] Happy path completo
+- [ ] Casos de error
+- [ ] Edge cases
+
+---
+
+### 📚 Documentación
+
+#### TASK-007: Documentación técnica
+- **Ticket:** [proyecto]-XXX
+- **Estimación:** 1 SP
+- **Asignado:** @nombre
+- **Estado:** ⬜ Pendiente
+- **Branch:** `docs/TICKET-XXX-documentacion`
+
+**Subtareas:**
+- [ ] README del módulo
+- [ ] Documentación de API (OpenAPI/Swagger)
+- [ ] Actualizar Wiki técnica
+
+---
+
+## Dependencias entre Tareas
+
+```
+TASK-001 (Setup)
+    ↓
+TASK-002 (Modelo) ───┬──▶ TASK-003 (API)
+                     │         ↓
+                     └──▶ TASK-004 (UI)
+                               ↓
+                     ┌─────────┴─────────┐
+                     ↓                   ↓
+              TASK-005 (Unit)    TASK-006 (Integration)
+                     └─────────┬─────────┘
+                               ↓
+                        TASK-007 (Docs)
+```
+
+## Testing Report
+
+### Pre-merge Checklist
+- [ ] Todos los tests pasan
+- [ ] Cobertura mínima alcanzada
+- [ ] Sin errores de linting
+- [ ] CodeRabbit review aprobado
+- [ ] PR review manual aprobado
+
+### Resultados de Tests
+| Suite | Tests | Passed | Failed | Coverage |
+|-------|-------|--------|--------|----------|
+| Unit | X | X | 0 | XX% |
+| Integration | X | X | 0 | N/A |
+| E2E | X | X | 0 | N/A |
+
+### CodeRabbit Report
+- **PR:** #XXX
+- **Status:** ✅ Aprobado / ❌ Cambios requeridos
+- **Issues encontrados:** X
+- **Issues resueltos:** X
+
+## Notas
+
+- Notas adicionales sobre la implementación
+- Decisiones tomadas durante el desarrollo
+- Problemas encontrados y soluciones

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specleap-framework",
-  "version": "2.1.0",
+  "version": "2.1.5",
   "description": "Spec-Driven Development Framework — Transform VSCode, Cursor, JetBrains into spec-first development machines",
   "keywords": [
     "spec-driven-development",
@@ -20,15 +20,16 @@
   "homepage": "https://specleap.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/iapanderson/specleap-framework.git"
+    "url": "https://github.com/ConceptualCreative/specleap-framework.git"
   },
   "bugs": {
-    "url": "https://github.com/iapanderson/specleap-framework/issues"
+    "url": "https://github.com/ConceptualCreative/specleap-framework/issues"
   },
   "license": "MIT",
   "author": {
-    "name": "SpecLeap Community",
-    "url": "https://specleap.com"
+    "name": "Styng Arias",
+    "email": "developers@conceptualcreative.com",
+    "url": "https://conceptualcreative.com"
   },
   "bin": "bin/specleap",
   "scripts": {
@@ -49,12 +50,16 @@
     ".continuerules",
     ".cursorrules",
     ".github/**",
+    ".specleap/i18n/**",
+    ".specleap/i18n.sh",
     ".vscode/**",
     "bin/**",
+    "openspec/**",
     "rules/**",
     "scripts/**",
     "setup.sh",
     "install.sh",
+    "CHANGELOG.md",
     "CLAUDE.md",
     "README.md",
     "SETUP.md",

package/rules/git-workflow.md

@@ -62,9 +62,9 @@ tipo/TICKET-ID-descripcion-corta
 
 **Ejemplos:**
 ```
-feature/SCRUM-23-integracion-jira
-fix/SCRUM-45-error-login-timeout
-refactor/SCRUM-12-optimizar-queries
+feature/app-tienda-23-integracion-tracker
+fix/app-tienda-45-error-login-timeout
+refactor/app-tienda-12-optimizar-queries
 ```
 
 ### 5. Formato de Commits

package/rules/session-protocol.md

@@ -39,7 +39,7 @@ Si hay trabajo en progreso sin commit → preguntar antes de continuar.
 ### Paso 4: Verificar Ticket
 
 ```
-¿Hay un ticket en Jira asociado a esta tarea?
+¿Hay un ticket en Asana asociado a esta tarea?
 ```
 
 - **Sí** → Usar el ID del ticket (SCRUM-XX) en rama y commits
@@ -82,7 +82,7 @@ Dejar nota clara de:
 ## Flujo Completo de Feature
 
 ```
-1. TICKET (Jira)
+1. TICKET (Asana)
    └── Crear/asignar ticket SCRUM-XX
 
 2. SPEC (SpecLeap)
@@ -113,7 +113,7 @@ Dejar nota clara de:
 8. POST-DESARROLLO
    ├── Actualizar context/ si hubo decisiones
    ├── Actualizar spec si cambió
-   └── Cerrar ticket en Jira
+   └── Cerrar ticket en Asana
 ```
 
 ---

package/scripts/README.md

@@ -41,40 +41,28 @@ git commit --no-verify -m "mensaje"
 
 ---
 
-### `setup-mcp.sh`
-
-**Propósito:** Instalación rápida de dependencias SpecLeap
-
-**Uso:**
-```bash
-bash scripts/setup-mcp.sh
-```
-
-**Instala:**
-- ✅ Cliente Asana (npm global)
-- ✅ 20 Agent Skills TIER 1
-- ✅ Context7 MCP (opcional)
-
-**Tiempo:** ~5 minutos
-
----
-
 ### `install-skills.sh`
 
-**Propósito:** Instalar Agent Skills manualmente
+**Propósito:** Instalar los 34 Agent Skills del framework en `~/.skills/`.
 
 **Uso:**
 ```bash
 bash scripts/install-skills.sh
 ```
 
-**Instala:** 20 Agent Skills TIER 1 en `~/.skills/`
+**Instala:** 34 skills (20 TIER 1 + 14 TIER 2).
+
+**Categorías:**
+- Consistencia: `verification-before-completion`, `systematic-debugging`, `requesting-code-review`, `receiving-code-review`, `code-reviewer`, `debugging-wizard`
+- Backend: `laravel-specialist`, `api-designer`, `database-optimizer`, `python-pro`, `react-expert`, `typescript-pro`
+- Diseño y frontend: `frontend-design`, `canvas-design`, `algorithmic-art`, `skill-creator`, `web-design-guidelines`, `vercel-composition-patterns`, `agent-browser`
+- DevOps: `devops-engineer`, `cloud-architect`, `architecture-designer`, `terraform-engineer`, `monitoring-expert`
+- Mobile: `react-native-expert`, `flutter-expert`
+- Testing: `test-driven-development`, `playwright-expert`, `test-master`
+- Seguridad: `security-reviewer`, `gdpr-dsgvo-expert`
+- Documentación y otros: `code-documenter`, `brainstorming`, `pdf`
 
-**Skills incluidas:**
-- 5 skills de seguridad (SAST, STRIDE, OWASP)
-- 3 skills de consistencia (verification-before-completion, DRY)
-- 6 skills de diseño (Vercel-style, Tailwind, shadcn/ui)
-- 6 skills de backend/dev (Laravel, React, TDD, API design)
+El script detecta las skills ya instaladas y las salta. Puede volver a ejecutarse con seguridad.
 
 ---