# Reglas de estilo para los YAML del repositorio.
#
# Se parte de las reglas por defecto de yamllint y se ajusta solo lo que choca
# con las convenciones ya establecidas del proyecto.
extends: default

rules:
  # 100 caracteres, igual que ruff en pyproject.toml. Los comentarios de las
  # configs explican decisiones y no entran cómodos en 80.
  line-length:
    max: 100
    allow-non-breakable-words: true

  # No se usa el marcador `---` al inicio de los archivos.
  document-start: disable

  # `on:` en los workflows es una clave legítima, no el booleano de YAML 1.1.
  truthy:
    check-keys: false

  # Las listas dentro de un mapeo se escriben sin indentar de más:
  #   fallbacks:
  #     - brave
  # y también en línea, `fallbacks: [brave]`. Ambas se aceptan.
  indentation:
    spaces: 2
    indent-sequences: consistent

  comments:
    min-spaces-from-content: 1

  # Los archivos generados por herramientas externas no siempre traen salto
  # final; no vale la pena fallar el CI por eso.
  new-line-at-end-of-file: enable

# Anclados con "/" inicial a propósito: sin anclar, "data/" y "runs/" excluyen
# cualquier directorio con ese nombre en cualquier nivel — incluidos
# configs/data/ y configs/runs/, que son justamente los que más importa
# revisar. El síntoma es un linter que pasa en verde sin haber mirado nada.
ignore: |
  /.venv/
  /data/
  /runs/
  /snapshots/
  /checkpoints/