Baton 0.4.1: flujo de inicio, módulos iterables y correcciones del piloto

.github/workflows/pruebas.yml

@@ -24,6 +24,22 @@ jobs:
       - name: Instalar PyYAML
         run: pip install pyyaml
       - name: Compilar baton.py
-        run: python -m py_compile skills/baton-setup/assets/baton.py
+        run: python -m py_compile skills/baton-start/assets/baton.py
       - name: Prueba de punta a punta
         run: bash pruebas/e2e.sh
+      - name: Validar el frontmatter de las skills
+        run: |
+          python - <<'PY'
+          import pathlib, re, sys, yaml
+          errores = 0
+          for f in sorted(pathlib.Path("skills").glob("*/SKILL.md")):
+              m = re.match(r"---\n(.*?)\n---", f.read_text(encoding="utf-8"), re.S)
+              try:
+                  fm = yaml.safe_load(m.group(1)) if m else None
+                  assert fm and fm.get("name") == f.parent.name, "name debe ser igual a la carpeta"
+                  assert 0 < len(fm.get("description", "")) <= 1024, "description vacía o de más de 1024 caracteres"
+                  print(f"ok {f}")
+              except Exception as e:
+                  errores += 1; print(f"ERROR {f}: {e}")
+          sys.exit(1 if errores else 0)
+          PY

CHANGELOG.md

@@ -2,6 +2,54 @@
 
 El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/). Las versiones son de la metodología. El campo `formato` de los archivos tiene su propia numeración.
 
+## [0.4.1] - 2026-11-04
+
+Correcciones que salieron de los intentos 2 y 3 del piloto (defectos D7 a D23 de `pruebas/BITACORA-piloto.md`).
+
+### Cambiado
+- **El humano solo aprueba lo que tiene en pantalla.** `baton-item` primero resuelve las decisiones abiertas, después muestra los criterios y los slices en texto, y al final pide la aprobación. `baton-approve` muestra una tabla con cada criterio junto a lo que comprueba su test antes de preguntar.
+- **Abrir un módulo** tiene una sola confirmación: primero las preguntas abiertas, después alcance, riesgos, configuración e ítems a la vista, y una aprobación.
+- Las decisiones con opciones se preguntan con la herramienta interactiva del entorno; lo abierto, en texto. La configuración inicial va en dos tandas de hasta 4 preguntas.
+- `baton-start` cierra con tablas (visión, configuración, mapa de módulos) y propone el nombre del proyecto a partir del producto, no de la carpeta.
+- Cada skill trae las reglas que necesita, para que el agente no lea el código de `baton.py`.
+- El router anuncia siempre `Rol · Paso · Sobre`, y `baton-module` se activa también ante "¿qué módulos faltan?".
+- `baton-module` propone los módulos candidatos en una pregunta de selección múltiple y pide un motivo de fondo para cada cambio del mapa.
+- El autor de tests puede probar una implementación desechable, fuera del repositorio, solo si duda de que un test se pueda poner en verde.
+- **Primer congelado sin commit intermedio:** el hook acepta congelar un test por primera vez si su ítem no estaba congelado en el commit anterior. El driver sigue sin poder congelar tests nuevos de un ítem ya congelado.
+- Un ítem puede volver de `Pendiente` a `Candidato` ("para después").
+
+### Corregido
+- `init --hook` reinstala su propio hook, y `baton/bin/baton.py init` ya no falla al copiarse sobre sí mismo.
+- `validar` avisa si el verificador no tiene entidad: en Delegado se activa a la fuerza.
+- El lock ya no congela los `.pyc` de `__pycache__`.
+- El mapa de módulos corta el objetivo por palabra.
+
+## [0.4.0] - 2026-11-03
+
+Cambios que salieron de la primera prueba piloto.
+
+### Agregado
+- **Entender antes de decidir** (principio 8). `baton-start` detecta si el proyecto es nuevo o existente:
+  - proyecto nuevo: entrevista corta inspirada en el *inception* de producto;
+  - proyecto existente: análisis acotado con un resumen de lo que no se pudo confirmar.
+
+  En los dos casos escribe la visión, y el humano la confirma antes de configurar nada.
+- **Escala y stack**: la recomendación de stack depende de la escala (prototipo, MVP, producto pequeño, empezar pequeño y migrar fácil, gran escala). Queda en ADR-0001, con condiciones para revisarla.
+- **Mapa de módulos** como backlog base, iterable: se agregan, dividen, fusionan o descartan módulos. Los módulos tienen ciclo de vida (`Candidato`, `Planificado`, `Activo`, `Cerrado`, `Descartado`).
+- **Tipo de backlog** principal (historia, requerimiento o ticket) más auxiliares (bug, técnico), con una plantilla por tipo.
+- `baton.py detectar`: stack, tests y comandos sin gastar tokens.
+- Plantillas de visión y de ADR.
+- El sync registra los cambios de la visión y de los ADR.
+
+### Cambiado
+- Hay un único punto de entrada, el router **`/baton`**, que sirve para empezar ("empecemos") y para seguir ("continúa"). Anuncia el rol y el paso, y las demás skills se pueden seguir llamando directamente.
+- `baton-setup` pasa a ser `baton-start`.
+- `baton-kickoff` pasa a ser `baton-module`, que ahora también define los ítems del módulo.
+- `baton-refine` y `baton-plan` se unen en `baton-item`, con una sola confirmación.
+- `baton-next` pasa a ser `baton`.
+- Un ítem solo pasa a `Listo` si su módulo está `Activo`.
+- Las skills ya no mandan a leer la documentación de la metodología: lo que el agente necesita está en la skill, en sus referencias y en las plantillas.
+
 ## [0.3.0] - 2026-11-03
 
 ### Agregado