hbox-docs/docs/agentes.md

title	description	date
Agentes del sitio	Qué hacen solos el vigía, el agente diario y el bot de standup en drogheda.helgen.online, qué dejan listo para que Leo lo apruebe y qué nunca hacen.	2026-10-27

Agentes del sitio

Desde el 27-oct-2026 el sitio tiene tres ayudantes que trabajan solos. Todo lo que hacen queda aquí mismo: en Incidencias, en el Standup, en el historial de cada pendiente y en la Bitácora. Si algo de esto no te gusta, dilo en una incidencia.

Agente	Qué es	Cuándo corre	Dónde se ve
Vigía	Un programa en el servidor, sin IA (backend/vigia.py)	Cada hora, en el minuto 7	Incidencias con origen «vigía»
Agente diario	Claude, como tarea programada en la Mac de Leo	Lunes a viernes, 6:37 pm	Comentarios en cada incidencia, ramas agente/… en git.helgen.online, lote del día
Bot de standup	El mismo agente diario	En la misma corrida: deja listo el standup del siguiente día hábil	Standup y la franja azul de arriba

El vigía

Revisa cada hora y abre una incidencia cuando algo se repite (si ya hay una abierta igual, le suma una ocurrencia):

• Entradas: alguien con 3 o más intentos fallidos en 24 horas y ninguno bueno después. La incidencia dice el motivo y una pista (Bloq Mayús, mayúscula que puso el teléfono, espacio de más). Nunca guarda contraseñas.
• Servidor: errores de Python y respuestas 5xx del backend.
• Navegadores: el mismo error de JavaScript, o la misma llamada que falla, 3 veces o por 2 personas.
• Salud: que el backend conteste, que el archivo de usuarios tenga sus permisos (leo:www-data 640), que haya disco.
• Configuración: que el servicio instalado en el servidor diga lo mismo que el del repositorio (administradores, actas repetibles). Así se habría visto el 27-oct que el servicio instalado a mano dejó fuera la prueba Ethernet/serie.

El agente diario

Cada tarde lee las incidencias abiertas, el reporte del vigía y los errores, y actúa con estas reglas:

Lo hace solo (no necesita autorización)

1. Atender: clasificar (tipo y gravedad), decir quién la atiende, juntar duplicadas y contestar en la incidencia qué encontró y qué sigue. Si falta información, la pide ahí mismo a quien reportó.
2. Reproducir la falla en una copia del sitio con datos de prueba y escribir la causa.
3. Arreglar lo que es solo de páginas — textos, ligas rotas, estilos, el JavaScript de los tableros — en una copia limpia del repositorio: prueba (mkdocs build --strict, pruebas del backend, vista en claro, oscuro y teléfono), guarda el cambio en git.helgen.online con el folio de la incidencia y publica solo las páginas si la comparación con el servidor muestra que no se lleva nada más. Después comenta en la incidencia qué cambió y cómo deshacerlo.
4. Cerrar como resuelta cuando el arreglo ya está publicado y el vigía no ve la falla en 24 horas.
5. Avisar en la entrada (aviso público, sin datos internos) cuando una falla impide entrar a varias personas.

Lo deja listo para que Leo lo apruebe

• Cualquier cambio del backend (backend/*.py), de nginx, del servicio o del servidor; reinicios y sudo.
• Lo que toca cuentas, contraseñas o permisos (también restablecer una contraseña).
• Lo que cambia datos: actas, inventario, pendientes. Los cambios del tablero van en un lote que Leo aplica (./scripts/tablero.sh revisar → aplicar), como siempre.
• Lo de la página de entrada y de las actas de campo (entrar.html, cuenta.html, formularios/): aunque sean páginas, si fallan nadie puede trabajar.

Lo deja en una rama agente/AAAA-MM-DD-INC-xxxx con su prueba, y en el resumen del día dice exactamente qué comando correr.

Nunca

Borrar nada · ver, guardar o pedir contraseñas · cambiar permisos · mandar mensajes o correos a nombre de alguien · publicar datos del proyecto en la página de entrada · tocar el archivo de parámetros 4G/NTRIP.

El bot de standup

1. Prepara para cada persona con pendientes abiertos su parte del día siguiente: instrucciones concretas (qué hacer, en qué orden, con la liga al documento) y una pregunta por pendiente. Lee el tablero, las decisiones de Ingeniería, la última junta y lo que esa persona contestó ayer.
2. Pregunta en el Standup: ¿qué terminaste?, ¿qué te falta?, ¿qué te bloquea? Cada quien contesta en 2 minutos, antes de las 10:00 (después hay llamada de 10 min) y, si lo deja marcado, sus tarjetas se mueven solas (a su nombre).
3. Resume para Leo y Adriana (pestaña Equipo): quién contestó, qué se terminó y los bloqueos con quién los destraba. Lo que falte en el tablero (comentarios, pendientes nuevos por un bloqueo) va en el lote del día para que Leo lo aplique.
4. Pide la evidencia (D-27-6): si alguien marca un pendiente como hecho sin acta, liga ni archivo, al día siguiente le pregunta dónde está. Si alguien se queda sin pendientes abiertos, no se los inventa: avisa al responsable de su área, que es quien llena el backlog.

Para ingeniería

• Código: backend/vigia.py, backend/incidencias.py, backend/standup.py, backend/acceso.py (página de entrada); instrucciones del agente: agentes/agente-diario.md en el repositorio hbox-docs; ayuda para llamar la API desde la Mac: scripts/agente-api.sh.
• El agente entra a la API por el servidor (127.0.0.1:8081, usuario claude); el vigía, como vigia.
• Cambiar estas reglas = editar esta página y agentes/agente-diario.md en el mismo cambio.