specleap-framework 2.1.0 → 2.1.5

package/openspec/examples/README.md

@@ -0,0 +1,334 @@
+# OpenSpec — Ejemplos Completos
+
+Ejemplos end-to-end del workflow completo de SpecLeap.
+
+## 📚 Ejemplos Disponibles
+
+### CHANGE-SAMPLE-001: Autenticación de Usuario
+
+**Categoría:** Backend / Security  
+**Stack:** PHP (Laravel) / JWT  
+**Complejidad:** Alta  
+**Estado:** Completado
+
+Sistema completo de autenticación con email y contraseña, tokens JWT, rate limiting, y protección contra brute force.
+
+**Qué demuestra:**
+- ✅ Workflow completo (enrich → new → ff → apply → verify → code-review → archive)
+- ✅ User story refinada con AI
+- ✅ Propuesta completa (proposal + design + tasks)
+- ✅ Delta specs (functional + technical)
+- ✅ Testing Report real (60 tests, 91% coverage)
+- ✅ CodeRabbit integration
+- ✅ ADRs (Architecture Decision Records)
+
+**Ver:** [CHANGE-SAMPLE-001-user-authentication/README.md](./CHANGE-SAMPLE-001-user-authentication/README.md)
+
+---
+
+## 🎯 Cómo Usar los Ejemplos
+
+### 1. Aprender el Flujo
+
+Navega los ejemplos en orden de archivos:
+
+```
+00-original-user-story.md     # INPUT inicial
+    ↓
+01-refined-user-story.md      # Refinada con AI (/enrich)
+    ↓
+proposal.md                   # QUÉ y POR QUÉ (/new)
+design.md                     # CÓMO técnico (/ff)
+tasks.md                      # Tareas + Testing Report
+    ↓
+specs/                        # Delta specs aplicados
+    ↓
+COMPLETION_REPORT.md          # Reporte final (/archive)
+```
+
+### 2. Adaptar a Tu Proyecto
+
+```bash
+# Copiar estructura a tu proyecto
+cp -r openspec/examples/CHANGE-SAMPLE-001-* openspec/changes/CHANGE-001-mi-feature/
+
+# Editar archivos con tu contexto
+# - Reemplazar stack (Laravel → tu framework)
+# - Ajustar arquitectura
+# - Adaptar testing strategy
+
+# Ejecutar workflow completo
+openspec verify CHANGE-001
+openspec code-review CHANGE-001 --create-pr
+```
+
+### 3. Crear Tu Propio Ejemplo
+
+```bash
+# Empezar desde cero
+openspec new --auto "Mi Feature" --ticket [proyecto]-XXX
+openspec ff CHANGE-XXX
+# ... editar manualmente ...
+openspec apply CHANGE-XXX
+```
+
+---
+
+## 📖 Guías por Tipo de Proyecto
+
+### Backend API
+
+**Ejemplo:** CHANGE-SAMPLE-001 (Autenticación)
+
+**Incluye:**
+- Endpoints API (REST)
+- Modelo de datos
+- Validación de inputs
+- Seguridad (autenticación, autorización)
+- Testing (unit + integration)
+
+**Comandos clave:**
+```bash
+openspec enrich "API para gestionar usuarios"
+openspec new --auto "CRUD de usuarios" --priority high
+openspec ff CHANGE-XXX
+```
+
+### Frontend Component
+
+**Ejemplo:** (próximamente)
+
+**Incluiría:**
+- Componentes UI
+- State management
+- API integration
+- Testing (unit + e2e)
+
+### Microservicio
+
+**Ejemplo:** (próximamente)
+
+**Incluiría:**
+- Service architecture
+- Message queue integration
+- Service discovery
+- Distributed tracing
+
+### Database Migration
+
+**Ejemplo:** (próximamente)
+
+**Incluiría:**
+- Schema changes
+- Data migration
+- Rollback plan
+- Performance impact
+
+---
+
+## 🔍 Anatomía de un Ejemplo Completo
+
+### Archivos Requeridos
+
+| Archivo | Propósito | Generado Por |
+|---------|-----------|--------------|
+| `README.md` | Guía del ejemplo | Manual |
+| `00-original-user-story.md` | User story inicial | Manual (usuario) |
+| `01-refined-user-story.md` | User story refinada | `/enrich` (AI) |
+| `proposal.md` | QUÉ y POR QUÉ | `/new` (template) |
+| `design.md` | CÓMO técnico | `/ff` (AI) o manual |
+| `tasks.md` | Tareas + Testing Report | `/ff` (AI) o manual |
+| `specs/` | Delta specs | Manual |
+| `COMPLETION_REPORT.md` | Reporte final | `/archive` |
+
+### Archivos Opcionales
+
+| Archivo | Propósito |
+|---------|-----------|
+| `diagrams/` | Diagramas de arquitectura (PNG, SVG) |
+| `migrations/` | Scripts SQL de ejemplo |
+| `code-samples/` | Snippets de código implementado |
+| `screenshots/` | Capturas de UI (si aplica) |
+
+---
+
+## 💡 Mejores Prácticas
+
+### 1. User Stories Refinadas
+
+❌ **Mal:**
+```
+Como usuario quiero login
+```
+
+✅ **Bien:**
+```
+Como usuario registrado del sistema,
+quiero autenticarme con email y contraseña
+para acceder de forma segura a mi cuenta y funcionalidades personalizadas.
+
+GIVEN un usuario registrado
+WHEN ingresa credenciales correctas
+THEN accede al dashboard
+AND recibe token JWT válido por 24h
+```
+
+### 2. Propuestas Completas
+
+Incluir siempre:
+- ✅ Resumen ejecutivo (2-3 oraciones)
+- ✅ Contexto y problema a resolver
+- ✅ Propuesta de solución
+- ✅ Alcance (incluido + excluido)
+- ✅ Riesgos y mitigaciones
+- ✅ Estimación inicial
+
+### 3. Diseño Técnico Detallado
+
+Incluir siempre:
+- ✅ Diagrama de componentes (ASCII o imagen)
+- ✅ Modelo de datos (DDL o diagrama ER)
+- ✅ API contracts (request/response examples)
+- ✅ ADRs (decisiones técnicas justificadas)
+- ✅ Testing strategy (unit, integration, e2e)
+- ✅ Plan de rollback
+
+### 4. Tareas Desglosadas
+
+Cada tarea debe tener:
+- ✅ ID único (TASK-001, TASK-002, ...)
+- ✅ Estimación (story points)
+- ✅ Criterios de aceptación claros
+- ✅ Dependencias explícitas
+- ✅ Branch name sugerido
+
+### 5. Delta Specs Claros
+
+Usar notación de cambios:
+```markdown
+## Escenario X: Login exitoso
+
+- GIVEN un usuario registrado
+- WHEN ingresa credenciales válidas
++ AND el sistema verifica 2FA (NUEVO)
+- THEN genera token JWT
+~ AND redirige al dashboard (MODIFICADO: añadir analytics)
+```
+
+---
+
+## 🧪 Validación de Ejemplos
+
+Antes de publicar un ejemplo, verificar:
+
+### Checklist de Calidad
+
+- [ ] README.md completo con guía de uso
+- [ ] User story original → refinada incluida
+- [ ] Proposal + design + tasks completos
+- [ ] Delta specs con formato correcto
+- [ ] Testing Report con datos reales (no template vacío)
+- [ ] Sin placeholders ("TODO", "XXX", "...")
+- [ ] Archivos markdown válidos (sin errores de formato)
+- [ ] Comandos CLI documentados y probados
+- [ ] Referencias a specs source of truth correctas
+
+### Test del Ciclo Completo
+
+```bash
+# 1. Verificar que los comandos funcionan
+cd openspec/examples/CHANGE-SAMPLE-XXX/
+openspec verify CHANGE-SAMPLE-XXX --dry-run
+
+# 2. Validar YAML
+yq eval ../config.yaml > /dev/null
+
+# 3. Validar markdown
+markdownlint *.md
+
+# 4. Verificar links
+markdown-link-check README.md
+```
+
+---
+
+## 🚀 Contribuir Ejemplos
+
+¿Quieres añadir un ejemplo nuevo?
+
+### 1. Estructura
+
+```bash
+# Crear directorio
+mkdir -p openspec/examples/CHANGE-SAMPLE-XXX-nombre/
+
+# Crear archivos base
+touch README.md
+touch 00-original-user-story.md
+# ... etc
+```
+
+### 2. Contenido
+
+Usar CHANGE-SAMPLE-001 como plantilla:
+- Copiar estructura de archivos
+- Adaptar contenido a tu caso de uso
+- Mantener mismo nivel de detalle
+
+### 3. Validación
+
+```bash
+# Ejecutar checklist de calidad
+./scripts/validate-example.sh CHANGE-SAMPLE-XXX
+
+# Revisar con AI
+openspec verify CHANGE-SAMPLE-XXX
+```
+
+### 4. Pull Request
+
+- Título: `docs: Añadir ejemplo CHANGE-SAMPLE-XXX (descripción)`
+- Descripción:
+  - Qué demuestra el ejemplo
+  - Stack/tecnologías usadas
+  - Comandos CLI cubiertos
+  - Lecciones aprendidas
+
+---
+
+## 📊 Índice de Ejemplos por Categoría
+
+### Backend
+- ✅ CHANGE-SAMPLE-001: Autenticación JWT
+- 🔜 CHANGE-SAMPLE-002: CRUD con validación
+- 🔜 CHANGE-SAMPLE-003: API con paginación
+
+### Frontend
+- 🔜 CHANGE-SAMPLE-010: Componente de formulario
+- 🔜 CHANGE-SAMPLE-011: State management con Redux
+
+### DevOps
+- 🔜 CHANGE-SAMPLE-020: CI/CD pipeline
+- 🔜 CHANGE-SAMPLE-021: Docker compose setup
+
+### Seguridad
+- ✅ CHANGE-SAMPLE-001: Autenticación (incluye rate limiting)
+- 🔜 CHANGE-SAMPLE-030: 2FA implementation
+
+### Performance
+- 🔜 CHANGE-SAMPLE-040: Caché con Redis
+- 🔜 CHANGE-SAMPLE-041: Query optimization
+
+---
+
+## 🔗 Referencias
+
+- [OpenSpec CLI](../cli/README.md)
+- [Metodología SDD](../../.continue/rules/01-sdd-methodology.md)
+- [Templates](../templates/)
+- [Config Reference](../config.yaml)
+
+---
+
+**Última actualización:** 2026-02-12  
+**Ejemplos totales:** 1 (más en desarrollo)

