aurgi/.claude/commands/anadir_contexto_aurgi.md

description

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.