fn-registry agent
72 lines
3.5 KiB
Markdown
72 lines
3.5 KiB
Markdown
---
|
|
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.
|