From bf48beae649c89dc65c2372602e44786aa4da562 Mon Sep 17 00:00:00 2001 From: fn-registry agent Date: Wed, 17 Jun 2026 10:37:12 +0200 Subject: [PATCH] chore: sync from fn-registry agent --- .claude/commands/anadir_contexto_aurgi.md | 71 ++++++++++++++ .claude/commands/aumentar_task.md | 107 ++++++++++++++++++++++ .claude/commands/contexto_aurgi.md | 76 +++++++++++++++ .gitignore | 5 + project.md | 10 ++ vaults/vault.yaml | 9 ++ 6 files changed, 278 insertions(+) create mode 100644 .claude/commands/anadir_contexto_aurgi.md create mode 100644 .claude/commands/aumentar_task.md create mode 100644 .claude/commands/contexto_aurgi.md create mode 100644 .gitignore create mode 100644 project.md create mode 100644 vaults/vault.yaml diff --git a/.claude/commands/anadir_contexto_aurgi.md b/.claude/commands/anadir_contexto_aurgi.md new file mode 100644 index 0000000..64b3485 --- /dev/null +++ b/.claude/commands/anadir_contexto_aurgi.md @@ -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 # forzar area +/aurgi:anadir_contexto_aurgi / # 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 `/*.md` existentes. + - Opcion final: "Crear archivo nuevo en `/`". + +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 `# ` + 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. diff --git a/.claude/commands/aumentar_task.md b/.claude/commands/aumentar_task.md new file mode 100644 index 0000000..e4c6225 --- /dev/null +++ b/.claude/commands/aumentar_task.md @@ -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). +- `/.md` — documentos por dominio (talleres, autingo, ADAS, B2B, IT, etc.). +- `pendiente_anadir.md` — backlog de contexto pendiente. + +## Sintaxis + +``` +/aurgi:aumentar_task +``` + +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 `/*.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 (`/.md`) si lo aprendido lo justifica y volver a preguntar si quedan gaps. + +4. **Componer borrador**. Estructura sugerida: + ```markdown + ## Titulo + + + ## Contexto + <2-4 frases ubicando en area / sistema / centro> + + ## Objetivo + + + ## Pasos sugeridos + 1. ... + 2. ... + + ## Referencias + - /.md + - + + ## Tags + aurgi, , + ``` + +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`. diff --git a/.claude/commands/contexto_aurgi.md b/.claude/commands/contexto_aurgi.md new file mode 100644 index 0000000..cc7fff8 --- /dev/null +++ b/.claude/commands/contexto_aurgi.md @@ -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 # solo un area: operaciones, tpv, lunas, flotas, ... +/aurgi:contexto_aurgi --deep # 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 `/`. + - 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 + - + ``` + +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. diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..29f4107 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +apps/*/ +analysis/*/ +vaults/* +!vaults/.gitkeep +!vaults/vault.yaml diff --git a/project.md b/project.md new file mode 100644 index 0000000..224110a --- /dev/null +++ b/project.md @@ -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`. diff --git a/vaults/vault.yaml b/vaults/vault.yaml new file mode 100644 index 0000000..55ad38c --- /dev/null +++ b/vaults/vault.yaml @@ -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]