specleap-framework 2.0.9 → 2.0.11

package/CLAUDE.md

@@ -1,357 +1,444 @@
-# SpecLeap — Context for Claude Code & Claude API
+# SpecLeap Framework — Claude Context
 
-**Methodology:** Spec-Driven Development (SDD). Spec first, never code first.
+**Metodología:** Spec-Driven Development (SDD). Primero CONTRATO.md, luego código.
 
 ---
 
-## 🌐 Default Language: SPANISH
+## 🌐 Idioma por Defecto: ESPAÑOL
 
-**CRITICAL:** All feedback, messages, commit messages, and user-facing text MUST be in SPANISH.
+**CRÍTICO:** Todo feedback, mensajes de commit, y texto para usuario DEBE ser en ESPAÑOL.
 
-This project is for Spanish-speaking teams. All agents, commands, and responses must use Spanish unless explicitly overridden.
-
-**Examples:**
+**Ejemplos:**
 ❌ "Generating plan..."
 ✅ "Generando plan..."
 
 ❌ "Tests passed"
 ✅ "Tests pasaron"
 
-See individual agent files (`.agents/*.md`) for specific language directives.
+Ver archivos de agentes individuales (`.agents/*.md`) para directivas específicas de idioma.
 
 ---
 
-## Project Structure
+## Estructura del Proyecto
+
+Esto es **SpecLeap**, un framework de desarrollo que combina:
+- **Agentes conversacionales** (roles especializados con comandos)
+- **Spec-Driven Development** (contratos primero, código segundo)
+- **Soporte multi-proyecto** (proyectos independientes con contratos)
 
-This is **SpecLeap**, a development framework that combines:
-- **Conversational agents** (specialized roles with commands)
-- **Spec-Driven Development** (contracts first, code second)
-- **Multi-project support** (independent projects with contracts)
+```
+specleap-framework/
+├── .agents/          # 3 agentes especializados
+│   ├── backend.md    # Laravel + PHP + API
+│   ├── frontend.md   # React + TypeScript
+│   └── producto.md   # Análisis producto + user stories
+├── .commands/        # 10 comandos SpecLeap
+│   ├── ayuda.md
+│   ├── planificar.md
+│   ├── implementar.md
+│   ├── refinar.md
+│   └── ...
+├── .specleap/        # Configuración (creada durante instalación)
+│   ├── config.json   # Tokens, idioma, workspace
+│   └── i18n/         # Traducciones ES/EN
+├── proyectos/        # Proyectos del usuario
+│   └── _template/    # Plantilla CONTRATO.md + ANEXOS.md
+├── rules/            # Reglas de desarrollo
+└── scripts/          # Scripts de instalación y generación
+```
 
 ---
 
-## Core Principles
+## Principios Fundamentales
 
-1. **CONTRATO.md is IMMUTABLE** — Once accepted, never modify. Use ANEXOS.md for improvements.
-2. **Projects are independent** — Each project in `proyectos/` has its own contract and context.
-3. **Commands are in Spanish** — `refinar`, `planificar`, `implementar`, `explicar`, `documentar`
-4. **Agents have roles** — Backend, Frontend, Product Analyst (see `.agents/`)
-5. **Standards are global** — `specs/*.mdc` apply to ALL projects
+1. **CONTRATO.md es la fuente de verdad** — Una vez aceptado, nunca modificar
+2. **Proyectos son independientes** — Cada proyecto en `proyectos/` tiene su propio contrato
+3. **Comandos en español** — `refinar`, `planificar`, `implementar`, `explicar`, `documentar`
+4. **Agentes tienen roles** — Backend, Frontend, Producto (ver `.agents/`)
+5. **Flujo SDD obligatorio** — Spec primero, SIEMPRE
 
 ---
 
-## Getting Started
+## 🚀 Inicio de Sesión
 
-### Trigger Word: "Hola"
+### Cuando el Usuario Dice "Hola" o "ayuda"
 
