specleap-framework 2.0.0

package/.commands/nuevo/README.md

@@ -0,0 +1,292 @@
+# Sistema de Cuestionario Adaptativo — SpecLeap
+
+Este directorio contiene el sistema de preguntas adaptativas para generar CONTRATOs completos y personalizados según el tipo de proyecto.
+
+## 📁 Estructura
+
+```
+.commands/nuevo/
+├── README.md                      ← Este archivo
+├── questions-base.yaml            ← Preguntas obligatorias (todos los proyectos)
+├── questions-ecommerce.yaml       ← Preguntas específicas e-commerce
+├── questions-saas.yaml            ← Preguntas específicas SaaS
+├── questions-api.yaml             ← Preguntas específicas API/Backend
+├── questions-cms.yaml             ← Preguntas específicas CMS/Blog
+├── questions-auth.yaml            ← Preguntas específicas autenticación
+├── questions-admin.yaml           ← Preguntas específicas panel admin
+├── questions-storage.yaml         ← Preguntas específicas almacenamiento
+├── questions-oauth.yaml           ← Preguntas específicas OAuth
+├── questions-aws.yaml             ← Preguntas específicas AWS
+├── responses-example.yaml         ← Ejemplo de archivo de respuestas
+└── responses-schema.json          ← JSON Schema para validación
+```
+
+## 🔄 Flujo de Funcionamiento
+
+### 1. Inicio del Cuestionario
+
+```bash
+# Usuario ejecuta
+/nuevo
+
+# Claude carga questions-base.yaml
+# Realiza 18-20 preguntas obligatorias
+```
+
+### 2. Detección de Tipo de Proyecto
+
+```bash
+# Analiza respuestas con detect-project-type.sh
+./scripts/detect-project-type.sh responses.yaml
+
+# Output: ecommerce auth admin storage
+```
+
+### 3. Carga de Preguntas Condicionales
+
+```bash
+# Según tipos detectados, carga archivos adicionales:
+# - questions-ecommerce.yaml
+# - questions-auth.yaml
+# - questions-admin.yaml
+# - questions-storage.yaml
+
+# Total: 18 base + 30-40 condicionales = 48-58 preguntas
+```
+
+### 4. Generación del CONTRATO
+
+```bash
+# Genera CONTRATO.md con frontmatter YAML
+./scripts/generate-contract.sh responses.yaml
+
+# Output: proyectos/<nombre>/CONTRATO.md
+```
+
+## 📋 Formato questions-*.yaml
+
+```yaml
+version: "1.0"
+category: <nombre>
+description: "Descripción del conjunto de preguntas"
+
+questions:
+  - id: unique_id
+    section: <identity|stack|features|deployment|etc>
+    text: "¿Pregunta?"
+    type: <text|textarea|select|boolean|multiline>
+    required: true|false
+    options:                    # Solo para type=select
+      - value: valor
+        label: "Etiqueta"
+        triggers: [questions-oauth]  # Activa otros archivos
+    follow_up:                  # Pregunta de seguimiento
+      - condition: "valor"
+        question: "¿Pregunta adicional?"
+        type: text
+    depends_on:                 # Solo mostrar si...
+      - other_question_id: [valor1, valor2]
+    validation: "regex"         # Validación opcional
+    help: "Texto de ayuda"
+    default: valor_por_defecto
+```
+
+## 🎯 Tipos de Pregunta
+
+### `text`
+Respuesta corta (1 línea)
+
+```yaml
+- id: project_name
+  type: text
+  validation: "^[a-z0-9-]+$"
+```
+
+### `textarea`
+Respuesta larga (múltiples líneas)
+
+```yaml
+- id: project_objective
+  type: textarea
+```
+
+### `select`
+Opción única de una lista
+
+```yaml
+- id: backend_framework
+  type: select
+  options:
+    - value: laravel
+      label: "Laravel (PHP)"
+    - value: nodejs
+      label: "Node.js"
+```
+
+### `boolean`
+Sí/No
+
+```yaml
+- id: needs_ssl
+  type: boolean
+  default: true
+```
+
+### `multiline`
+Lista de items (uno por línea)
+
+```yaml
+- id: core_features
+  type: multiline
+  help: |
+    Una funcionalidad por línea:
+    - Login de usuarios
+    - CRUD de productos
+```
+
+## 🔍 Detectores de Tipo
+
+El sistema analiza las respuestas en busca de patrones (keywords) para determinar qué preguntas condicionales cargar.
+
+### Patrones Detectados
+
+| Tipo | Keywords | Archivo Cargado |
+|------|----------|-----------------|
+| **E-commerce** | pago, compra, carrito, stripe, paypal, producto | `questions-ecommerce.yaml` |
+| **SaaS** | suscripción, plan, billing, mensualidad, trial | `questions-saas.yaml` |
+| **API** | api, endpoint, rest, graphql, webhook | `questions-api.yaml` |
+| **CMS** | blog, post, artículo, contenido, cms | `questions-cms.yaml` |
+| **Realtime** | chat, mensaje, notificación, websocket | `questions-realtime.yaml` |
+| **Auth** | login, usuario, registro, perfil | `questions-auth.yaml` |
+
+### Configuración en questions-base.yaml
+
+```yaml
+analyzers:
+  detect_project_type:
+    triggers:
+      - keywords: [pago, compra, carrito]
+        activate: questions-ecommerce
+      - keywords: [blog, post, artículo]
+        activate: questions-cms
+```
+
+## 📝 Archivo de Respuestas (responses.yaml)
+
+Las respuestas se guardan en formato YAML plano:
+
+```yaml
+# Respuestas básicas
+project_name: mi-proyecto
+project_objective: Descripción del proyecto
+backend_framework: laravel
+frontend_framework: react
+
+# Listas
+core_features:
+  - Funcionalidad 1
+  - Funcionalidad 2
+
+# Booleanos
+use_typescript: true
+needs_ssl: true
+
+# Opciones
+target_audience: public
+visual_style: modern
+```
+
+## 🏗️ Generación del CONTRATO
+
+El script `generate-contract.sh`:
+
+1. Lee `responses.yaml`
+2. Carga template `proyectos/_template/CONTRATO.md`
+3. Reemplaza placeholders con valores reales
+4. Genera frontmatter YAML con metadata
+5. Crea archivos `context/*.md`
+6. Guarda todo en `proyectos/<nombre>/`
+
+### Frontmatter Generado
+
+```yaml
+---
+project:
+  name: "mi-proyecto"
+  display_name: "Mi Proyecto"
+  created_at: "2026-02-24"
+  status: draft
+  version: "1.0"
+
+stack:
+  backend:
+    framework: "laravel"
+  frontend:
+    framework: "react"
+  database:
+    engine: "postgresql"
+
+features:
+  core: [...]
+  auth:
+    enabled: true
+    methods: [email_password]
+---
+```
+
+## 🧪 Testing
+
+### Probar el Sistema Completo
+
+```bash
+# 1. Analizar respuestas de ejemplo
+cd /path/to/specleap
+./scripts/detect-project-type.sh .commands/nuevo/responses-example.yaml
+
+# Output esperado:
+# ✓ Detectado: Autenticación de usuarios
+# ✓ Detectado: Panel de administración
+# ✓ Detectado: Almacenamiento en la nube
+# ✓ Detectado: Stack PHP/Laravel
+# ✓ Detectado: Frontend React
+
+# 2. Generar CONTRATO
+./scripts/generate-contract.sh .commands/nuevo/responses-example.yaml
+
+# Output esperado:
+# ✅ CONTRATO.md generado exitosamente
+# 📁 Archivos creados:
+#   - proyectos/casa-de-peli/CONTRATO.md
+#   - proyectos/casa-de-peli/context/brief.md
+#   - ...
+```
+
+### Validar CONTRATO Generado
+
+```bash
+# Ver frontmatter
+head -n 100 proyectos/casa-de-peli/CONTRATO.md
+
+# Ver estructura completa
+cat proyectos/casa-de-peli/CONTRATO.md
+```
+
+## 🔧 Próximos Pasos (Fase 2)
+
+- [ ] Crear archivos `questions-*.yaml` para cada tipo
+- [ ] Implementar orquestador `ask-questions.sh`
+- [ ] Integrar con comando `/nuevo` en Claude
+- [ ] Testing con proyecto real
+
+## 🔧 Próximos Pasos (Fase 3)
+
+- [ ] Parser CONTRATO → Jira (`parse-contract-to-jira.sh`)
+- [ ] Integración con `planificar`
+- [ ] Sincronización bidireccional Jira ↔ CONTRATO
+
+## 📚 Referencias
+
+- Template CONTRATO: `proyectos/_template/CONTRATO.md`
+- Script detector: `scripts/detect-project-type.sh`
+- Script generador: `scripts/generate-contract.sh`
+- Ejemplo respuestas: `.commands/nuevo/responses-example.yaml`

