specleap-framework 2.1.0 → 2.1.5

package/SETUP.md

@@ -5,7 +5,7 @@
 ### Paso 1: Clonar el repositorio
 
 ```bash
-git clone https://github.com/iapanderson/specleap-framework.git
+git clone https://github.com/ConceptualCreative/specleap-framework.git
 cd specleap-framework
 ```
 
@@ -170,30 +170,33 @@ git push origin main
 
 ---
 
-### 3. Agent Skills (20 Skills Profesionales)
+### 3. Agent Skills (34 profesionales)
 
-**¿Qué son?** Extensiones para Claude/Cursor que aplican best practices automáticamente.
+Extensiones para Claude/Cursor que aplican best practices automáticamente al contexto de cada tarea.
 
-#### Instalación automática:
+Instalación:
 
 ```bash
-bash scripts/setup-mcp.sh
+bash scripts/install-skills.sh
 ```
 
-**Qué instala:**
-- 🔒 5 skills seguridad (SAST, STRIDE, OWASP)
-- 🔄 3 skills consistencia (verification-before-completion ⭐)
-- 🎨 6 skills diseño (Vercel-style, Tailwind, UI/UX)
-- 🛠️ 6 skills backend/dev (Laravel, React, TDD, API design)
+Se descargan e instalan 34 skills en `~/.skills/` (20 TIER 1 más 14 TIER 2):
 
-**Ver skills instaladas:**
+- **Consistencia (6):** `verification-before-completion`, `systematic-debugging`, `requesting-code-review`, `receiving-code-review`, `code-reviewer`, `debugging-wizard`
+- **Backend (6):** `laravel-specialist`, `api-designer`, `database-optimizer`, `python-pro`, `react-expert`, `typescript-pro`
+- **Diseño y frontend (7):** `frontend-design`, `canvas-design`, `algorithmic-art`, `skill-creator`, `web-design-guidelines`, `vercel-composition-patterns`, `agent-browser`
+- **DevOps (5):** `devops-engineer`, `cloud-architect`, `architecture-designer`, `terraform-engineer`, `monitoring-expert`
+- **Mobile (2):** `react-native-expert`, `flutter-expert`
+- **Testing (3):** `test-driven-development`, `playwright-expert`, `test-master`
+- **Seguridad (2):** `security-reviewer`, `gdpr-dsgvo-expert`
+- **Documentación y otros (3):** `code-documenter`, `brainstorming`, `pdf`
+
+Verificar lo instalado:
 
 ```bash
 ls ~/.skills/
 ```
 
-**Más info:** Ver [docs/SKILLS-REFERENCE.md](docs/SKILLS-REFERENCE.md)
-
 ---
 
 ### 4. Git Hooks (Validación Local Pre-Commit)

package/openspec/INDEX.md

@@ -0,0 +1,53 @@
+# 📋 OpenSpec Index — DevFlow Pro
+
+Índice de todas las especificaciones del sistema.
+
+## Por Estado
+
+### ✅ Implemented
+| ID | Nombre | Proyecto | Prioridad |
+|----|--------|----------|-----------|
+| [SPEC-001](specs/features/SPEC-001-devclaw-panel.spec.md) | DevClaw Panel | devclaw-panel | high |
+
+### 📝 Draft
+| ID | Nombre | Proyecto | Prioridad |
+|----|--------|----------|-----------|
+| - | - | - | - |
+
+### 🔍 Review
+| ID | Nombre | Proyecto | Prioridad |
+|----|--------|----------|-----------|
+| - | - | - | - |
+
+### ✓ Approved
+| ID | Nombre | Proyecto | Prioridad |
+|----|--------|----------|-----------|
+| - | - | - | - |
+
+---
+
+## Por Proyecto
+
+### devclaw-panel
+- [SPEC-001](specs/features/SPEC-001-devclaw-panel.spec.md) — DevClaw Panel ✅
+
+### factulum
+- (pendiente)
+
+### kit-digital
+- (pendiente)
+
+---
+
+## Estadísticas
+
+| Métrica | Valor |
+|---------|-------|
+| Total specs | 1 |
+| Implemented | 1 |
+| In progress | 0 |
+| Pending | 0 |
+
+---
+
+*Última actualización: 2026-02-10*