-When the user says **"Hola"** (case-insensitive), execute `.commands/inicio.md`:
-1. List available projects in `proyectos/`
-2. Ask which project to work on (or new project)
-3. Load project context (CONTRATO.md + context/)
-4. Ask what type of work (DESARROLLO / DOCUMENTACIÓN)
+**SIEMPRE** responder con:
+
+```
+¡Hola! Soy tu asistente SpecLeap.
+
+📋 Comandos disponibles:
+  • ayuda      → Lista completa de comandos
+  • inicio     → Crear proyecto nuevo (cuestionario 59 preguntas)
+  • planificar → Generar backlog Asana desde CONTRATO.md
+  • implementar <ticket> → Desarrollar feature
+  • refinar    → Mejorar CONTRATO.md existente
+  • documentar → Actualizar documentación
+
+🔧 Estado del proyecto:
+  [Buscar CONTRATO.md en proyectos/]
+  
+  Si existe:
+  ✅ CONTRATO.md encontrado: proyectos/mi-proyecto/CONTRATO.md
+  
+  Si NO existe:
+  ⚠️  No hay CONTRATO.md todavía.
+      Para crear uno nuevo:
+      ./scripts/generate-contrato.sh
+      
+      o escribe: inicio
+
+¿En qué puedo ayudarte hoy?
+```
+
+**NUNCA** dar respuesta genérica como "¿En qué puedo ayudarte?" sin mostrar los comandos disponibles.
 
 ---
 
-## Slash Command Detection (CRITICAL)
+## 📋 Comandos Disponibles
+
+### Comandos Principales
 
-**When the user writes a SINGLE slash command** (e.g., just `refinar` or `crear-tickets`), **AUTOMATICALLY**:
+| Comando | Descripción | Archivo | Agente |
+|---------|-------------|---------|--------|
+| `ayuda` | Lista completa de comandos + flujo SDD | `.commands/ayuda.md` | - |
+| `inicio` | Wizard proyecto nuevo (59 preguntas) | `.commands/inicio.md` | - |
+| `planificar` | Lee CONTRATO.md → genera backlog Asana | `.commands/planificar.md` | - |
+| `implementar <ticket>` | Desarrolla según spec del ticket Asana | `.commands/implementar.md` | backend/frontend |
+| `refinar` | Mejora CONTRATO.md existente | `.commands/refinar.md` | producto |
+| `documentar` | Genera/actualiza documentación | `.commands/documentar.md` | - |
+| `adoptar` | Integra SpecLeap en proyecto existente | `.commands/adoptar.md` | - |
+| `explicar <concepto>` | Explica metodología SDD | `.commands/explicar.md` | - |
 
-1. **Detect the command** from the message
-2. **Read the corresponding `.commands/*.md` file**
-3. **Follow the instructions in that file step-by-step**
+### Detección de Comandos
 
-**Command-to-File Mapping:**
+**Cuando el usuario escribe UN SOLO comando** (ej: `planificar`, `ayuda`):
 
-| User writes | Read this file | Then execute |
-|-------------|----------------|--------------|
-| `/inicio` or `Hola` | `.commands/inicio.md` | Start workflow |
-| `ayuda`, `help`, `comandos` | `.commands/ayuda.md` | List ALL available commands |
-| `refinar` | `.commands/refinar.md` | Refine user story |
-| `planificar` | `.commands/planificar.md` | Generate backlog |
-| `crear-tickets` | `.commands/crear-tickets.md` | Alias of `planificar` |
-| `implementar` | `.commands/implementar.md` | Execute implementation |
-| `explicar` | `.commands/explicar.md` | Explain concept |
-| `documentar` | `.commands/documentar.md` | Update docs |
-| `adoptar` | `.commands/adoptar.md` | Adopt legacy project |
+1. **Detectar el comando** del mensaje
+2. **Leer el archivo** `.commands/<comando>.md` correspondiente
+3. **Seguir las instrucciones** paso a paso del archivo
+4. **NUNCA preguntar** "¿debería leer el archivo?" — simplemente léelo
 
-**Rules:**
-- If user writes `/comando` alone → read `.commands/comando.md` immediately
-- If user writes `/comando` + context → read file + use context
-- NEVER ask "should I read the file?" — just read it
+**Mapeo comando → archivo:**
+- `ayuda` | `help` | `comandos` → `.commands/ayuda.md`
+- `inicio` → `.commands/inicio.md`
+- `planificar` | `crear-tickets` → `.commands/planificar.md`
+- `implementar` → `.commands/implementar.md`
+- `refinar` → `.commands/refinar.md`
+- `documentar` → `.commands/documentar.md`
+- `adoptar` → `.commands/adoptar.md`
+- `explicar` → `.commands/explicar.md`
 
 ---
 
-## Commands Available
+## 🔄 Flujo de Trabajo SDD
+
+### Paso 1: Crear CONTRATO.md
+
+**Opción A: Cuestionario Guiado (Recomendado)**
+```bash
+./scripts/generate-contrato.sh
+```
+→ 59 preguntas interactivas (Stack, Features, Integraciones, etc.)  
+→ Genera CONTRATO.md completo automáticamente
 