package/.commands/nuevo/questions-base.yaml

@@ -0,0 +1,320 @@
+# PREGUNTAS BASE (Obligatorias para todos los proyectos)
+# Estas preguntas determinan el tipo de proyecto y activan preguntas condicionales
+
+version: "1.0"
+category: base
+description: "Preguntas fundamentales que aplican a cualquier tipo de proyecto"
+
+questions:
+  # ===== IDENTIDAD DEL PROYECTO =====
+  - id: project_name
+    section: identity
+    text: "¿Cuál es el nombre del proyecto?"
+    type: text
+    required: true
+    validation: "^[a-z0-9-]+$"
+    help: "Usa formato slug: mi-proyecto-web (solo minúsculas, números y guiones)"
+    
+  - id: project_objective
+    section: identity
+    text: "¿Cuál es el objetivo principal del proyecto?"
+    type: textarea
+    required: true
+    help: "Describe en 1-2 frases qué problema resuelve o qué necesidad cubre"
+    
+  - id: target_audience
+    section: identity
+    text: "¿Quién es el público objetivo?"
+    type: select
+    required: true
+    options:
+      - value: personal
+        label: "Uso personal"
+      - value: team
+        label: "Equipo/empresa específica"
+      - value: public
+        label: "Público general"
+      - value: niche
+        label: "Nicho específico"
+    follow_up:
+      - condition: "niche"
+        question: "Especifica el nicho:"
+        type: text
+        
+  - id: problem_solved
+    section: identity
+    text: "¿Qué problema específico resuelve?"
+    type: textarea
+    required: true
+    
+  - id: competitors
+    section: identity
+    text: "¿Hay algún competidor o referencia? (Ejemplo: 'Como Trello pero para...')"
+    type: text
+    required: false
+
+  # ===== STACK TECNOLÓGICO BASE =====
+  - id: backend_framework
+    section: stack
+    text: "¿Qué framework de backend prefieres?"
+    type: select
+    required: true
+    options:
+      - value: laravel
+        label: "Laravel (PHP)"
+        triggers: [questions-php]
+      - value: nodejs
+        label: "Node.js (Express/NestJS)"
+        triggers: [questions-nodejs]
+      - value: python
+        label: "Python (Django/FastAPI)"
+        triggers: [questions-python]
+      - value: rails
+        label: "Ruby on Rails"
+        triggers: [questions-ruby]
+      - value: other
+        label: "Otro"
+    follow_up:
+      - condition: "other"
+        question: "Especifica el framework:"
+        type: text
+        
+  - id: frontend_framework
+    section: stack
+    text: "¿Qué framework de frontend prefieres?"
+    type: select
+    required: true
+    options:
+      - value: react
+        label: "React"
+        triggers: [questions-react]
+      - value: vue
+        label: "Vue.js"
+        triggers: [questions-vue]
+      - value: angular
+        label: "Angular"
+      - value: svelte
+        label: "Svelte"
+      - value: blade
+        label: "Blade (solo Laravel)"
+        requires: {backend_framework: laravel}
+      - value: none
+        label: "Sin frontend (API/Backend solo)"
+        triggers: [questions-api]
+      - value: other
+        label: "Otro"
+        
+  - id: use_typescript
+    section: stack
+    text: "¿Usar TypeScript en el frontend?"
+    type: boolean
+    required: true
+    depends_on:
+      - frontend_framework: [react, vue, angular, svelte]
+    default: true
+    
+  - id: database
+    section: stack
+    text: "¿Qué base de datos prefieres?"
+    type: select
+    required: true
+    options:
+      - value: postgresql
+        label: "PostgreSQL"
+      - value: mysql
+        label: "MySQL/MariaDB"
+      - value: mongodb
+        label: "MongoDB"
+        triggers: [questions-nosql]
+      - value: sqlite
+        label: "SQLite"
+      - value: other
+        label: "Otro"
+
+  # ===== FUNCIONALIDADES CORE =====
+  - id: core_features
+    section: features
+    text: "Lista las funcionalidades CORE (MVP mínimo viable)"
+    type: multiline
+    required: true
+    help: |
+      Una funcionalidad por línea. Ejemplos:
+      - Login de usuarios
+      - CRUD de productos
+      - Búsqueda de contenido
+      - Carrito de compras
+    analyzer: detect_project_type
+    
+  - id: secondary_features
+    section: features
+    text: "Lista las funcionalidades SECUNDARIAS (nice-to-have)"
+    type: multiline
+    required: false
+    help: |
+      Funcionalidades deseables pero no críticas para el MVP.
+      Ejemplos:
+      - Notificaciones email
+      - Modo oscuro
+      - Exportar a PDF
+      
+  - id: needs_auth
+    section: features
+    text: "¿El proyecto necesita autenticación de usuarios?"
+    type: select
+    required: true
+    options:
+      - value: email_password
+        label: "Sí, email + password"
+        triggers: [questions-auth]
+      - value: oauth
+        label: "Sí, OAuth (Google, GitHub, etc.)"
+        triggers: [questions-auth, questions-oauth]
+      - value: both
+        label: "Ambas opciones"
+        triggers: [questions-auth, questions-oauth]
+      - value: none
+        label: "No necesita autenticación"
+        
+  - id: needs_admin_panel
+    section: features
+    text: "¿Necesita panel de administración?"
+    type: select
+    required: true
+    options:
+      - value: full
+        label: "Sí, completo (CRUD de todo)"
+        triggers: [questions-admin]
+      - value: basic
+        label: "Sí, básico (solo usuarios y config)"
+        triggers: [questions-admin]
+      - value: none
+        label: "No"
+        
+  - id: file_uploads
+    section: features
+    text: "¿Necesita subida de archivos/imágenes?"
+    type: select
+    required: true
+    options:
+      - value: local
+        label: "Sí, almacenamiento local"
+      - value: cloud
+        label: "Sí, cloud (S3, Cloudinary...)"
+        triggers: [questions-storage]
+      - value: none
+        label: "No"
+
+  # ===== DESPLIEGUE =====
+  - id: hosting
+    section: deployment
+    text: "¿Dónde se desplegará el proyecto?"
+    type: select
+    required: true
+    options:
+      - value: hostinger
+        label: "Hostinger"
+      - value: aws
+        label: "AWS"
+        triggers: [questions-aws]
+      - value: digitalocean
+        label: "DigitalOcean"
+      - value: vercel
+        label: "Vercel/Netlify (frontend) + otro (backend)"
+      - value: local
+        label: "Local/desarrollo solamente"
+      - value: other
+        label: "Otro"
+        
+  - id: needs_ssl
+    section: deployment
+    text: "¿Necesita SSL/HTTPS?"
+    type: boolean
+    required: true
+    default: true
+    
+  - id: custom_domain
+    section: deployment
+    text: "¿Necesita dominio personalizado?"
+    type: text
+    required: false
+    help: "Deja vacío si usarás subdominio temporal"
+
+  # ===== DISEÑO =====
+  - id: color_palette
+    section: design
+    text: "¿Tienes una paleta de colores definida?"
+    type: select
+    required: true
+    options:
+      - value: custom
+        label: "Sí, tengo colores específicos"
+      - value: suggest
+        label: "No, sugiéreme una"
+      - value: default
+        label: "Usar defaults de Tailwind/Bootstrap"
+    follow_up:
+      - condition: "custom"
+        question: "Especifica colores (primario, secundario, acento):"
+        type: text
+        
+  - id: visual_style
+    section: design
+    text: "¿Qué estilo visual prefieres?"
+    type: select
+    required: true
+    options:
+      - value: minimal
+        label: "Minimalista (Vercel-style)"
+      - value: modern
+        label: "Moderno (Gradientes, glassmorphism)"
+      - value: professional
+        label: "Profesional (Corporate, serio)"
+      - value: creative
+        label: "Creativo (Ilustraciones, colores vivos)"
+      - value: other
+        label: "Otro"
+
+  # ===== RESTRICCIONES =====
+  - id: time_limit
+    section: constraints
+    text: "¿Hay límite de tiempo para el MVP?"
+    type: text
+    required: false
+    help: "Ejemplos: 2 semanas, 3 meses, sin prisa..."
+    
+  - id: budget_limit
+    section: constraints
+    text: "¿Hay presupuesto máximo para servicios externos?"
+    type: text
+    required: false
+    help: "Para hosting, APIs, servicios de terceros..."
+    
+  - id: out_of_scope
+    section: constraints
+    text: "¿Qué NO debe incluir el proyecto?"
+    type: multiline
+    required: false
+    help: |
+      Cosas que explícitamente quedan fuera del alcance.
+      Ejemplos:
+      - No app móvil nativa
+      - No sistema de pagos
+      - No chat en vivo
+
+# ===== ANALIZADORES =====
+analyzers:
+  detect_project_type:
+    description: "Detecta el tipo de proyecto basándose en las funcionalidades listadas"
+    triggers:
+      - keywords: [login, usuario, registro, perfil, auth]
+        activate: questions-auth
+      - keywords: [pago, compra, carrito, stripe, paypal]
+        activate: questions-ecommerce
+      - keywords: [suscripción, plan, billing, mensualidad]
+        activate: questions-saas
+      - keywords: [api, endpoint, rest, graphql]
+        activate: questions-api
+      - keywords: [blog, post, artículo, contenido, cms]
+        activate: questions-cms
+      - keywords: [chat, mensaje, notificación, tiempo real]
+        activate: questions-realtime