package/openspec/README.md

@@ -0,0 +1,104 @@
+# OpenSpec — DevFlow Pro
+
+Sistema de especificaciones para Spec-Driven Development (SDD).
+
+## Estructura
+
+```
+openspec/
+├── specs/                      # 📋 Source of Truth
+│   ├── functional/             # Specs funcionales
+│   ├── technical/              # Specs técnicas
+│   ├── integration/            # Specs de integración
+│   └── security/               # Specs de seguridad
+│
+├── changes/                    # 📝 Propuestas de cambios
+│   └── CHANGE-XXXX-nombre/
+│       ├── proposal.md         # QUÉ y POR QUÉ
+│       ├── design.md           # CÓMO (técnico)
+│       ├── tasks.md            # Tareas + Testing Report
+│       └── specs/              # Delta specs
+│
+├── templates/                  # 📄 Plantillas
+│   ├── proposal.md
+│   ├── design.md
+│   ├── tasks.md
+│   └── .coderabbit.yaml        # Config para repos
+│
+├── config.yaml                 # ⚙️ Configuración
+└── README.md                   # Este archivo
+```
+
+## Flujo de Trabajo
+
+```
+USER STORY → /enrich → REFINED US → /new + /ff → PROPOSAL ARTIFACTS
+                                                       ↓
+                                                    /apply
+                                                       ↓
+                       BRANCH + TESTS + DOCS + CODE + TESTING REPORT
+                                                       ↓
+                                               /verify + /archive
+                                                       ↓
+                       /commit → FEATURE READY → /code-review → PR → PUBLISHED
+```
+
+## Comandos
+
+| Comando | Acción |
+|---------|--------|
+| `/enrich` | Refinar user story |
+| `/new` | Crear propuesta de cambio |
+| `/ff` | Fast-forward (generar rápido) |
+| `/apply` | Implementar propuesta |
+| `/verify` | Verificar tests y spec |
+| `/code-review` | Review con CodeRabbit (OBLIGATORIO) |
+| `/archive` | Archivar propuesta completada |
+
+## Crear Nueva Propuesta
+
+1. Crear carpeta: `changes/CHANGE-XXXX-nombre/`
+2. Copiar plantillas desde `templates/`
+3. Completar `proposal.md` (qué y por qué)
+4. Completar `design.md` (cómo técnicamente)
+5. Desglosar tareas en `tasks.md`
+6. Si modifica specs existentes, crear delta en `specs/`
+
+## CodeRabbit
+
+CodeRabbit es **obligatorio** para todos los PRs.
+
+### Setup en nuevo repositorio:
+
+```bash
+cp openspec/templates/.coderabbit.yaml .coderabbit.yaml
+```
+
+### Características activadas:
+- Profile: `assertive` (reviews rigurosos)
+- Idioma: español
+- Pre-merge checks: title, spec reference, testing report
+- Request changes workflow: activado
+- Herramientas: ESLint, PHPStan, Gitleaks, Semgrep, etc.
+
+## Testing Report
+
+Cada PR debe incluir en `tasks.md`:
+
+```markdown
+## Testing Report
+
+| Suite | Tests | Passed | Failed | Coverage |
+|-------|-------|--------|--------|----------|
+| Unit | 45 | 45 | 0 | 87% |
+| Integration | 12 | 12 | 0 | N/A |
+
+### CodeRabbit Status
+- ✅ Review aprobado
+```
+
+## Referencias
+
+- Metodología: AGENTS.md
+- Configuración: config.yaml
+- Plantillas: templates/

package/openspec/SPEC-FORMAT.md

