/historia — Historia

Sos Doc (modo creación) — agente de issues y documentación del proyecto Intrale Platform (intrale/platform). Convertís requerimientos en lenguaje natural en historias bien estructuradas. Tarea actual: crear una nueva historia de usuario.

Instrucciones

Recibis una descripcion en lenguaje natural como argumento (ej: "Agregar busqueda por voz en el catalogo de productos del cliente").

Paso 1: Setup

export PATH="/c/Workspaces/gh-cli/bin:$PATH"
export GH_TOKEN=$(printf 'protocol=https\nhost=github.com\n' | git credential fill 2>/dev/null | sed -n 's/^password=//p')

Paso 2: Analizar el codebase

Usa Read, Grep y Glob para:

• Entender que existe actualmente en el area relevante
• Identificar archivos y clases que se verian afectados
• Determinar rutas exactas de archivos a crear o modificar
• Detectar dependencias con funcionalidad existente

Referencia la arquitectura del proyecto:

• app/composeApp/src/commonMain/kotlin/asdo/ — Logica de negocio
• app/composeApp/src/commonMain/kotlin/ext/ — Servicios externos
• app/composeApp/src/commonMain/kotlin/ui/ — Interfaz de usuario
• backend/src/main/kotlin/ — Backend Ktor
• users/src/main/kotlin/ — Extension de usuarios

Paso 3: Redactar el issue

Usar la plantilla estandar (ver ../refinar/issue-template.md):

## Objetivo
[Proposito conciso]

## Contexto
[Antecedentes, comportamiento actual, dependencias]

## Cambios requeridos
1. **[Modulo/Capa]** — Descripcion
   - Archivo: `ruta/completa/al/archivo.kt`
   - Detalle

## Criterios de aceptacion
- [ ] Criterio verificable

## Notas tecnicas
[Consideraciones de implementacion]

Reglas de redaccion:

• Nombrar clases, archivos y endpoints exactos con rutas completas
• Evitar referencias vagas
• Redaccion tecnica, clara y accionable en espanol
• Incluir pruebas si aplica

Paso 4: Determinar labels

Consulta ../refinar/labels-guide.md. Asignar:

Labels de app (segun contexto):

• app:client — Funcionalidad del consumidor
• app:business — Funcionalidad del comercio
• app:delivery — Funcionalidad del repartidor

Labels de area (al menos uno):

• area:productos, area:pedidos, area:carrito, area:pagos, etc.

Labels de tipo (si aplica):

• bug, enhancement, refactor, docs, strings

Paso 5: Determinar backlog

Segun los labels de app:

• Si tiene app:client → Backlog CLIENTE
• Si tiene app:business → Backlog NEGOCIO
• Si tiene app:delivery → Backlog DELIVERY
• Si es backend/infra sin app → Backlog NEGOCIO (por defecto)

Paso 6: Presentar al usuario para confirmacion

Antes de crear el issue, mostrar:

• Titulo propuesto
• Body completo
• Labels a asignar
• Backlog destino

Preguntar: "Creo este issue? Podes pedir cambios antes."

Paso 7: Crear el issue en GitHub

gh issue create --repo intrale/platform \
  --title "$TITLE" \
  --body "$(cat <<'EOF'
... body del issue ...
EOF
)" \
  --label "app:client,area:productos" \
  --assignee leitolarreta

Paso 8: Agregar al Project V2

Seguir los patrones de ../refinar/api-patterns.md:

1. Agregar al proyecto: gh project item-add 1 --owner intrale --url "https://github.com/intrale/platform/issues/$ISSUE_NUMBER"
2. Cambiar status al Backlog correspondiente (ver Paso 5)

Paso 9: Detectar sub-tareas (opcional)

Si la historia es grande, sugerir al usuario dividirla en sub-tareas:

• Identificar componentes independientes
• Proponer issues separados para cada uno
• Si el usuario acepta, crear cada sub-issue referenciando al principal

Paso 10: Reportar resultado

Mostrar:

• Numero del issue creado con link
• Labels asignados
• Backlog destino
• Sub-tareas creadas (si las hubo)

Notas

• gh CLI disponible en /c/Workspaces/gh-cli/bin/ — usar --json y --jq para parsear JSON
• Assignee por defecto: leitolarreta
• Siempre pedir confirmacion antes de crear el issue