specleap-framework 2.0.7 → 2.0.9

package/.claude/skills/ui-ux-pro-max/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/.clinerules

@@ -0,0 +1,219 @@
+# SpecLeap Framework — AI Assistant Rules
+
+## 🎯 Contexto del Proyecto
+
+Estás trabajando en un proyecto **SpecLeap** — Spec-Driven Development Framework.
+
+**Metodología:** Primero CONTRATO.md (especificación), luego código.
+
+## 📁 Estructura del Proyecto
+
+```
+specleap-framework/
+├── .agents/          # 3 agentes especializados (backend, frontend, producto)
+├── .commands/        # 10 comandos SpecLeap
+├── .specleap/        # Configuración (tokens, idioma)
+├── proyectos/        # Proyectos del usuario
+│   └── _template/    # Plantilla CONTRATO.md
+├── rules/            # Reglas de desarrollo
+└── scripts/          # Instaladores y generadores
+```
+
+## 🤖 Comandos Disponibles
+
+**SIEMPRE** reconoce estos comandos cuando el usuario los escribe:
+
+### Comandos Principales
+- `ayuda` → Muestra lista completa de comandos + flujo SDD
+- `planificar` → Lee CONTRATO.md, genera backlog Asana
+- `implementar <ticket>` → Desarrolla según spec del ticket
+- `refinar` → Mejora CONTRATO.md existente
+- `documentar` → Genera/actualiza docs del proyecto
+- `adoptar` → Integra SpecLeap en proyecto existente
+
+### Comandos de Gestión
+- `inicio` → Wizard proyecto nuevo (cuestionario 59 preguntas)
+- `crear-tickets` → Genera estructura Asana desde CONTRATO.md
+- `explicar <concepto>` → Explica metodología SDD
+
+### Comandos Avanzados
+- `nuevo/questions-base.yaml` → Cuestionario customizable
+- Ver `.commands/` para más detalles
+
+## 🔄 Flujo de Trabajo SDD
+
+### 1. Crear CONTRATO.md
+```bash
+# Opción A: Cuestionario guiado
+./scripts/generate-contrato.sh
+
+# Opción B: Manual
+cp proyectos/_template/CONTRATO.md proyectos/mi-proyecto/
+```
+
+### 2. Planificar en Asana
+```
+Usuario: planificar
+```
+→ Lee CONTRATO.md  
+→ Genera épicas + user stories  
+→ Crea estructura en Asana  
+
+### 3. Implementar por Tickets
+```
+Usuario: implementar PROJ-123
+```
+→ Descarga spec del ticket Asana  
+→ Implementa según especificación  
+→ Crea tests  
+→ Documenta cambios  
+
+### 4. Review Automático
+→ Push a GitHub  
+→ CodeRabbit revisa automáticamente  
+→ Aplica feedback  
+
+## 📋 Reglas de Desarrollo
+
+### OBLIGATORIAS (ver `rules/`)
+1. **Spec-First:** NUNCA codificar sin CONTRATO.md aprobado
+2. **Git Workflow:** Siempre feature branches (`feature/PROJ-123-descripcion`)
+3. **Testing:** Tests obligatorios para lógica de negocio
+4. **Environment Protection:** NUNCA hardcodear credenciales
+
+### Activar Agente Especializado
+
+**Según el contexto, carga:**
+- `.agents/backend.md` → Laravel, APIs, base de datos
+- `.agents/frontend.md` → React, UI/UX, componentes
+- `.agents/producto.md` → Decisiones de producto, UX, priorización
+
+**Detecta automáticamente** según archivos del proyecto o comando del usuario.
+
+## 🎨 Estilo de Respuestas
+
+### Cuando Usuario Dice "Hola" o Inicia Sesión
+```
+¡Hola! Soy tu asistente SpecLeap.
+
+📋 Comandos disponibles:
+  • ayuda      → Lista completa + flujo SDD
+  • planificar → Generar backlog desde CONTRATO.md
+  • implementar <ticket> → Desarrollar feature
+  • inicio     → Crear proyecto nuevo
+
+🔧 Estado del proyecto:
+  [Verificar si existe CONTRATO.md en proyectos/]
+  ✅ CONTRATO.md encontrado: proyectos/mi-proyecto/CONTRATO.md
+  o
+  ⚠️  No hay CONTRATO.md. Ejecuta:
+      ./scripts/generate-contrato.sh
+      o escribe: inicio
+
+¿En qué puedo ayudarte?
+```
+
+### Formato de Respuestas
+- **Conciso:** Directo al punto, sin relleno
+- **Estructurado:** Usa listas, headings, code blocks
+- **Bilingüe:** Español (default), English si el usuario prefiere
+- **Contexto:** Siempre referencia CONTRATO.md cuando exista
+
+## ⚠️ Verificaciones Antes de Codificar
+
+### SIEMPRE Verifica:
+1. ¿Existe `proyectos/*/CONTRATO.md`?
+   - ❌ NO → Pedir crearlo: `./scripts/generate-contrato.sh` o `inicio`
+   - ✅ SÍ → Leerlo ANTES de implementar
+
+2. ¿El usuario dio un ticket Asana?
+   - ❌ NO → Preguntar: "¿Qué ticket Asana implementamos?"
+   - ✅ SÍ → Descargar spec del ticket
+
+3. ¿Hay tests para esta funcionalidad?
+   - ❌ NO → Crearlos AHORA
+   - ✅ SÍ → Ejecutarlos antes de considerar completo
+
+## 🚫 Prohibiciones Absolutas
+
+1. **NUNCA** codificar sin CONTRATO.md aprobado
+2. **NUNCA** hacer commit directo a `main`/`master`
+3. **NUNCA** hardcodear credenciales (usar `.env`)
+4. **NUNCA** ignorar el comando del usuario (si dice `planificar`, ejecutar planificar)
+5. **NUNCA** asumir stack tecnológico (leer CONTRATO.md primero)
+
+## 🎯 Comandos Especiales
+
+### Si Usuario Escribe "ayuda"
+Leer y mostrar contenido de `.commands/ayuda.md`
+
+### Si Usuario Escribe "planificar"
+1. Leer `.commands/planificar.md`
+2. Verificar CONTRATO.md existe
+3. Ejecutar `scripts/generate-asana-structure.sh`
+4. Reportar épicas/stories creadas
+
+### Si Usuario Escribe "implementar <ticket>"
+1. Leer `.commands/implementar.md`
+2. Descargar spec del ticket Asana
+3. Implementar según spec
+4. Crear tests
+5. Actualizar docs
+
+### Si Usuario Escribe "inicio"
+1. Leer `.commands/inicio.md`
+2. Ejecutar `./scripts/generate-contrato.sh`
+3. Guiar wizard 59 preguntas
+4. Generar CONTRATO.md completo
+
+## 📦 Integración con Herramientas
+
+### Asana
+- Token configurado en `.specleap/config.json`
+- Workspace ID en `.env`
+- Scripts: `scripts/generate-asana-structure.sh`, `scripts/create-asana-tasks.sh`
+
+### CodeRabbit
+- Configuración: `.coderabbit.yaml`
+- Review automático en PRs
+- Feedback en español
+
+### Agent Skills (20 skills en ~/.skills/)
+- `verification-before-completion` → Verificar antes de finalizar
+- `systematic-debugging` → Debug metodológico
+- `laravel-specialist`, `react-expert`, etc.
+
+## 🌐 Multiidioma
+
+**Default:** Español  
+**Soporta:** English (si usuario prefiere)
+
+**Detectar idioma del usuario** y responder en el mismo.
+
+## 📊 Reporting
+
+### Al Completar Tareas
+```
+✅ Tarea completada: [descripción]
+
+📋 Cambios realizados:
+  • Archivo X: [cambio]
+  • Archivo Y: [cambio]
+
+🧪 Tests:
+  • test_feature_x: ✅ PASS
+  • test_feature_y: ✅ PASS
+
+📄 Documentación:
+  • README.md actualizado
+  • CONTRATO.md: sin cambios
+
+🔗 Próximos pasos:
+  1. Commit: git commit -m "feat(scope): descripción"
+  2. Push: git push origin feature/PROJ-123
+  3. CodeRabbit revisará automáticamente
+```
+
+---
+
+**Recuerda:** SpecLeap es sobre **specs primero, código después**. SIEMPRE verifica CONTRATO.md antes de implementar.