package/openspec/templates/.coderabbit.yaml

@@ -0,0 +1,259 @@
+# CodeRabbit Configuration — DevFlow Pro
+# Copiar este archivo a la raíz de cada repositorio
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
+
+# Idioma de los reviews
+language: "es"
+
+# Tono personalizado
+tone_instructions: |
+  Eres un reviewer senior enfocado en calidad y mantenibilidad.
+  Sé constructivo pero riguroso. Señala problemas de seguridad como críticos.
+  Verifica que el código sigue las specs definidas en openspec/.
+  Idioma: español.
+
+# Configuración de reviews
+reviews:
+  # Perfil: assertive = más feedback (recomendado para equipos que buscan calidad)
+  profile: "assertive"
+  
+  # Workflow de cambios solicitados
+  request_changes_workflow: true
+  
+  # Resumen de alto nivel
+  high_level_summary: true
+  high_level_summary_in_walkthrough: true
+  
+  # Diagramas de secuencia
+  sequence_diagrams: true
+  
+  # Estimación de esfuerzo de review
+  estimate_code_review_effort: true
+  
+  # Evaluar issues vinculados
+  assess_linked_issues: true
+  
+  # Sugerir labels
+  suggested_labels: true
+  labeling_instructions:
+    - label: "needs-spec"
+      instructions: "Aplicar cuando el PR no tiene spec de referencia en openspec/"
+    - label: "has-tests"
+      instructions: "Aplicar cuando el PR incluye tests"
+    - label: "breaking-change"
+      instructions: "Aplicar cuando hay cambios que rompen compatibilidad"
+    - label: "security"
+      instructions: "Aplicar cuando hay cambios relacionados con seguridad"
+    - label: "performance"
+      instructions: "Aplicar cuando hay optimizaciones de rendimiento"
+  
+  # Auto-aplicar labels sugeridos
+  auto_apply_labels: true
+  
+  # Sugerir reviewers
+  suggested_reviewers: true
+  
+  # Sin poemas ni fortunes (profesional)
+  poem: false
+  in_progress_fortune: false
+  
+  # Path filters - excluir archivos generados
+  path_filters:
+    - "!**/node_modules/**"
+    - "!**/vendor/**"
+    - "!**/dist/**"
+    - "!**/build/**"
+    - "!**/*.min.js"
+    - "!**/*.min.css"
+    - "!**/package-lock.json"
+    - "!**/composer.lock"
+    - "!**/*.generated.*"
+  
+  # Instrucciones por ruta
+  path_instructions:
+    - path: "src/**"
+      instructions: |
+        Verificar:
+        - TypeScript strict mode
+        - Manejo de errores
+        - Tipos correctos (no any)
+        - Comentarios en español
+    
+    - path: "**/*.spec.ts"
+      instructions: |
+        Verificar:
+        - Cobertura de casos edge
+        - Nombres descriptivos en español
+        - Arrange-Act-Assert pattern
+    
+    - path: "**/*.test.ts"
+      instructions: |
+        Verificar:
+        - Cobertura de casos edge
+        - Nombres descriptivos en español
+        - Arrange-Act-Assert pattern
+    
+    - path: "openspec/**"
+      instructions: |
+        Verificar:
+        - Formato correcto de spec
+        - GIVEN/WHEN/THEN completos
+        - Criterios de aceptación claros
+        - Referencias cruzadas válidas
+    
+    - path: "**/*.php"
+      instructions: |
+        Verificar:
+        - PSR-12 compliance
+        - Type hints en parámetros y retornos
+        - Validación de inputs
+        - Sin SQL raw (usar Eloquent)
+    
+    - path: "**/migrations/**"
+      instructions: |
+        Verificar:
+        - Migración reversible
+        - Índices necesarios
+        - Sin pérdida de datos
+    
+    - path: "docs/**"
+      instructions: |
+        Verificar:
+        - Español correcto
+        - Enlaces funcionan
+        - Ejemplos actualizados
+  
+  # Auto review
+  auto_review:
+    enabled: true
+    auto_incremental_review: true
+    drafts: false
+    ignore_title_keywords:
+      - "WIP"
+      - "DO NOT MERGE"
+      - "DRAFT"
+    labels:
+      - "!skip-review"
+  
+  # Finishing touches
+  finishing_touches:
+    docstrings:
+      enabled: true
+    unit_tests:
+      enabled: true
+  
+  # Pre-merge checks
+  pre_merge_checks:
+    docstrings:
+      mode: "warning"
+      threshold: 80
+    title:
+      mode: "warning"
+      requirements: |
+        El título debe seguir conventional commits:
+        tipo(alcance): descripción
+        Tipos: feat, fix, refactor, docs, test, chore, style, perf
+    description:
+      mode: "warning"
+    issue_assessment:
+      mode: "warning"
+    custom_checks:
+      - name: "Spec Reference"
+        mode: "warning"
+        instructions: |
+          Verificar que el PR hace referencia a una spec en openspec/.
+          El PR description debe incluir una línea como:
+          Spec: openspec/specs/domain/nombre.spec.md
+          Si no hay spec, el check falla.
+      - name: "Testing Report"
+        mode: "warning"
+        instructions: |
+          Verificar que el PR incluye resultados de tests.
+          Debe haber evidencia de que los tests pasan.
+          Si es un cambio de código, debe haber tests nuevos o modificados.
+
+# Herramientas de análisis
+tools:
+  # JavaScript/TypeScript
+  eslint:
+    enabled: true
+  biome:
+    enabled: true
+  
+  # PHP
+  phpstan:
+    enabled: true
+    level: "max"
+  phpcs:
+    enabled: true
+  phpmd:
+    enabled: true
+  
+  # Python (si aplica)
+  ruff:
+    enabled: true
+  pylint:
+    enabled: true
+  
+  # Seguridad
+  gitleaks:
+    enabled: true
+  semgrep:
+    enabled: true
+  
+  # Markdown/Docs
+  markdownlint:
+    enabled: true
+  languagetool:
+    enabled: true
+    level: "picky"
+  
+  # YAML
+  yamllint:
+    enabled: true
+  
+  # Docker
+  hadolint:
+    enabled: true
+  
+  # GitHub Actions
+  actionlint:
+    enabled: true
+  
+  # Shell
+  shellcheck:
+    enabled: true
+
+# Chat
+chat:
+  auto_reply: true
+  art: false
+  integrations:
+    # Ticket tracker integration — uses TICKET_ID field extracted from proposal.md
+    linear:
+      usage: "disabled"
+
+# Knowledge base
+knowledge_base:
+  opt_out: false
+  web_search:
+    enabled: true
+  code_guidelines:
+    enabled: true
+    filePatterns:
+      - "**/AGENTS.md"
+      - "**/CLAUDE.md"
+      - "**/.cursorrules"
+      - "**/openspec/**/*.md"
+  learnings:
+    scope: "global"
+  issues:
+    scope: "global"
+  # Ticket tracker integration — uses TICKET_ID field extracted from proposal.md
+  pull_requests:
+    scope: "global"
+
+# Generación de código
+code_generation:
+  docstrings:
+    language: "es"