111 lines
5.5 KiB
Markdown
111 lines
5.5 KiB
Markdown
# 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:** 3 (próximo — planificación pendiente)
|
|
**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 pre-venta
|
|
|
|
**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 (7 nuevos). 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.
|
|
|
|
---
|
|
|
|
## Decisiones pendientes para Sprint 3 (no resueltas aún)
|
|
|
|
- **Modelo B (AS-IS / TO-BE):** ¿abrimos la puerta a dos BPMNs o seguimos con Modelo A y mejoramos la experiencia?
|
|
- **Catálogo global de recursos:** ¿el valor de compartir recursos entre procesos justifica la complejidad en Sprint 3, o esperar a Sprint 4?
|
|
- **Indicador de simulación desactualizada:** alto impacto en talleres, bajo esfuerzo — candidato prioritario.
|
|
- **Posicionamiento:** primera conversación comprometida post-Sprint 2 (herramienta interna vs. venta externa).
|
|
|
|
Ver backlog completo en `simulador-web/BACKLOG.md`.
|
|
|
|
---
|
|
|
|
## 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.
|