chore: sync from fn-registry agent

2026-06-17 10:37:12 +02:00
commit bf48beae64
6 changed files with 278 additions and 0 deletions
@@ -0,0 +1,71 @@
+---
+description: "Anade o modifica contexto en projects/aurgi/vaults/repositorio_aurgi/CONTEXTO_USUARIOS/context. Pregunta area, archivo destino, tipo de aporte y persiste el cambio. Mantiene INDEX.md sincronizado."
+---
+
+# /aurgi:anadir_contexto_aurgi — escribir/modificar contexto
+
+Permite que el usuario amplie el conocimiento que Claude tiene de Aurgi. Cada llamada anade un fragmento nuevo o edita uno existente bajo `projects/aurgi/vaults/repositorio_aurgi/CONTEXTO_USUARIOS/context/`.
+
+## Sintaxis
+
+```
+/aurgi:anadir_contexto_aurgi                       # modo interactivo, pregunta todo
+/aurgi:anadir_contexto_aurgi <area>                # forzar area
+/aurgi:anadir_contexto_aurgi <area>/<archivo>      # forzar archivo concreto
+```
+
+## Flujo
+
+1. **Recibir aporte**. Si no lo da el usuario en el comando, preguntar:
+   - "Pega o describe el contexto a anadir."
+
+2. **Resolver area con AskUserQuestion** (opciones tomadas de los subdirs reales del vault):
+   - operaciones / tpv / comercial / lunas / flotas / tecnico / legal / innovacion / calidad / call_center / compras / digital / financiero / migracion_navision_tpv / rrhh.
+
+3. **Resolver archivo destino con AskUserQuestion**:
+   - Listar `<area>/*.md` existentes.
+   - Opcion final: "Crear archivo nuevo en `<area>/`".
+
+4. **Resolver modo con AskUserQuestion**:
+   1. Anadir nueva seccion al final del archivo.
+   2. Insertar dentro de seccion existente (pedir cual).
+   3. Reemplazar seccion existente.
+   4. Crear archivo nuevo (solo si en paso 3 se eligio esa opcion).
+
+5. **Aplicar cambio**:
+   - `Read` el archivo objetivo.
+   - `Edit` (o `Write` si es nuevo) preservando estilo: encabezados `##`, listas, sin emojis.
+   - Si crea archivo nuevo:
+     - Cabecera `# <Titulo>` + parrafo intro.
+     - Frontmatter NO obligatorio (vault es markdown plano).
+     - Anadir entrada al `INDEX.md` del area correspondiente.
+
+6. **Actualizar INDEX.md raiz** (`context/INDEX.md`) si:
+   - Se creo archivo nuevo.
+   - Se renombro/movio uno existente.
+
+7. **Quitar de `pendiente_anadir.md`** si la entrada estaba listada alli.
+
+8. **Confirmar al usuario** mostrando diff resumido (archivo + lineas anadidas/modificadas) y preguntar si commit:
+   - Si si: commit en el sub-repo del vault si lo tiene, o en `fn_registry` segun donde viva fisicamente el archivo. NO push automatico (usuario lanza `/full-git-push` cuando quiera).
+
+## Reglas
+
+- NUNCA inventar contenido. Si el usuario da datos vagos, pedir aclaracion antes de escribir.
+- Preservar tono y estilo existente (no markdown decorativo, no emojis).
+- Mantener `INDEX.md` como mapa autoritativo — si un agregado lo invalida, actualizarlo en el mismo turno.
+- Si el cambio afecta a glosario / lista de sistemas / lista de centros, propagar a `contexto_aurgi.md`.
+- No tocar `data/` salvo que el usuario lo pida explicitamente (es para datos, no documentacion).
+- Sin frontmatter YAML — el vault es markdown plano, no indexado por `fn index`.
+
+## Cuando usarlo
+
+- Usuario menciona algo nuevo durante una sesion ("ahora hacemos X" / "el centro Y tiene Z").
+- Tras `/aurgi:aumentar_task` cuando aparecen entidades no documentadas.
+- Limpieza periodica de `pendiente_anadir.md`.
+
+## Gotchas
+
+- El vault es symlink a `~/vaults/repositorio_aurgi/`. Escribir via path relativo al repo escribe en el destino real — no romper el symlink.
+- Si el archivo destino tiene >500 lineas, considerar dividir en sub-archivos antes de seguir engordandolo.
+- Cambios sensibles (datos de clientes, contratos legales) NO van al vault publico — preguntar antes si el aporte podria ser confidencial.
@@ -0,0 +1,107 @@
+---
+description: "Enriquece una tarea de Aurgi con preguntas numeradas 1/2/3/4. Usa el contexto en projects/aurgi/vaults/repositorio_aurgi/CONTEXTO_USUARIOS/context para proponer opciones realistas. Al cerrar, sube la tarea al kanban o destino elegido."
+---
+
+# /aurgi:aumentar_task — enriquecer tarea con contexto Aurgi
+
+Convierte una tarea cruda en una tarea bien especificada, lista para subir al kanban (o a un issue, flow, diario). Claude pregunta al usuario opciones numeradas (1/2/3/4) basadas en el contexto real de la empresa para que la respuesta sea trivial.
+
+## Fuente de contexto
+
+Carpeta canonica: `projects/aurgi/vaults/repositorio_aurgi/CONTEXTO_USUARIOS/context/`
+
+- `INDEX.md` — mapa por areas (innovacion, operaciones, legal, flotas, tecnico, tpv, comercial, calidad, call_center, compras, digital, financiero, lunas, migracion_navision_tpv, rrhh).
+- `contexto_aurgi.md` — vision general empresa (Mutua Madrileña, ~162 centros, lineas de negocio).
+- `<area>/<tema>.md` — documentos por dominio (talleres, autingo, ADAS, B2B, IT, etc.).
+- `pendiente_anadir.md` — backlog de contexto pendiente.
+
+## Sintaxis
+
+```
+/aurgi:aumentar_task <descripcion cruda de la tarea>
+```
+
+Si se invoca sin argumento, Claude pregunta primero por el enunciado.
+
+## Flujo
+
+1. **Leer contexto relevante**. Antes de preguntar nada:
+   - `Read INDEX.md` para identificar areas implicadas.
+   - `Read` los `<area>/*.md` que parezcan tocar la tarea (max 3-4 archivos).
+   - Si no esta claro, leer `contexto_aurgi.md` para encuadrar.
+
+2. **Preguntar con AskUserQuestion**. Maximo 4 preguntas por ronda, cada una con 2-4 opciones tomadas del contexto leido. Categorias tipicas:
+   - **Area/dominio** (operaciones / tpv / comercial / IT / flotas / lunas / ...).
+   - **Centro o ambito** (centro concreto / red Aurgi / red Motortown / Glass / B2B / online).
+   - **Sistema afectado** (Navision / TPV / Autingo / aurgi.com / Metabase / BigQuery / ...).
+   - **Prioridad** (critica / alta / media / baja).
+   - **Tipo** (bug / feature / refactor / chore / analisis / decision).
+   - **Output esperado** (card kanban / issue dev/ / flow dev/ / entrada diario / PR / informe).
+
+   Las opciones deben venir del contexto real, no genericas. Ej: si la tarea menciona "lunas", proponer "Aurgi Glass", "calibracion ADAS", "Mutua flotas", etc.
+
+3. **Iterar**. Tras cada ronda de respuestas, releer contexto especifico (`<area>/<tema>.md`) si lo aprendido lo justifica y volver a preguntar si quedan gaps.
+
+4. **Componer borrador**. Estructura sugerida:
+   ```markdown
+   ## Titulo
+   <titulo conciso>
+
+   ## Contexto
+   <2-4 frases ubicando en area / sistema / centro>
+
+   ## Objetivo
+   <que hay que conseguir, criterio de "hecho">
+
+   ## Pasos sugeridos
+   1. ...
+   2. ...
+
+   ## Referencias
+   - <area>/<archivo>.md
+   - <enlace a Metabase / repo / ticket>
+
+   ## Tags
+   aurgi, <area>, <sistema>
+   ```
+
+5. **Confirmar destino con AskUserQuestion**:
+   - Kanban (board principal o uno especifico).
+   - Issue del registry (`/issue create`).
+   - Flow del registry (`/flow create`).
+   - Entrada de diario (`/entrada_diario`).
+   - Solo guardar borrador (devolver markdown sin subirlo).
+
+6. **Subir**:
+   - **Kanban**: usar `mcp__kanban__create_card` con titulo + descripcion + tags. Pedir confirmacion del board/columna si hay duda.
+   - **Issue**: invocar `/issue create` con args (`--type`, `--domain`, `--prio`).
+   - **Flow**: `/flow create`.
+   - **Diario**: `/entrada_diario`.
+
+7. **Capturar contexto nuevo** (post-task). Tras subir la tarea, repasar el hilo: ¿aparecio info que NO estaba en `context/` y que sera util para futuras tareas? Tipico:
+   - **Sistemas/servicios** mencionados sin documentar (ej. `happy_robot`, `aurgi_movimientos_glass`).
+   - **Personas** nuevas con rol relevante (requesters, dueños de dashboards, owners de proceso).
+   - **Tablas BigQuery / columnas / formulas** mencionadas como dato canonico (ej. "venta = base_imponible", "centros Glass = subset con flag X").
+   - **URLs de dashboards** ya en uso como fuente de verdad.
+   - **Procesos operativos** descritos por el usuario al aclarar la tarea.
+
+   Si aparece info de este tipo, **proponer al usuario lanzar `/aurgi:anadir_contexto_aurgi`** con un resumen de lo que captarias. No esperar a que el usuario lo pida — sugerirlo proactivamente al cerrar la tarea. Si dice no, anotar en `pendiente_anadir.md` la pista para otro dia.
+
+## Reglas
+
+- NUNCA inventar datos del contexto. Si una opcion no esta soportada por `context/`, marcarla "(no documentado, confirmar)".
+- Si el usuario menciona un centro/sistema/persona que no aparece en el contexto, ofrecer al final ejecutar `/aurgi:anadir_contexto_aurgi` para incorporarlo (ver paso 7).
+- Maximo 3 rondas de preguntas. Si tras 3 rondas no hay claridad, abrir borrador parcial y dejar `TBD:` en los huecos.
+- Respuestas del usuario via 1/2/3/4 son obligatorias — no continuar hasta tenerlas.
+
+## Cuando usarlo
+
+- Llega una tarea cruda en lenguaje natural ("hay que mirar lo de Navision").
+- Antes de abrir card/issue para que no queden vacias de contexto.
+- Cuando quieres aprender de paso (cada ronda lee mas contexto).
+
+## Gotchas
+
+- Si `INDEX.md` no cubre el area de la tarea, leer `pendiente_anadir.md` antes de proponer "no documentado".
+- El vault es symlink a `~/vaults/...`; nunca asumas ruta absoluta hardcoded — usa la relativa al repo.
+- Tarea con multiples areas: pregunta por la principal y registra el resto en `Tags`.
@@ -0,0 +1,76 @@
+---
+description: "Aprende el contexto de Aurgi leyendo projects/aurgi/vaults/repositorio_aurgi/CONTEXTO_USUARIOS/context. Devuelve un resumen estructurado por area para que Claude opere informado el resto de la sesion."
+---
+
+# /aurgi:contexto_aurgi — cargar contexto de empresa
+
+Lee el vault de contexto y devuelve un resumen estructurado. Sirve para arrancar una sesion sabiendo de que va Aurgi sin tener que abrir 18 archivos a mano.
+
+## Sintaxis
+
+```
+/aurgi:contexto_aurgi                 # resumen completo (todas las areas)
+/aurgi:contexto_aurgi <area>          # solo un area: operaciones, tpv, lunas, flotas, ...
+/aurgi:contexto_aurgi --deep <area>   # area + lectura completa de sus archivos
+```
+
+Areas validas: operaciones, tpv, comercial, lunas, flotas, tecnico, legal, innovacion, calidad, call_center, compras, digital, financiero, migracion_navision_tpv, rrhh.
+
+## Flujo
+
+1. **Read INDEX.md** (`projects/aurgi/vaults/repositorio_aurgi/CONTEXTO_USUARIOS/context/INDEX.md`).
+2. **Read contexto_aurgi.md** (vision general).
+3. Por cada area pedida (o todas si no se especifica):
+   - Listar archivos de `<area>/`.
+   - Leer los `.md` (en modo deep) o solo la cabecera + primer parrafo (modo normal).
+4. **Componer resumen** estructurado:
+
+   ```markdown
+   # Contexto Aurgi — resumen sesion
+
+   ## Empresa
+   <2-3 frases: propietario, tamaño, ambito>
+
+   ## Lineas de negocio
+   - Aurgi (autocentros propios/franquicia)
+   - Motortown (El Corte Ingles)
+   - Aurgi Glass (lunas + ADAS)
+   - Autingo (canal digital)
+   - B2B flotas
+
+   ## Areas y sistemas clave
+   | Area | Que hay | Sistemas |
+   |---|---|---|
+   | Operaciones | OTRs, productividad | Navision, Metabase |
+   | TPV | venta tienda | TPV, Navision |
+   | ...
+
+   ## Glosario
+   - **OTR** — orden de reparacion
+   - **ADAS** — sistemas avanzados de asistencia al conductor
+   - ...
+
+   ## Referencias rapidas
+   - INDEX.md
+   - <archivos leidos>
+   ```
+
+5. Si se leyo `pendiente_anadir.md`, listar al final lo que falta documentar.
+
+## Reglas
+
+- NUNCA inventar. Si no esta en el vault, no aparece en el resumen.
+- En modo normal limita lectura completa a `INDEX.md` + `contexto_aurgi.md` + cabeceras del resto.
+- Modo `--deep` lee todo el area (puede consumir contexto — usar con criterio).
+- No persistir el resumen — es output efimero. Si el usuario quiere persistirlo, ofrece `/aurgi:anadir_contexto_aurgi`.
+
+## Cuando usarlo
+
+- Inicio de sesion sobre tarea Aurgi.
+- Antes de `/aurgi:aumentar_task` para precargar contexto si la tarea es transversal.
+- Para refrescar memoria sobre un area que no se toca hace tiempo.
+
+## Gotchas
+
+- El vault es symlink. `Read` con path relativo al repo funciona; absolutos no portables entre PCs.
+- Tras `/aurgi:anadir_contexto_aurgi` el resumen anterior queda obsoleto — relanzar para refrescar.
@@ -0,0 +1,5 @@
+apps/*/
+analysis/*/
+vaults/*
+!vaults/.gitkeep
+!vaults/vault.yaml
@@ -0,0 +1,10 @@
+---
+name: aurgi
+description: "Proyecto Aurgi — datos, analisis y apps relacionadas con el repositorio Aurgi."
+tags: [aurgi, data]
+repo_url: ""
+---
+
+## Notas
+
+Vault principal apunta a `/home/egutierrez/code_proyects/repositorio_aurgi`.
@@ -0,0 +1,9 @@
+vaults:
+  - name: repositorio_aurgi
+    description: "Repositorio principal de datos Aurgi"
+    path: /home/egutierrez/code_proyects/repositorio_aurgi
+    tags: [aurgi, data]
+  - name: aurgi_footprint
+    description: "Datos del proyecto footprint Aurgi: tasaciones, centros, isocronas, IGN callejero, tiles Valhalla."
+    path: /home/egutierrez/vaults/aurgi_footprint
+    tags: [aurgi, footprint, geo, valhalla, ign]