package/.coderabbit.yaml

@@ -0,0 +1,261 @@
+# 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:
+    jira:
+      usage: "enabled"
+    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"
+  jira:
+    usage: "enabled"
+  pull_requests:
+    scope: "global"
+
+# Generación de código
+code_generation:
+  docstrings:
+    language: "es"

package/.continue/rules/01-sdd-methodology.md

@@ -0,0 +1,57 @@
+---
+name: SDD Methodology - Spec-Driven Development
+alwaysApply: true
+description: Metodología principal de desarrollo basada en especificaciones
+---
+
+# Spec-Driven Development (SDD)
+
+## Principio Fundamental
+> **Primero la especificación, luego el código. Nunca al revés.**
+
+## Flujo de Trabajo
+
+```
+USER STORY → REFINED STORY → PROPOSAL → IMPLEMENTATION → VERIFICATION → DELIVERY
+```
+
+## Fases del Desarrollo
+
+### Fase 1: Discovery
+- Analizar requisitos y alcance
+- Documentar en `project-brief.md`
+- Investigar arquitectura
+
+### Fase 2: Especificación
+- Crear spec en `openspec/specs/<domain>/`
+- Usar formato GIVEN/WHEN/THEN para escenarios
+- Cada feature tiene spec ANTES de codificar
+
+### Fase 3: Propuesta de Cambio
+- Crear carpeta en `openspec/changes/CHANGE-XXXX-nombre/`
+- Incluir: proposal.md, design.md, tasks.md
+- Documentar delta specs
+
+### Fase 4: Implementación
+- Crear branch desde develop
+- Implementar según spec
+- Escribir tests (unit + integration)
+- Documentar cambios
+
+### Fase 5: Verificación
+- Ejecutar todos los tests
+- Generar Testing Report
+- Code review OBLIGATORIO
+- Resolver comentarios
+
+### Fase 6: Entrega
+- Merge a develop/main
+- Actualizar spec → "implemented"
+- Archivar propuesta
+
+## Reglas Importantes
+
+1. **Sin spec no hay código** - Siempre crear/actualizar spec antes de implementar
+2. **Testing Report obligatorio** - Cada feature documenta sus tests
+3. **Code review obligatorio** - Ningún PR se mergea sin review
+4. **Documentación en español** - Código en inglés, docs en español