CLAUDE.md — InQ ROI · Contexto estratégico del asesor

Este archivo es leído por el asesor técnico-estratégico en sesiones de Cowork. Contiene estado del proyecto, decisiones activas y referencias operativas. Las reglas de implementación (stack, código, marca en código) están en simulador-web/CLAUDE.md. El rol del asesor y el método de trabajo están en las instrucciones del proyecto (system prompt).

Estado actual del proyecto

Sprint: 4 (planificado — BRIEF listo en sprints/sprint-4/BRIEF.md) Fase: 1 — ROI y escenarios de automatización Deploy activo: https://process-cost-platform.pages.dev Usuario objetivo actual: equipo de InQuality — uso interno en talleres y con clientes en curso

Sprint 3 cerrado el 2026-05-27. Entregó: biblioteca de procesos con grupos/tags/búsqueda (Dexie v4), indicador stale de simulación, zoom BPMN fit-viewport, recursos TO-BE en escenario automatizado (motor + UI + reporte + PDF), branding InQ ROI en todas las páginas (AppHeader + favicon + logos), kit de socialización del equipo (guía de usuario, guía de pre-venta, presentación PPTX). 561 tests.

Sprint 2 cerrado el 2026-05-20. Entregó: modelo de recursos utilizationMinutes + units (migración Dexie v3), ActivityPanel "wow" con cálculo en tiempo real, reporte web con filas expandibles de desglose de recursos, edición inline de proceso/cliente, tabla de recursos en PDF (página condicional), 548 tests. Ver case study: simulador-web/methodology/CASE_STUDIES/inq-roi-sprint-2.md.

Sprint 1.5 cerrado el 2026-05-18. Entregó: identidad visual completa, PDFs de clase profesional (3 documentos), badge ⚡ en canvas BPMN, ROI con 5 KPIs, sistema de componentes establecido.

Sprint 4 — dirección estratégica

Refactorización arquitectural completa. Sin features de producto nuevas.

Auth: Supabase + Google Workspace OAuth (@inquality.com.py). Abstracción AuthService para migración futura a Keycloak.
Base de datos: reemplazo de IndexedDB/Dexie por PostgreSQL via Supabase. Datos existentes abandonados (eran solo pruebas).
Recursos globales: catálogo compartido del equipo, sin processId. Rompe modelo actual — requiere mockup aprobado antes de Etapa 7.
Privacidad: procesos con visibilidad private | team. Recursos, grupos y tags siempre compartidos. Simulaciones heredan del proceso.
Sin auditoría: diferida a sprint dedicado.
Online-only: aceptado. Offline en roadmap futuro.
Keycloak: diferido. InQuality tiene VPS desa + prod. Keycloak será el auth server de la plataforma InQuality (multi-producto).

Ver sprints/sprint-4/BRIEF.md para scope completo.

Decisiones estratégicas activas (no reabrir)

Identidad visual — estable hasta Sprint 4+

Paleta naranja #F59845, gradiente → #ED3E8F, system-ui stack, componentes establecidos. No reabrir.

Rebalanceo web/PDF — Sprint 2+

60-70% web, 15-25% PDF, 10-15% infraestructura, 5-10% docs. Origen: cierre Sprint 1.5.

Criterio de wow — obligatorio

Cada etapa con feature nueva incluye versión mínima + versión wow. Default: wow si costo extra < 40%.

Modelo de recursos — decisiones de Sprint 2

Scope: por proceso (catálogo global en Sprint 3 con feedback real)
Costo fijo: convive con recursos. Costo total = fijo + recursos.
Escenario automatizado: recursos solo en AS-IS. TO-BE sigue con automatedCostFixed.
Modelo: utilizationMinutes + units reemplaza utilizationPercent.

Modelo de escenarios — diferido

Modelo B (dos BPMNs AS-IS / TO-BE) diferido a Sprint 3. Sprint 2 mantiene Modelo A.

Múltiples simulaciones — diferido

Historial de simulaciones y comparación de escenarios diferido a Sprint 3.

Decisiones de producto pendientes de input externo

Posicionamiento: ¿herramienta interna InQuality o venta a otras consultoras? Post-Sprint 2.
Nombre comercial: "InQ ROI" es nombre de trabajo. Revisar Sprint 3-4.
Métricas de éxito: a definir con datos reales de uso interno.
Manual de marca formal: cuando exista, incorporar. Assets disponibles en assets/.

Definiciones estables — no reabrir hasta nuevo aviso

Stack tecnológico (React + Vite + TypeScript + stack definido en simulador-web/CLAUDE.md)
Modelo de escenarios: Modelo A (un BPMN, dos pares de campos por actividad)
ROI: cálculos nominales simples sin VPN ni Monte Carlo
Heatmap: colores saturados #10B981 / #F59E0B / #EF4444 (revisar Sprint 3-4)

Referencias de archivos clave

Archivo	Propósito
`simulador-web/CLAUDE.md`	Reglas de implementación para Claude Code
`simulador-web/sprints/sprint-2/BRIEF.md`	Scope completo de Sprint 2 (cerrado)
`simulador-web/methodology/CASE_STUDIES/inq-roi-sprint-2.md`	Case study Sprint 2
`simulador-web/BACKLOG.md`	Features pendientes de asignación
`simulador-web/TECH_DEBT.md`	Deuda técnica activa
`simulador-web/STRATEGIC_DIRECTION.md`	Decisiones estratégicas históricas
`simulador-web/OBSERVATIONS.md`	Hallazgos del sprint en curso
`simulador-web/methodology/`	Patrones y anti-patrones del método
`simulador-web/assets/`	Logos PNG + manual de marca PDF
`simulador-web/cowork/InQ ROI - Simulador de procesos/ARCHITECTURE.md`	Arquitectura del sistema

Herramientas externas configuradas

ClickUp: workspace InQuality — backlog operativo, tareas del sprint, observaciones
Google Drive: workspace InQuality — assets de marca, documentos compartidos
Consultar estas fuentes antes de asumir que la información está en archivos locales

Reglas del método (resumen operativo)

Detalle completo en simulador-web/methodology/. Resumen:

Validación visual mandatoria: tests verdes ≠ OK formal. Todo artefacto visual requiere validación humana del director.
Brief como contrato: ninguna etapa arranca sin ETAPA_X_PROMPT.md aprobado.
Iniciativa agéntica clasificada: Nivel 1 (trivial) → ejecutar. Nivel 2 (visible) → ejecutar y reportar. Nivel 3 (marca/arquitectura/datos) → consultar antes.
Auditoría adversarial: buscar lo que está mal, no confirmar lo que está bien.
Anti-patrón AP.8: si un reporte parece "más limpio de lo esperado", sospechar adelanto silencioso.

6.2 KiB Raw Blame History