Files
aurgi/.claude/commands/aumentar_task.md
T
2026-06-17 10:37:12 +02:00

5.3 KiB

description
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:

    ## 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.