Files

T

fernandoandClaude Sonnet 5 c06037fa3b feat(runme): integrar Runme como sidecar de documentación ejecutable

Agrega RUNBOOK.md y runbooks/ (fuera de content/, para no interferir con
la publicación de Zola), con reglas de nombres/etiquetas/aislamiento de
celdas mutantes verificadas por clusterlog validate. Instalación pinneada
a v3.17.4 con checksum verificado (scripts/runme-install.sh), un job de
CI separado (.gitea/workflows/ci.yml) que sólo corre celdas ci-safe, y la
decisión documentada en docs/adr/0004-runme-sidecar.md y docs/RUNME.md.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-08-27 00:06:01 -06:00

2.0 KiB

Raw Blame History

Claude Code: operación de la bitácora

Sigue primero AGENTS.md. Estas reglas son específicas para sesiones de administración asistidas.

Al iniciar

Confirma la raíz con clusterlog --root . --json identity usando la llave proporcionada por el entorno.
Consulta tareas asignadas con task list --mine cuando la sesión parte de trabajo planeado.
No inicies un temporizador si ya existe otro activo para el administrador.

Durante la sesión

Mantén notas temporales fuera del repositorio hasta redactarlas y eliminar secretos.
Separa observación, hipótesis, acción y validación.
No registres como ejecutado un comando sólo porque fue sugerido.
Usa task start y task stop para trabajo rastreado; usa adjust sólo con justificación.

Al cerrar

Prepara una memoria cuando hubo un cambio, corrección, diagnóstico significativo o aprendizaje reutilizable.
Incluye un rollback accionable para riesgo high o critical.
Actualiza o crea un manual cuando el procedimiento deba repetirse.
Ejecuta --dry-run, luego la escritura con --commit si está autorizada.
Devuelve un resumen con IDs, archivos, tiempo, validación, advertencias y SHA firmado.

Runbooks ejecutables (Runme)

No actives una celda risk-mutating/risk-destructive de RUNBOOK.md o runbooks/ sin autorización explícita del usuario para esa operación puntual.
Una celda ci-safe sigue siendo el mismo comando que documenta; aplícale las mismas reglas de --dry-run/--commit que usarías si lo tipearas tú mismo.
No agregues lógica nueva dentro de una celda ni edites un identificador Lifecycle Identity generado por Runme.

Formato de respuesta al usuario

Resultado: <éxito o error verificado>
Tarea: <TSK-ID y tiempo, cuando aplique>
Memoria: <MEM-ID>
Archivos: <rutas>
Validación: <comandos realmente ejecutados>
Commit: <SHA o “no creado”>
Pendientes: <riesgos o acciones concretas>

No ocultes un fallo de firma o validación detrás de una descripción optimista.

2.0 KiB Raw Blame History