# spec.yml — GitHub Issue Form para proponer una Spec
# Instalar en: .github/ISSUE_TEMPLATE/spec.yml
# Qué hace: al crear un issue tipo "Spec", GitHub muestra este formulario
#           y obliga a llenar los campos mínimos antes de enviar.
name: "📋 Spec — Nueva funcionalidad"
description: "Proponer una funcionalidad describiendo el qué, no el cómo."
title: "[SPEC] "
labels: ["spec", "needs-review"]
body:
  - type: markdown
    attributes:
      value: |
        Describe **qué** debe pasar, no **cómo** implementarlo.
        Si la propuesta avanza, se desarrollará la spec completa con `spec-kit/templates/spec-template.md`.
  - type: input
    id: autor
    attributes:
      label: "Autor / PM responsable"
      placeholder: "Nombre"
    validations:
      required: true
  - type: textarea
    id: problema
    attributes:
      label: "Problema que resuelve"
      description: "¿Qué dolor del usuario o del negocio ataca esto? Con evidencia si la hay."
      placeholder: "Los usuarios abandonan el registro porque..."
    validations:
      required: true
  - type: textarea
    id: escenario
    attributes:
      label: "Escenario principal (P1)"
      description: "Como [tipo de usuario], quiero [acción] para [resultado]."
    validations:
      required: true
  - type: textarea
    id: criterios
    attributes:
      label: "Criterios de éxito medibles"
      placeholder: "- El registro se completa en menos de 2 minutos\n- Tasa de abandono < 20%"
    validations:
      required: true
  - type: textarea
    id: fuera-de-alcance
    attributes:
      label: "Lo que NO está incluido"
      description: "Declarar el fuera-de-alcance evita discusiones después."
    validations:
      required: false