@nextsparkjs/core 0.1.0-beta.13 → 0.1.0-beta.131

package/dist/presets/ai-workflow/claude/tools/sessions/templates/clickup_task.md

@@ -1,121 +0,0 @@
-# ClickUp Task: [Feature Name]
-
-**Session:** `.claude/sessions/YYYY-MM-DD-feature-name-v1/`
-**Version:** v1
-**Created:** YYYY-MM-DD
-**Created By:** product-manager
-
-## ClickUp Integration
-
-**Mode:** [ENABLED / LOCAL_ONLY]
-
-<!--
-ENABLED: Task synced to ClickUp
-LOCAL_ONLY: Task stored locally only (no ClickUp API calls)
--->
-
-**Task ID:** [TASK_ID or "LOCAL_ONLY"]
-**Task URL:** [https://app.clickup.com/t/[TASK_ID] or "N/A - Local Only"]
-**Assigned To:** [User Name] (ID: [USER_ID])
-**Status:** backlog
-**Priority:** [normal/high/urgent/low]
-
----
-
-## Contexto de Negocio
-
-[Descripción desde perspectiva de negocio - EN ESPAÑOL]
-
-**Por qué es importante:**
-[Explicar por qué se construye esto - problema que resuelve]
-
-**Impacto esperado:**
-[Beneficio para usuarios/negocio]
-
-**Historia de Usuario:**
-Como [tipo de usuario], quiero [objetivo] para poder [beneficio]
-
----
-
-## Criterios de Aceptación
-
-**FORMATO: Lista numerada (NO checkboxes)**
-
-1. [Criterio específico #1 - formato Dado-Cuando-Entonces si aplica]
-2. [Criterio específico #2]
-3. [Criterio específico #3]
-4. [Casos extremos desde perspectiva de usuario]
-5. [Validaciones de negocio]
-
-**Métricas de Éxito:**
-- [Métrica medible #1]
-- [Métrica medible #2]
-
-**Fuera de Scope (No incluido en esta tarea):**
-- [Feature/functionality explícitamente excluida]
-- [Future enhancement considerado pero pospuesto]
-
----
-
-## Información Técnica
-
-**Feature Branch:** `feature/[feature-name]`
-
-**Archivos Principales Afectados:**
-- `path/to/file1.ts` - [descripción breve]
-- `path/to/file2.tsx` - [descripción breve]
-- `path/to/migration.sql` - [descripción breve]
-
-**Dependencies/Blockers:**
-- [Task ID o descripción de dependencia si aplica]
-- [Blocker conocido si aplica]
-
----
-
-## Notas Adicionales
-
-**Consideraciones de Diseño:**
-- [Nota sobre UX/UI si aplica]
-
-**Consideraciones de Performance:**
-- [Nota sobre performance si aplica]
-
-**Consideraciones de Seguridad:**
-- [Nota sobre security si aplica]
-
-**Referencias:**
-- [Link a documentación externa si aplica]
-- [Link a diseño en Figma si aplica]
-
----
-
-## Session Files
-
-**Session Path:** `.claude/sessions/YYYY-MM-DD-feature-name-v1/`
-
-**Archivos de sesión:**
-- `requirements.md` - Requerimientos detallados (task:requirements)
-- `clickup_task.md` - Este archivo (business context + ACs)
-- `plan.md` - Plan técnico detallado
-- `progress.md` - Progreso de desarrollo (local tracking)
-- `context.md` - Coordinación entre agentes
-- `tests.md` - Selectores data-cy + resultados de tests
-- `pendings.md` - Pendientes para futuras iteraciones
-
----
-
-## Referencias a Sesiones Anteriores
-
-**Versión Actual:** v1
-**Sesiones Previas:** N/A (primera versión)
-
-<!--
-Si esta es v2 o superior, documentar aquí:
-**Sesión Previa:** `YYYY-MM-DD-feature-name-v1`
-**Pendientes Heredados:** Ver pendings.md de sesión anterior
-**Contexto Relevante:** [Decisiones o issues de versión anterior]
--->
-
----
-
-**Última actualización:** YYYY-MM-DD HH:MM por [agent-name]

package/dist/presets/ai-workflow/claude/tools/sessions/templates/context.md

@@ -1,418 +0,0 @@
-# Contexto y Coordinación: [Feature Name]
-
-**Session:** `.claude/sessions/YYYY-MM-DD-feature-name-v1/`
-**Version:** v1
-**ClickUp Task:** [TASK_ID or "LOCAL_ONLY"]
-**Created:** [YYYY-MM-DD]
-
----
-
-## **Propósito de Este Archivo**
-
-Este archivo sirve como **nexo de comunicación entre agentes**. Cada agente que complete su trabajo DEBE agregar un mensaje aquí con:
-
-1. **Nombre del agente**
-2. **Fecha y hora**
-3. **Resumen de trabajo realizado**
-4. **Estado** (Completado / Completado con pendientes / Bloqueado)
-5. **Notas para el siguiente agente**
-
----
-
-## **Estados Válidos**
-
-- **✅ Completado:** La tarea se completó exitosamente, siguiente agente puede proceder
-- **⚠️ Completado con pendientes:** La tarea se completó pero hay mejoras o acciones pendientes (no bloqueantes)
-- **🚫 Bloqueado:** La tarea no pudo completarse, siguiente agente NO puede proceder hasta resolver
-
----
-
-## **Log de Coordinación**
-
-### [YYYY-MM-DD HH:MM] - product-manager
-
-**Estado:** ✅ Completado
-
-**Trabajo Realizado:**
-- Creada tarea en ClickUp (ID: [TASK_ID]) - O modo LOCAL_ONLY si no usa ClickUp
-- Definido contexto de negocio y criterios de aceptación
-- Creado session folder: `.claude/sessions/YYYY-MM-DD-feature-name-v1/`
-- Creados archivos: `requirements.md`, `clickup_task.md`, `context.md`
-- Asignado a: [User Name] (ID: [USER_ID])
-
-**Próximo Paso:**
-- architecture-supervisor debe leer `requirements.md` y `clickup_task.md` y crear plan técnico detallado
-
-**Notas:**
-- Prioridad: [normal/high/urgent/low]
-- [Cualquier nota adicional sobre el contexto de negocio]
-
----
-
-### [YYYY-MM-DD HH:MM] - architecture-supervisor
-
-**Estado:** ✅ Completado
-
-**Trabajo Realizado:**
-- Leído contexto de negocio de `requirements.md` y `clickup_task.md`
-- Creado plan técnico detallado en `plan.md`
-- Creado template de progreso en `progress.md`
-- Creado archivo de tests vacío en `tests.md`
-- Creado archivo de pendientes vacío en `pendings.md`
-- Analizado dependencias y bloqueadores potenciales
-- Definido fases: Backend → Frontend → Integration → Validation → QA → Review → Unit Tests
-
-**Decisiones Técnicas:**
-- [Decisión técnica importante #1 y razón]
-- [Decisión técnica importante #2 y razón]
-
-**Próximo Paso:**
-- backend-developer puede comenzar Fase 1 siguiendo `plan.md`
-- frontend-developer puede trabajar en paralelo en Fase 2 (si no hay dependencias)
-
-**Notas:**
-- Feature branch sugerida: `feature/[feature-name]`
-- [Cualquier consideración técnica importante]
-
----
-
-### [YYYY-MM-DD HH:MM] - backend-developer
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- [Lista de ítems completados de la Fase 1 del plan]
-- Migración ejecutada: `migrations/YYYYMMDD_feature_name.sql`
-- API endpoints implementados: POST, GET, PATCH, DELETE /api/v1/[resource]
-- Tests de backend: [X] unit tests, [Y] integration tests
-- Build validado: `pnpm build` ✅
-
-**Progreso:**
-- Marcado [X] de [Y] ítems en `progress.md`
-- Coverage: [X]% (target: 90%+)
-
-**Decisiones Durante Desarrollo:**
-- [Si se desvió del plan, explicar por qué]
-- [Decisiones de implementación significativas]
-
-**Próximo Paso:**
-- frontend-developer puede continuar/comenzar Fase 2
-- [O si bloqueado, explicar qué necesita resolverse]
-
-**Notas:**
-- [Cualquier nota relevante sobre la implementación]
-- [Advertencias o consideraciones para el siguiente agente]
-
----
-
-### [YYYY-MM-DD HH:MM] - frontend-developer
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- [Lista de ítems completados de la Fase 2 del plan]
-- Componentes creados: [lista de componentes]
-- State management implementado con TanStack Query
-- Traducciones agregadas (en + es)
-- Tests de frontend: [X] component tests, [Y] E2E tests
-- Build validado: `pnpm build` ✅
-
-**Progreso:**
-- Marcado [X] de [Y] ítems en `progress.md`
-- Coverage: [X]% (target: 80%+)
-
-**Decisiones Durante Desarrollo:**
-- [Decisiones de implementación UI/UX]
-- [Cambios respecto al plan original]
-
-**Próximo Paso:**
-- Fase 3: Integración - validar que backend + frontend funcionan end-to-end
-- Luego: frontend-validator para validación de data-cy y traducciones
-
-**Notas:**
-- [Notas sobre UX/UI]
-- [Consideraciones de accessibility]
-
----
-
-### [YYYY-MM-DD HH:MM] - backend-developer + frontend-developer
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado (Integración - Fase 3):**
-- Backend + Frontend integrados y funcionando end-to-end
-- Auth flow validado (session + API key)
-- Error handling validado
-- Performance validada (bundle size, queries DB)
-- Security validada (XSS, SQL injection, CSRF)
-- Build completa sin errores: `pnpm build` ✅
-
-**Progreso:**
-- Marcado [X] de [Y] ítems en `progress.md` (Fase 3)
-
-**Issues Resueltas Durante Integración:**
-- [Issue #1 encontrado y cómo se resolvió]
-- [Issue #2 encontrado y cómo se resolvió]
-
-**Próximo Paso:**
-- frontend-validator puede comenzar Fase 4: Frontend Validation
-- Validará data-cy selectors, traducciones, y strings hardcodeados
-
-**Notas:**
-- Dev server funcionando en `http://localhost:5173`
-- [Cualquier nota relevante para validación]
-
----
-
-### [YYYY-MM-DD HH:MM] - frontend-validator
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- Verificado data-cy en TODOS los componentes del feature
-- Validada nomenclatura: `{entity}-{component}-{detail}`
-- Documentado selectores en `tests.md` para qa-automation
-- Verificado NO hay strings hardcodeados
-- Validadas traducciones en theme/plugin correcto
-- Verificado namespace NO colisiona con core
-- Iniciado Playwright y navegado pantallas
-- Verificado NO hay errores de next-intl en consola
-
-**Correcciones Realizadas:**
-- [Lista de data-cy agregados/corregidos]
-- [Lista de traducciones agregadas/corregidas]
-- [Lista de strings hardcodeados corregidos]
-
-**Documentación en tests.md:**
-- [X] componentes documentados con selectores data-cy
-- [X] table de selectores lista para qa-automation
-
-**Próximo Paso:**
-- functional-validator puede comenzar Fase 5: Functional Validation
-- Verificará coherencia AC vs implementación
-
-**Notas:**
-- [Cualquier nota sobre estándares de frontend]
-- [Patrones de data-cy utilizados]
-
----
-
-### [YYYY-MM-DD HH:MM] - functional-validator
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- Verificado que progress.md fue actualizado por developers
-- Leído cada AC de clickup_task.md
-- Inspeccionado código para verificar implementación de cada AC
-- Ejecutado spot-checks funcionales con Playwright
-- Corregido issues menores directamente
-
-**Validación de Criterios de Aceptación:**
-- AC1: ✅/❌ [Descripción breve]
-- AC2: ✅/❌ [Descripción breve]
-- AC3: ✅/❌ [Descripción breve]
-
-**Correcciones Realizadas:**
-- [Lista de issues menores corregidos]
-
-**Issues Mayores (Requieren Developer):**
-- [Si hay issues mayores que no se pudieron corregir]
-
-**Próximo Paso:**
-- qa-automation puede comenzar Fase 6: QA Automation
-- Leerá tests.md para selectores data-cy documentados
-
-**Notas:**
-- [Notas sobre coherencia de implementación]
-- [Observaciones sobre calidad]
-
----
-
-### [YYYY-MM-DD HH:MM] - qa-automation
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- Leído tests.md para obtener selectores data-cy
-- Analizados tests a crear/modificar/eliminar
-- Creados API tests con BaseAPIController
-- Creados UAT tests con POMs
-- Ejecutados tests UNO POR UNO
-- Loop fix-retry hasta 100% pass
-
-**Resultados de Tests:**
-- **API Tests:** [X] passed, [Y] failed
-- **UAT Tests:** [X] passed, [Y] failed
-- **Total Coverage:** [X]%
-
-**Tests Creados/Modificados:**
-- `cypress/e2e/api/[feature].cy.ts` - [X] tests
-- `cypress/e2e/uat/[feature].cy.ts` - [X] tests
-- `cypress/support/pom/[Feature]Page.ts` - POM creado/actualizado
-
-**Resultado QA Automation:**
-- ✅ **TODOS LOS TESTS PASAN** - 100% pass rate
-- ⚠️ **PASÓ CON CORRECCIONES** - Tests corregidos durante ejecución
-- 🚫 **FEATURE BROKEN** - Requiere intervención de developer
-
-**Documentación en tests.md:**
-- Resultados escritos en sección superior de tests.md
-- Coverage documentado
-- Issues encontrados y resueltos documentados
-
-**Próximo Paso:**
-- [Si OK] code-reviewer puede comenzar Fase 7: Code Review
-- [Si feature broken] backend/frontend developer debe corregir
-
-**Notas:**
-- [Screenshots de tests si relevante]
-- [Notas sobre patrones de testing usados]
-
----
-
-### [YYYY-MM-DD HH:MM] - code-reviewer
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- Leída tarea completa de ClickUp
-- Checkout feature branch: `feature/[feature-name]`
-- Revisados [X] archivos modificados
-- Verificado cumplimiento de .rules/ del proyecto
-- Analizada seguridad (dual auth, validación, sanitización)
-- Evaluada performance (bundle size, React optimization, DB queries)
-- Revisada calidad de código (TypeScript, patrones, tests)
-
-**Resultado Code Review:**
-- ✅ **APROBADO** - Listo para merge
-- ⚠️ **APROBADO CON SUGERENCIAS OPCIONALES** - Puede hacer merge, sugerencias opcionales
-- 🚨 **CAMBIOS REQUERIDOS** - Debe corregir problemas críticos antes de merge
-
-**Problemas Críticos:**
-[Si hay problemas críticos, listar. Si no, escribir "Ninguno"]
-- **Issue #1:** [Descripción] - Ubicación: `file.ts:line` - [Solución requerida]
-
-**Sugerencias Opcionales:**
-- **Sugerencia #1:** [Performance optimization] - Impact: [HIGH/MEDIUM/LOW]
-- **Sugerencia #2:** [Best practice] - Impact: [HIGH/MEDIUM/LOW]
-
-**Lo Que Se Hizo Bien:**
-- [Observación positiva #1]
-- [Observación positiva #2]
-
-**Acción Tomada en ClickUp:**
-- Publicado review completo como comentario en ClickUp (EN ESPAÑOL)
-- Notificado @[usuario-asignado] con resumen y próximos pasos
-- Tarea permanece en "qa" (code-reviewer NO cambia estado)
-
-**Próximo Paso:**
-- [Si aprobado] unit-test-writer puede comenzar Fase 8: Unit Testing
-- [Si cambios requeridos] Humano decide: volver a desarrollo o implementar sugerencias
-
-**Notas:**
-- Review completo disponible en comentario de ClickUp (si no es LOCAL_ONLY)
-- [Notas adicionales sobre el code review]
-
----
-
-### [YYYY-MM-DD HH:MM] - unit-test-writer
-
-**Estado:** ✅ Completado / ⚠️ Completado con pendientes / 🚫 Bloqueado
-
-**Trabajo Realizado:**
-- Analizado código implementado en Fase 1-4
-- Identificada lógica de negocio que requiere unit tests
-- Identificados validation schemas que requieren tests
-- Creados unit tests para backend (Zod schemas, business logic)
-- Creados unit tests para frontend (hooks, utilities)
-- Ejecutados tests hasta 100% pass
-
-**Resultados de Tests:**
-- **Backend Unit Tests:** [X] passed, [Y] failed
-- **Frontend Unit Tests:** [X] passed, [Y] failed
-- **Coverage:** [X]% (target: 80%+)
-
-**Tests Creados:**
-- `__tests__/api/[feature].test.ts` - [X] tests
-- `__tests__/validation/[feature].test.ts` - [X] tests
-- `__tests__/hooks/[feature].test.ts` - [X] tests
-
-**Próximo Paso:**
-- [Si OK] Humano valida y procede con merge
-- [Si coverage insuficiente] Agregar más tests
-
-**Notas:**
-- [Notas sobre testing patterns usados]
-- [Coverage report disponible en...]
-
----
-
-### [YYYY-MM-DD HH:MM] - [siguiente-agente]
-
-**Estado:** [Estado]
-
-**Trabajo Realizado:**
-[Descripción]
-
-**Próximo Paso:**
-[Descripción]
-
-**Notas:**
-[Notas]
-
----
-
-## **Resumen del Workflow Completo**
-
-```
-1. product-manager → Crea requirements + tarea (ClickUp opcional)
-   ↓
-2. architecture-supervisor → Crea plan técnico + session files
-   ↓
-3. backend-developer → Implementa Fase 1 (DB + API)
-   ↓
-4. frontend-developer → Implementa Fase 2 (UI + State)
-   ↓
-5. backend + frontend → Integración Fase 3
-   ↓
-6. frontend-validator → Fase 4 (data-cy, traducciones, no hardcoded)
-   ├─ Escribe selectores en tests.md
-   └─ Corrige problemas directamente
-   ↓
-7. functional-validator → Fase 5 (coherencia AC vs implementación)
-   ├─ Corrige issues menores
-   └─ Reporta issues mayores
-   ↓
-8. qa-automation → Fase 6 (API tests + UAT tests)
-   ├─ Lee selectores de tests.md
-   ├─ Loop fix-retry hasta 100% pass
-   ├─ Si feature broken → Vuelta a desarrollo
-   └─ Si OK → Continuar
-   ↓
-9. code-reviewer → Fase 7 (code review)
-   ├─ Si cambios críticos → Humano decide
-   └─ Si OK → Continuar
-   ↓
-10. unit-test-writer → Fase 8 (Jest unit tests)
-    ├─ 80%+ coverage
-    └─ Documenta resultados
-    ↓
-11. Humano → Merge + Deploy + Marca "done" (si usa ClickUp)
-```
-
----
-
-## **Convenciones de Este Archivo**
-
-1. **Cada agente DEBE agregar su entrada al terminar**
-2. **Formato: `### [YYYY-MM-DD HH:MM] - [agent-name]`**
-3. **Siempre incluir estado: ✅ Completado / ⚠️ Con pendientes / 🚫 Bloqueado**
-4. **Ser específico sobre trabajo realizado (no vago)**
-5. **Documentar decisiones significativas**
-6. **Ser claro sobre próximos pasos para el siguiente agente**
-7. **Agregar notas relevantes/advertencias**
-
----
-
-**Última actualización:** [YYYY-MM-DD HH:MM] por [agent-name]

package/dist/presets/ai-workflow/claude/tools/sessions/templates/pendings.md

@@ -1,127 +0,0 @@
-# Pendientes: [Feature Name]
-
-**Session:** `.claude/sessions/YYYY-MM-DD-feature-name-v1/`
-**Version:** v1
-**Created:** YYYY-MM-DD
-**Last Updated:** YYYY-MM-DD HH:MM
-**Status:** Sin pendientes
-
----
-
-## Resumen
-
-**Total Pendientes:** 0
-**Prioridad Alta:** 0
-**Prioridad Media:** 0
-**Prioridad Baja:** 0
-
----
-
-## Pendientes para Futuras Iteraciones
-
-No hay pendientes documentados para esta sesión.
-
----
-
-<!--
-INSTRUCCIONES PARA DOCUMENTAR PENDIENTES:
-
-Cuando se detecte un pendiente, agregar una entrada usando el siguiente formato:
-
-### P1: [Título del Pendiente]
-
-**Detectado por:** [agent-name]
-**Fecha:** YYYY-MM-DD
-**Prioridad:** Alta / Media / Baja
-**Categoría:** Feature / Bug / Refactor / Performance / Security / UX / Documentation
-
-**Descripción:**
-[Descripción detallada de qué quedó sin resolver]
-
-**Razón para Postergar:**
-[Por qué se decidió dejarlo para una futura iteración]
-- [ ] Tiempo insuficiente
-- [ ] Fuera del alcance actual
-- [ ] Requiere decisión de producto
-- [ ] Dependencia externa
-- [ ] Complejidad técnica alta
-- [ ] Otro: [especificar]
-
-**Impacto de No Resolverlo:**
-[Qué consecuencias tiene dejar esto pendiente]
-- Funcionalidad afectada: [descripción]
-- Usuarios afectados: [quiénes]
-- Riesgo: [bajo/medio/alto]
-
-**Recomendación para v[X+1]:**
-[Qué se debería hacer en la siguiente iteración]
-1. [Paso recomendado 1]
-2. [Paso recomendado 2]
-3. [Paso recomendado 3]
-
-**Archivos Relacionados:**
-- `path/to/file1.ts` - [descripción]
-- `path/to/file2.tsx` - [descripción]
-
-**Acceptance Criteria Afectados:**
-- AC[X]: [descripción de cómo afecta]
-
----
-
-EJEMPLO DE USO:
-
-### P1: Implementar paginación en lista de productos
-
-**Detectado por:** frontend-developer
-**Fecha:** 2025-12-11
-**Prioridad:** Media
-**Categoría:** Feature
-
-**Descripción:**
-La lista de productos actualmente carga todos los items de una vez. Para datasets grandes (>100 productos), esto causa problemas de performance.
-
-**Razón para Postergar:**
-- [x] Fuera del alcance actual
-- [x] Tiempo insuficiente
-
-**Impacto de No Resolverlo:**
-- Funcionalidad afectada: Lista de productos con muchos items
-- Usuarios afectados: Usuarios con catálogos grandes
-- Riesgo: medio
-
-**Recomendación para v2:**
-1. Implementar paginación server-side en API `/api/v1/products`
-2. Agregar componente de paginación en UI
-3. Implementar infinite scroll como alternativa
-4. Agregar tests E2E para paginación
-
-**Archivos Relacionados:**
-- `app/api/v1/products/route.ts` - Agregar params de paginación
-- `app/products/ProductList.tsx` - Agregar UI de paginación
-
-**Acceptance Criteria Afectados:**
-- AC3: "Lista debe mostrar productos" - parcialmente cumplido sin paginación
-
--->
-
----
-
-## Historial de Sesiones
-
-| Versión | Fecha | Pendientes Resueltos | Nuevos Pendientes |
-|---------|-------|---------------------|-------------------|
-| v1 | YYYY-MM-DD | N/A (primera versión) | 0 |
-
----
-
-## Notas
-
-[Notas adicionales sobre decisiones de alcance o contexto relevante]
-
----
-
-**Próxima Iteración:** Si se necesita continuar con este feature, crear sesión `YYYY-MM-DD-feature-name-v2` y referenciar este archivo en el nuevo plan.
-
----
-
-**Última actualización:** YYYY-MM-DD HH:MM por [agent-name]