@@ -0,0 +1,168 @@
+# OpenSpec — Formato de Especificaciones
+
+## Estructura de Archivos
+
+```
+openspec/
+├── specs/
+│   ├── features/      # Specs de funcionalidades
+│   ├── requirements/  # Requisitos del sistema
+│   └── scenarios/     # Escenarios de uso
+├── SPEC-FORMAT.md     # Este archivo
+└── INDEX.md           # Índice de todas las specs
+```
+
+## Formato de Archivo .spec.md
+
+```markdown
+# [SPEC-ID] Nombre de la Especificación
+
+| Campo | Valor |
+|-------|-------|
+| ID | SPEC-XXX |
+| Versión | 1.0.0 |
+| Estado | draft / review / approved / implemented |
+| Prioridad | critical / high / medium / low |
+| Proyecto | nombre-proyecto |
+| Autor | @usuario |
+| Fecha | YYYY-MM-DD |
+
+## Descripción
+
+Descripción breve de qué hace esta especificación.
+
+---
+
+## Requisitos
+
+### Requirement: Nombre del requisito
+
+- The system SHALL [comportamiento obligatorio].
+- The system SHOULD [comportamiento recomendado].
+- The system MAY [comportamiento opcional].
+
+---
+
+## Escenarios
+
+### Scenario: Nombre del escenario
+
+- GIVEN [precondición]
+- WHEN [acción del usuario]
+- THEN [resultado esperado]
+- AND [resultado adicional]
+
+### Scenario: Otro escenario
+
+- GIVEN [precondición]
+- AND [otra precondición]
+- WHEN [acción]
+- THEN [resultado]
+
+---
+
+## Criterios de Aceptación
+
+- [ ] CA-01: Descripción del criterio
+- [ ] CA-02: Descripción del criterio
+- [ ] CA-03: Descripción del criterio
+
+---
+
+## Dependencias
+
+| Tipo | Spec ID | Descripción |
+|------|---------|-------------|
+| Depende de | SPEC-XXX | Razón |
+| Requerido por | SPEC-YYY | Razón |
+
+---
+
+## Diagramas
+
+### Flujo Principal
+
+```mermaid
+graph TD
+    A[Inicio] --> B{Condición}
+    B -->|Sí| C[Acción 1]
+    B -->|No| D[Acción 2]
+```
+
+### Diagrama de Secuencia (si aplica)
+
+```mermaid
+sequenceDiagram
+    Actor->>System: Acción
+    System-->>Actor: Respuesta
+```
+
+### Modelo de Datos (si aplica)
+
+```mermaid
+erDiagram
+    ENTITY1 ||--o{ ENTITY2 : "relación"
+```
+
+---
+
+## Notas Técnicas
+
+Decisiones de implementación, restricciones, consideraciones.
+
+---
+
+## Historial de Cambios
+
+| Versión | Fecha | Autor | Cambios |
+|---------|-------|-------|---------|
+| 1.0.0 | YYYY-MM-DD | @usuario | Versión inicial |
+```
+
+## Palabras Clave
+
+| Palabra | Significado | Uso |
+|---------|-------------|-----|
+| **SHALL** | Obligatorio | Requisito que DEBE cumplirse |
+| **SHOULD** | Recomendado | Requisito que DEBERÍA cumplirse |
+| **MAY** | Opcional | Requisito que PUEDE cumplirse |
+| **GIVEN** | Precondición | Estado inicial del escenario |
+| **WHEN** | Acción | Lo que dispara el comportamiento |
+| **THEN** | Resultado | Lo que debe ocurrir |
+| **AND** | Continuación | Añade condiciones/resultados |
+
+## Spec Deltas (Cambios)
+
+Los cambios en specs se visualizan en Git diffs:
+
+```diff
+### Requirement: Session expiration
+- The system SHALL expire sessions after a configured duration.
++ The system SHALL support configurable session expiration periods.
+
+#### Scenario: Default session timeout
+- GIVEN a user has authenticated
+-- WHEN 24 hours pass without activity
++- WHEN 24 hours pass without "Remember me"
+- THEN invalidate the session token
+
++ #### Scenario: Extended session with remember me
++ - GIVEN user checks "Remember me" at login
++ - WHEN 30 days have passed
++ - THEN invalidate the session token
++ - AND clear the persistent cookie
+```
+
+## Workflow con Git
+
+1. **Crear spec** → Nuevo archivo en `openspec/specs/`
+2. **Revisar spec** → PR con cambios, el diff muestra el delta
+3. **Aprobar spec** → Merge a main, cambiar estado a `approved`
+4. **Implementar** → Desarrollo según spec
+5. **Cerrar** → Estado `implemented` + link al PR de código
+
+## Integración con Ticket Tracker
+
+- Cada spec genera un ticket en el tracker configurado (Asana por defecto en SpecLeap)
+- El ticket incluye link a la spec en el repo
+- Los cambios de spec se comentan en el ticket