-| Command | Description | Agente |
-|---------|-------------|--------|
-| `refinar SCRUM-XX` | Refine Jira user story | producto.md |
-| `planificar SCRUM-XX` | Generate implementation plan | backend.md / frontend.md |
-| `implementar @plan.md` | Execute plan: branch + code + tests + PR | backend.md / frontend.md |
-| `explicar [concepto]` | Explain code/architecture/decisions | neutral |
-| `documentar` | Update technical documentation | neutral |
+**Opción B: Manual**
+```bash
+cp proyectos/_template/CONTRATO.md proyectos/mi-proyecto/
+# Editar manualmente
+```
 
-**See:** `.commands/` for detailed command specifications.
+### Paso 2: Planificar en Asana
 
----
+```
+Usuario: planificar
+```
+
+**El asistente debe:**
+1. Leer `CONTRATO.md`
+2. Analizar secciones: Features, Stack, Integraciones, Roles, etc.
+3. Ejecutar `scripts/generate-asana-structure.sh`
+4. Generar épicas + user stories en Asana
+5. Reportar resumen: X épicas, Y stories creadas
+
+### Paso 3: Implementar por Tickets
 
-## Agents
+```
+Usuario: implementar PROJ-123
+```
 
-Adopt these roles when executing commands:
+**El asistente debe:**
+1. Descargar spec del ticket Asana (vía API)
+2. Leer CONTRATO.md para contexto
+3. Adoptar agente apropiado (.agents/backend.md o frontend.md)
+4. Implementar según especificación
+5. Crear tests (coverage >= 80%)
+6. Documentar cambios
+7. Crear branch: `feature/PROJ-123-descripcion`
+8. Commit + Push
+9. Crear PR
+10. Esperar review CodeRabbit
+
+### Paso 4: Review Automático
+
+→ Push a GitHub  
+→ CodeRabbit revisa automáticamente (`.coderabbit.yaml`)  
+→ Feedback en español  
+→ Aplicar correcciones si necesario  
 
-- **`.agents/backend.md`** — Laravel + PHP + API expert
-- **`.agents/frontend.md`** — React + TypeScript + Vite expert
-- **`.agents/producto.md`** — Product analyst + user story enrichment
+---
 
-**When to adopt:**
-- `refinar` → producto.md
-- `planificar` backend → backend.md
-- `planificar` frontend → frontend.md
-- `implementar` → backend.md or frontend.md (depending on plan)
+## 🤖 Agentes Especializados
+
+Adoptar estos roles cuando sea apropiado:
+
+### .agents/backend.md
+**Cuándo:** Implementando APIs, base de datos, lógica de negocio  
+**Stack:** Laravel + PHP + Eloquent + PostgreSQL/MySQL  
+**Responsabilidades:**
+- Arquitectura backend (DDD, Repository pattern)
+- APIs RESTful
+- Validación server-side
+- Seguridad (OWASP)
+- Tests unitarios + integración
+
+### .agents/frontend.md
+**Cuándo:** Implementando UI, componentes, estado  
+**Stack:** React + TypeScript + Vite + TailwindCSS  
+**Responsabilidades:**
+- Componentes reutilizables
+- Estado global (Context/Zustand)
+- Integración con APIs
+- Diseño responsive
+- Tests componentes
+
+### .agents/producto.md
+**Cuándo:** Refinando user stories, decisiones de producto  
+**Responsabilidades:**
+- Enriquecer user stories con criterios de aceptación
+- Detectar edge cases
+- Priorización de features
+- UX/UI decisions
+
+**Activación automática:**
+- Usuario escribe `refinar` → Cargar `.agents/producto.md`
+- Usuario escribe `implementar` + backend-related → Cargar `.agents/backend.md`
+- Usuario escribe `implementar` + frontend-related → Cargar `.agents/frontend.md`
 
 ---
 
-## Standards (Always Apply)
+## 📐 Reglas de Desarrollo
+
+Ver carpeta `rules/` para reglas completas:
 
-Read and follow these standards for ALL code:
+### rules/development-rules.md
+- Spec-first SIEMPRE
+- Código en inglés, comentarios en español
+- Tests obligatorios (>= 80% coverage)
+- TypeScript strict mode
 
-### Global Standards
-1. **`specs/base-standards.mdc`** — Core principles (English only, TDD, small steps)
-2. **`specs/backend-standards.mdc`** — Backend patterns (DDD, testing)
-3. **`specs/frontend-standards.mdc`** — Frontend patterns (components, state)
-4. **`specs/documentation-standards.mdc`** — Documentation structure
+### rules/git-workflow.md
+- Feature branches: `feature/PROJ-123-descripcion`
+- NUNCA push directo a `main`
+- Commits descriptivos en español
+- PRs obligatorios
 
