# Skill: Mapa de Sistemas — Género Valor

Skill interno del equipo de consultoría de Género Valor para generar el Mapa de Sistemas de un cliente a partir de entrevistas de levantamiento tecnológico.

## Estructura del paquete

```
mapa-de-sistemas/
├── SKILL.md                   ← Metodología completa, reglas duras, flujo conversacional
├── README.md                  ← Este archivo (instalación y uso)
├── prompts/                   ← Biblioteca de 5 prompts especializados
│   ├── 01_clasificar_inventario.md
│   ├── 02_redactar_segmento.md
│   ├── 03_areas_oportunidad.md
│   ├── 04_interconexiones.md
│   └── 05_conclusiones.md
├── templates/
│   ├── canon_dx.pptx          ← Plantilla maestra (basada en Banco Manabí, 9 slides)
│   └── canon_diagrama.drawio  ← Plantilla maestra del diagrama
├── scripts/
│   ├── parse_interview.py     ← Extrae diálogo de transcripciones Teams (.docx)
│   ├── populate_pptx.py       ← Rellena la plantilla preservando estilos
│   └── build_drawio.py        ← Genera .drawio multi-página
└── ejemplos/
    └── rent_a_pallet/         ← Caso completo de referencia
        ├── contexto.md        ← Cómo se levantó el contexto
        ├── skill_content.json ← Contenido procesado (estructura del skill)
        ├── input/             ← Las 6 entrevistas originales (.docx)
        └── output/            ← PPTX y drawio generados
```

## Instalación en Cowork / Claude Code

### Opción A — Skill privado en tu sesión

1. Copiar la carpeta `mapa-de-sistemas/` a tu directorio de skills:
   - Cowork: `~/.cowork/skills/`
   - Claude Code: `~/.claude/skills/`
2. Reiniciar la sesión.
3. Invocar con cualquier frase que mencione "mapa de sistemas para [cliente]".

### Opción B — Skill compartido del equipo (vía repositorio)

1. Subir la carpeta a un repositorio privado de Género Valor (GitHub Enterprise / GitLab).
2. Cada consultor clona el repo en su `~/.cowork/skills/`.
3. Para distribuir actualizaciones, hacer pull desde el repo.

## Dependencias

Python 3.9+ con:
```
pip install python-pptx python-docx
```

LibreOffice (`soffice`) para conversión PPTX→PDF en QA visual (opcional).

## Cómo invocar el skill

Cuando estés con un cliente, escribe en chat algo como:

> *"Empecemos un análisis del mapa de sistemas para el cliente Acme Corp. Es una empresa de retail con operación regional."*

El skill se activará automáticamente y te pedirá:
1. Contexto del cliente (industria, dolencias, sistemas core, alcance)
2. Entrevista con TI (obligatoria)
3. Entrevistas adicionales por área (si el alcance es "por área")

Después generará automáticamente:
- `Mapa de sistemas_Dx_<CLIENTE>.pptx` — siguiendo el formato Género Valor
- `Mapa de sistemas_<CLIENTE>.drawio` — diagramas editables en diagrams.net

## Lo que requiere ajuste manual posterior

Ver sección "Limitaciones conocidas v1" en SKILL.md. En resumen:
- Pills de inventario en slide 3 (EMF — editar texto en PowerPoint, ~5 min)
- Mini-cuadrante en slides 4-6 (mismo origen)
- Diagrama izquierdo en slides 7-8 (reemplazar por imagen exportada del .drawio)
- Slide 9 Plan de Adopción (editar las 3 fases con el plan específico del cliente)
- Si solo hay 1 área de oportunidad de interconexión, decidir qué hacer con slide 8

El resto (~85% del PPTX) se autopobla.

## Caso de referencia: Rent a Pallet

La carpeta `ejemplos/rent_a_pallet/` contiene un caso completo end-to-end:
- 6 entrevistas reales (TI + 5 áreas operativas)
- El `skill_content.json` con todo el análisis estructurado
- El PPTX generado por el skill
- El .drawio generado

Es el benchmark que valida que el skill funciona. Úsalo como referencia para entender qué espera el skill en cada paso.

## Soporte y siguientes versiones

- **v1.0** (actual) — Funcionalidad core: PPTX automatizado al 85%, drawio multi-página completo
- **v1.1** (próximo) — Slide 9 Plan de Adopción autopoblado, slide de tabla compacta de áreas
- **v2.0** (Fase 2) — Madurez Tecnológica (radar + tabla + badge), reemplazo automático de pills EMF

Para reportar bugs o pedir mejoras, contacto interno del equipo de consultoría.