package/.commands/nuevo/responses-example.yaml

@@ -0,0 +1,53 @@
+# Archivo de ejemplo de respuestas
+# Este archivo muestra cómo se guardan las respuestas del cuestionario
+
+# ===== IDENTIDAD =====
+project_name: casa-de-peli
+project_display_name: Casa de Peli
+project_objective: Plataforma web de catálogo y reseñas de películas donde los usuarios pueden descubrir películas, ver detalles y crear listas personalizadas
+problem_solved: Los usuarios no tienen un lugar centralizado para llevar registro de películas vistas, escribir reseñas y gestionar listas de películas
+target_audience: public
+competitors: IMDb, Letterboxd, FilmAffinity
+
+# ===== STACK TECNOLÓGICO =====
+backend_framework: laravel
+frontend_framework: react
+use_typescript: true
+database: postgresql
+css_framework: tailwind
+
+# ===== FUNCIONALIDADES =====
+core_features:
+  - Catálogo de películas con búsqueda y filtros
+  - Sistema de reseñas y calificaciones
+  - Listas personalizadas (favoritas, por ver, vistas)
+  - Autenticación de usuarios
+  - Perfil de usuario
+
+secondary_features:
+  - Feed de actividad reciente
+  - Recomendaciones basadas en gustos
+  - Modo oscuro
+  - Compartir reseñas en redes sociales
+
+needs_auth: email_password
+needs_admin_panel: basic
+file_uploads: cloud
+
+# ===== DISEÑO =====
+color_palette: suggest
+visual_style: modern
+
+# ===== DESPLIEGUE =====
+hosting: hostinger
+needs_ssl: true
+custom_domain: casadepeli.com
+
+# ===== RESTRICCIONES =====
+time_limit: 3 meses
+budget_limit: 500 USD
+out_of_scope:
+  - Streaming de películas (no reproducción)
+  - App móvil nativa
+  - Sistema de pagos
+  - Chat entre usuarios