-### Technology-Specific Standards
-5. **`specs/laravel-standards.mdc`** — Laravel + PHP + Eloquent
-6. **`specs/react-standards.mdc`** — React + TypeScript + hooks
+### rules/environment-protection.md
+- NUNCA hardcodear credenciales
+- Usar `.env` para configuración
+- Validar variables de entorno al inicio
 
-**Always read relevant standards before implementing.**
+### rules/session-protocol.md
+- Mantener contexto entre sesiones
+- Documentar decisiones importantes
+- Actualizar ANEXOS.md con cambios aprobados
 
 ---
 
-## Agent Skills (Progressive Disclosure)
+## 🧪 Agent Skills (20 Skills TIER 1)
 
-If **20 Agent Skills TIER 1** are installed (`~/.skills/`), they activate automatically:
+Si están instalados en `~/.skills/`, se activan automáticamente según contexto:
 
-### Activation Triggers
+### 🔒 Seguridad (5 skills)
+- `backend-api-security` — Validación server-side, rate limiting, CSRF
+- `frontend-mobile-security` — XSS, sanitización
+- `sast-configuration` — SAST tools config
+- `stride-analysis-patterns` — Threat modeling
+- `security-requirement-extraction` — Security reqs desde specs
 
-Skills load knowledge **only when needed** based on context:
+### 🔄 Consistencia (3 skills) ⭐ CRÍTICOS
+- `verification-before-completion` — Verificar ANTES de finalizar
+- `code-review-excellence` — Review checklist
+- `systematic-debugging` — Debug metodológico
 
-```
-User: "Crear endpoint POST /api/products con validación"
-
-Auto-activates:
-  ✓ api-design-principles
-  ✓ backend-api-security
-  ✓ laravel-specialist
-  ✓ verification-before-completion
-  ✓ postgresql-table-design
-```
+### 🎨 Diseño/Frontend (6 skills)
+- `frontend-design` — Profesional design (Vercel/Linear style)
+- `web-design-guidelines` — UX guidelines
+- `ui-ux-pro-max` — Diseño avanzado + componentes
+- `tailwind-design-system` — TailwindCSS best practices
+- `shadcn-ui` — Shadcn components
+- `responsive-design` — Mobile-first responsive
+
+### 🛠️ Backend/Dev (6 skills)
+- `laravel-specialist` — Laravel best practices
+- `vercel-react-best-practices` — React + Next.js
+- `test-driven-development` — TDD workflow
+- `api-design-principles` — REST API design
+- `postgresql-table-design` — DB schema design
+- `error-handling-patterns` — Error handling strategies
 
-### Critical Skills
-
-#### verification-before-completion ⭐ **MANDATORY**
-
-**Before creating ANY function, class, or component:**
-1. **SEARCH** existing code for similar functionality
-2. **READ** conventions.md for naming patterns
-3. **VERIFY** utilities/services don't already exist
-4. **ONLY THEN** create if nothing similar exists
-
-**Anti-Pattern (NEVER DO):**
-- ❌ Create `UserHelper` when `UserService` exists
-- ❌ Create `formatPrice()` when `formatCurrency()` exists
-- ❌ Create new HTTP client when axios instance exists
-
-#### code-review-excellence
-
-Before committing, verify:
-- No duplicated code
-- Follows conventions.md
-- Tests coverage >= 90%
-- Security best practices
-
-#### backend-api-security
-
-For all endpoints:
-- Server-side validation
-- Rate limiting
-- CSRF protection
-- SQL injection prevention
-- XSS sanitization
-
-#### frontend-design + web-design-guidelines
-
-For all components:
-- Professional design (Vercel/Linear style)
-- Consistent spacing (4px grid)
-- Responsive mobile-first
-- Micro-interactions
-- Design system coherence
-
-### Skill Categories
-
-**🔒 Security (5):**
-- sast-configuration
-- stride-analysis-patterns
-- security-requirement-extraction
-- backend-api-security
-- frontend-mobile-security
-
-**🔄 Consistency (3):**
-- verification-before-completion ⭐
-- code-review-excellence
-- systematic-debugging
-
-**🎨 Design/Frontend (6):**
-- web-design-guidelines
-- frontend-design
-- ui-ux-pro-max
-- tailwind-design-system
-- shadcn-ui
-- responsive-design
-
-**🛠️ Backend/Dev (6):**
-- laravel-specialist
-- vercel-react-best-practices
-- test-driven-development
-- api-design-principles
-- postgresql-table-design
-- error-handling-patterns
-
-**See:** [SETUP.md](SETUP.md) for installation details.
+**Activación:** Automática según contexto del código/comando
 
 ---
 
