fn-registry agent
108 lines
5.3 KiB
Markdown
108 lines
5.3 KiB
Markdown
---
|
|
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`.
|