-## Project Structure
+## ⚠️ Verificaciones ANTES de Codificar
 
+### SIEMPRE Verificar:
+
+**1. ¿Existe CONTRATO.md?**
+```bash
+find proyectos/ -name "CONTRATO.md"
 ```
-proyectos/[project-name]/
-├── CONTRATO.md          # 🔒 IMMUTABLE contract
-├── ANEXOS.md            # ✏️ Improvements/modules
-├── context/             # Memory-bank
-│   ├── brief.md
-│   ├── architecture.md
-│   ├── tech-stack.md
-│   ├── conventions.md
-│   └── decisions.md
-└── specs/               # Feature specs
-    ├── [TICKET-ID]_backend.md
-    └── [TICKET-ID]_frontend.md
-```
+- ❌ NO → Pedir crearlo: `./scripts/generate-contrato.sh` o comando `inicio`
+- ✅ SÍ → Leerlo ANTES de implementar
+
+**2. ¿Hay ticket Asana asignado?**
+- ❌ NO → Preguntar: "¿Qué ticket Asana implementamos? (ej: PROJ-123)"
+- ✅ SÍ → Descargar spec del ticket vía API Asana
 
-**Before working on a project:**
-1. Read `CONTRATO.md` — Understand the contract
-2. Read `context/architecture.md` — Understand architecture
-3. Read `context/conventions.md` — Follow code patterns
+**3. ¿Stack tecnológico definido?**
+- Leer sección "Stack Tecnológico" de CONTRATO.md
+- NUNCA asumir tecnologías sin verificar
+
+**4. ¿Tests existen para funcionalidad?**
+- ❌ NO → Crearlos ANTES de considerar completo
+- ✅ SÍ → Ejecutarlos y verificar que pasan
 
 ---
 
-## Workflow Example
+## 🚫 Prohibiciones Absolutas
 
-```
-User: "Hola"
-AI: [Execute .commands/inicio.md]
-    - List projects
-    - Ask which project + type of work
-
-User: "app-tienda y desarrollo"
-AI: [Load proyectos/app-tienda/CONTRATO.md + context/]
-    "✅ Proyecto app-tienda cargado. ¿Qué ticket trabajarás?"
-
-User: "SCRUM-23"
-AI: "¿Refinar o planificar directamente?"
-
-User: "planificar SCRUM-23"
-AI: [Adopt .agents/backend.md]
-    [Read CONTRATO + context + ticket]
-    [Generate plan in specs/SCRUM-23_backend.md]
-    "📋 Plan creado. Revisar antes de implementar."
-
-User: "implementar @SCRUM-23_backend.md"
-AI: [Adopt .agents/backend.md]
-    [Execute plan step by step]
-    [Tests, commit, push, PR]
-    "✅ Implementación completada. PR: [URL]"
-```
+1. **NUNCA** codificar sin CONTRATO.md aprobado
+2. **NUNCA** hacer commit directo a `main`
+3. **NUNCA** hardcodear credenciales (usar `.env`)
+4. **NUNCA** ignorar el comando del usuario
+   - Si dice `planificar` → ejecutar planificar
+   - Si dice `implementar` → ejecutar implementar
+5. **NUNCA** asumir stack tecnológico (leer CONTRATO.md)
+6. **NUNCA** modificar CONTRATO.md después de aprobado (usar ANEXOS.md)
+7. **NUNCA** respuesta genérica a "Hola" (siempre listar comandos)
 
 ---
 
-## CLI Tools (Optional)
-
-Besides conversational commands, the `openspec` CLI is available:
+## 🔧 Integración con Herramientas
 
-```bash
-openspec enrich "user story"      # Refine user story
-openspec new --auto "feature"     # Create proposal
-openspec verify CHANGE-001        # Verify tests
-openspec status                   # List proposals
-```
+### Asana (OBLIGATORIO)
 
-See: `openspec/cli/README.md`
+**SpecLeap usa Asana** para gestión de backlog.
 
----
+**Token configurado en:**
+- `.specleap/config.json` → `asana.token`
+- `.env` → `ASANA_WORKSPACE_ID`
 
-## MCP Integrations
+**Scripts:**
+- `scripts/generate-asana-structure.sh` — Genera estructura completa
+- `scripts/create-asana-tasks.sh` — Crea tasks individuales
+- API Asana para leer specs de tickets
 
-### ⚠️ Jira MCP (MANDATORY)
+**Comando `planificar`:**
+1. Lee CONTRATO.md
+2. Ejecuta `generate-asana-structure.sh`
+3. Crea épicas por feature
+4. Crea user stories por épica
+5. Reporta resumen
 
-**Jira is MANDATORY for SpecLeap workflow.**
+### CodeRabbit (Recomendado)
 
-MUST use for:
-- `crear-tickets` — Generate all tickets from CONTRATO.md
-- `refinar SCRUM-XX` — Read and enrich ticket
-- `planificar SCRUM-XX` — Read ticket for plan generation
-- `implementar` — Update ticket status during implementation
-- Automatic updates: "To Do" → "In Progress" → "In Review" → "Done"
+**Review automático en PRs.**
 
-**Without Jira MCP, the workflow DOES NOT WORK.**
+**Configuración:** `.coderabbit.yaml` (incluido en template)
 
-### CodeRabbit (Recommended)
+**Checks:**
+- Cumplimiento de specs
+- Tests >= 80% coverage
+- Seguridad (OWASP)
+- Estándares de código
+- Feedback en español
 
-**Automatic code review on all PRs.**
+**Comando `implementar` espera:**
+- CodeRabbit approval antes de marcar completo
+- Aplicar feedback si hay correcciones
 
-- Install CodeRabbit GitHub App on repos
-- Copy `.coderabbit.yaml` from `proyectos/_template/`
-- Reviews in Spanish
-- Checks: specs compliance, tests >= 90%, security, standards
-- `implementar` waits for CodeRabbit approval before marking complete
+### Git Hooks (Instalado automáticamente)
 
-### Context7 MCP (Optional)
+**Scripts:** `scripts/install-git-hooks.sh`
 
-If configured, use for:
-- Fetching up-to-date library documentation (Laravel, React, etc.)
-- Avoid outdated knowledge
+**Hooks:**
+- `pre-commit` — Linters, formatters, tests
+- `commit-msg` — Valida formato de commit
+- `pre-push` — Tests completos
 
 ---
 
-## Critical Rules
+## 📊 Formato de Respuestas
+
+### Estilo General
+- **Conciso:** Directo al punto, sin relleno
+- **Estructurado:** Usar listas, headings, code blocks
+- **Bilingüe:** Español (default), English si usuario prefiere
+- **Contexto:** Siempre referenciar CONTRATO.md cuando exista
 
-1. **NEVER modify CONTRATO.md** after accepted — Only add to ANEXOS.md
-2. **NEVER push to main directly** — Always via PR
-3. **Tests must pass** — >= 90% coverage
-4. **Follow conventions.md** — Each project has specific patterns
-5. **All code in ENGLISH** — Variables, functions, comments, docs
-6. **User-facing text in SPANISH** — Error messages, UI text
+### Ejemplo: Comando Completado
+
+```
+✅ Implementación completada: Feature de autenticación
+
+📋 Cambios realizados:
+  • app/Http/Controllers/AuthController.php — Login + Register
+  • app/Models/User.php — Modelo usuario
+  • database/migrations/create_users_table.php — Schema
+  • tests/Feature/AuthTest.php — Tests auth
+
+🧪 Tests:
+  • test_user_can_register: ✅ PASS
+  • test_user_can_login: ✅ PASS  
+  • test_invalid_credentials: ✅ PASS
+  • Coverage: 92%
+
+📄 Documentación:
+  • README.md actualizado (instrucciones login)
+  • CONTRATO.md: sin cambios
+
+🔗 Próximos pasos:
+  1. Review: CodeRabbit revisará automáticamente
+  2. Merge: Una vez aprobado, merge a main
+  3. Deploy: [según proceso del equipo]
+
+🔗 PR: https://github.com/user/repo/pull/123
+```
 
 ---
 
-## References
+## 📖 Referencias
 
-- **Commands:** `.commands/*.md`
-- **Agents:** `.agents/*.md`
-- **Standards:** `specs/*.mdc`
-- **Project Template:** `proyectos/_template/`
-- **CLI Reference:** `openspec/cli/COMMAND_REFERENCE.md`
+- **Comandos:** `.commands/*.md`
+- **Agentes:** `.agents/*.md`
+- **Reglas:** `rules/*.md`
+- **Template:** `proyectos/_template/`
+- **Scripts:** `scripts/README.md`
 
 ---
 
-**When in doubt:**
-1. Read the relevant `.commands/` file
-2. Adopt the specified `.agents/` role
-3. Follow `specs/` standards
-4. Ask the user for clarification
+## 💡 Cuando Tengas Dudas
+
+1. Leer el archivo `.commands/` correspondiente
+2. Adoptar el rol `.agents/` especificado
+3. Seguir las reglas de `rules/`
+4. Preguntar al usuario para clarificación
+
+**SIEMPRE priorizar claridad sobre velocidad.**
 
 ---
 
-*Made with ❤️ by the SpecLeap Community*
+*Hecho con ❤️ por la Comunidad SpecLeap*

package/install.sh

@@ -1,152 +1,14 @@
 #!/bin/bash
 # SpecLeap Installer
-# Language selection + initial setup
+# Wrapper that runs the full setup.sh
 
 set -e
 
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-# Detect terminal width
-COLS=$(tput cols 2>/dev/null || echo 80)
-LINE=$(printf '%*s\n' "$COLS" '' | tr ' ' '=')
-
-# Clear screen and show banner (only if TTY)
-if [ -t 0 ]; then
-    clear
-fi
-echo -e "${CYAN}${LINE}${NC}"
-echo -e "${CYAN}"
-cat << "EOF"
-   _____ ____  ___________    __    _________    ____ 
-  / ___// __ \/ ____/ ____/   / /   / ____/   |  / __ \
-  \__ \/ /_/ / __/ / /       / /   / __/ / /| | / /_/ /
- ___/ / ____/ /___/ /___    / /___/ /___/ ___ |/ ____/ 
-/____/_/   /_____/\____/   /_____/_____/_/  |_/_/      
-                                                        
-EOF
-echo -e "${NC}${CYAN}${LINE}${NC}"
-echo ""
-echo -e "${GREEN}  Spec-Driven Development Framework${NC}"
-echo -e "${YELLOW}  v1.0.0${NC}"
-echo ""
-echo -e "${CYAN}${LINE}${NC}"
-echo ""
-
-# Language selection
-echo -e "${BLUE}Please select your language / Por favor selecciona tu idioma:${NC}"
-echo ""
-echo "  1) English"
-echo "  2) Español"
-echo ""
-read -p "$(echo -e ${YELLOW}Choose an option [1-2]:${NC} )" lang_choice
-
-# Set language
-case $lang_choice in
-    1)
-        SPECLEAP_LANG="en"
-        WELCOME_MSG="Welcome to SpecLeap!"
-        SETUP_MSG="Starting installation..."
-        CREATING_CONFIG="Creating configuration file..."
-        INSTALLING_DEPS="Installing dependencies..."
-        SETUP_COMPLETE="✅ Installation complete!"
-        NEXT_STEPS="Next steps:"
-        STEP_1="1. Read SETUP.md for detailed configuration"
-        STEP_2="2. Run: npm install (if using landing/web components)"
-        STEP_3="3. Configure your project in proyectos/"
-        STEP_4="4. Run: ./scripts/generate-contrato.sh to start"
-        ENJOY="Enjoy SpecLeap!"
-        ;;
-    2)
-        SPECLEAP_LANG="es"
-        WELCOME_MSG="¡Bienvenido a SpecLeap!"
-        SETUP_MSG="Iniciando instalación..."
-        CREATING_CONFIG="Creando archivo de configuración..."
-        INSTALLING_DEPS="Instalando dependencias..."
-        SETUP_COMPLETE="✅ Instalación completa!"
-        NEXT_STEPS="Próximos pasos:"
-        STEP_1="1. Lee SETUP.md para configuración detallada"
-        STEP_2="2. Ejecuta: npm install (si usas landing/componentes web)"
-        STEP_3="3. Configura tu proyecto en proyectos/"
-        STEP_4="4. Ejecuta: ./scripts/generate-contrato.sh para empezar"
-        ENJOY="¡Disfruta SpecLeap!"
-        ;;
-    *)
-        echo -e "${RED}Invalid option. Defaulting to English.${NC}"
-        SPECLEAP_LANG="en"
-        WELCOME_MSG="Welcome to SpecLeap!"
-        SETUP_MSG="Starting installation..."
-        CREATING_CONFIG="Creating configuration file..."
-        INSTALLING_DEPS="Installing dependencies..."
-        SETUP_COMPLETE="✅ Installation complete!"
-        NEXT_STEPS="Next steps:"
-        STEP_1="1. Read SETUP.md for detailed configuration"
-        STEP_2="2. Run: npm install (if using landing/web components)"
-        STEP_3="3. Configure your project in proyectos/"
-        STEP_4="4. Run: ./scripts/generate-contrato.sh to start"
-        ENJOY="Enjoy SpecLeap!"
-        ;;
-esac
-
-echo ""
-echo -e "${GREEN}${WELCOME_MSG}${NC}"
-echo -e "${YELLOW}${SETUP_MSG}${NC}"
-echo ""
-
-# Create config directory
-mkdir -p .specleap
-
-# Create proyectos directory (for user projects - NOT tracked in git)
-mkdir -p proyectos
-
-# Create config file
-echo -e "${CYAN}${CREATING_CONFIG}${NC}"
-cat > .specleap/config.json <<EOF
-{
-  "version": "1.0.0",
-  "language": "${SPECLEAP_LANG}",
-  "installed_at": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
-  "features": {
-    "asana_integration": false,
-    "coderabbit_integration": false,
-    "agent_skills_installed": false
-  }
-}
-EOF
-
-# Create .env file if it doesn't exist
-if [ ! -f .env ]; then
-    cat > .env <<EOF
-# SpecLeap Configuration
-SPECLEAP_LANG=${SPECLEAP_LANG}
-
-# Asana Integration (optional - for automatic backlog generation)
-ASANA_ACCESS_TOKEN=""
-ASANA_WORKSPACE_ID=""
-EOF
+# Check if setup.sh exists
+if [ ! -f "setup.sh" ]; then
+    echo "❌ Error: setup.sh not found"
+    exit 1
 fi
 
-# Make scripts executable
-chmod +x scripts/*.sh 2>/dev/null || true
-
-echo ""
-echo -e "${GREEN}${SETUP_COMPLETE}${NC}"
-echo ""
-echo -e "${CYAN}${LINE}${NC}"
-echo ""
-echo -e "${YELLOW}${NEXT_STEPS}${NC}"
-echo ""
-echo -e "  ${STEP_1}"
-echo -e "  ${STEP_2}"
-echo -e "  ${STEP_3}"
-echo -e "  ${STEP_4}"
-echo ""
-echo -e "${CYAN}${LINE}${NC}"
-echo ""
-echo -e "${GREEN}${ENJOY}${NC}"
-echo ""
+# Run setup.sh (which handles everything: language, tokens, skills, etc.)
+bash setup.sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specleap-framework",
-  "version": "2.0.9",
+  "version": "2.0.11",
   "description": "Spec-Driven Development Framework — Transform VSCode, Cursor, JetBrains into spec-first development machines",
   "keywords": [
     "spec-driven-development",
@@ -51,7 +51,6 @@
     ".github/**",
     ".vscode/**",
     "bin/**",
-    "proyectos/_template/**",
     "rules/**",
     "scripts/**",
     "setup.sh",

package/setup.sh

@@ -357,12 +357,8 @@ else
     echo ""
 fi
 
-if [ -f "proyectos/_template/.coderabbit.yaml" ]; then
-    cp proyectos/_template/.coderabbit.yaml .coderabbit.yaml
-    echo -e "${GREEN}✅ .coderabbit.yaml copiado${NC}"
-else
-    echo -e "${YELLOW}⚠️  Template no encontrado, se omite${NC}"
-fi
+# .coderabbit.yaml ya está en la raíz del proyecto
+echo -e "${GREEN}✅ .coderabbit.yaml listo${NC}"
 
 echo ""
 sleep 1

package/proyectos/_template/.gitkeep

@@ -1 +0,0 @@
-Template project structure

package/proyectos/_template/ANEXOS.md

@@ -1,21 +0,0 @@
-# ANEXOS — [Nombre del Proyecto]
-
-> **Cambios y mejoras propuestas fuera del CONTRATO original**
-
-Este archivo registra propuestas de cambio que están fuera del alcance del CONTRATO.md inmutable.
-
-## Propuestas Pendientes
-
-(Vacío)
-
-## Propuestas Aprobadas
-
-(Vacío)
-
-## Propuestas Rechazadas
-
-(Vacío)
-
----
-
-**Nota:** Para proponer cambios usa el comando `refinar` o `openspec new`.

package/proyectos/_template/CONTRATO.md

@@ -1,26 +0,0 @@
-# CONTRATO — [Nombre del Proyecto]
-
-> **Estado:** PLANTILLA (ejecutar comando `inicio` para generar)
-
-Este archivo será generado automáticamente después de responder el cuestionario de 56 preguntas.
-
-## Cómo Empezar
-
-1. Abre tu agente IA (Claude, Cursor, Continue)
-2. Escribe: **"Hola"**
-3. Selecciona: **"Proyecto nuevo"**
-4. Responde las preguntas interactivas
-
-El agente generará el CONTRATO completo con:
-- Objetivo del proyecto
-- Alcance detallado
-- Casos de uso
-- Módulos y features
-- Stack tecnológico
-- Criterios de aceptación
-- Restricciones y dependencias
-- Estimación de esfuerzo
-
----
-
-**SpecLeap** — Framework Spec-Driven Development

package/proyectos/_template/context/.gitkeep

@@ -1 +0,0 @@
-# Context files will be generated here