Skip to content

avgarcia/runcriticon / .claude/skills/runbook-generator

runbook-generator

Verified

Genera un runbook operativo en docs/runbooks/ siguiendo la plantilla del proyecto y cruzando con el ADR que lo invoca. Usar cuando se alcance un disparador que requiera un runbook nuevo (rotación de secreto, acceso a RDS, respuesta a brecha, disaster recovery, atención de un derecho RGPD, alarma de AMG, actualización de JDK). Crea el archivo con frecuencia, prerrequisitos, procedimiento paso a paso, rollback y registro.

Runbook Generator — Runcriticon

Genera un runbook operativo coherente con la convención de docs/runbooks/README.md y la plantilla de rotación de docs/arquitectura/configuracion-y-secretos-en-modulos.md §9.

Cuándo usar

El catálogo de docs/runbooks/README.md enumera ~14 runbooks previstos por los ADRs. Esta skill se invoca cuando llega el momento de crear uno:

RunbookInvocado porDisparador
acceso-rds.mdADR-0006 D13Primer acceso administrativo a RDS
rotacion-{secreto}.mdADR-0013 D10/D11Primera rotación (trimestral DB / anual crypto) o sospecha
respuesta-a-brecha.mdADR-0014 D26Antes de la beta
disaster-recovery.mdADR-0006 D29Antes de la beta
derechos-rgpd-acceso.md / -oposicion.mdADR-0014 D12/D15Antes de la beta
alarmas/{alarma}.mdADR-0011 D16Al configurar cada alarma en AMG
actualizacion-jdk.mdADR-0016 D5Primer upgrade de GraalVM CE

Argumentos

/runbook-generator rotacion-session-signing-key
/runbook-generator acceso-rds
/runbook-generator respuesta-a-brecha

Proceso

  1. Identificar el ADR que invoca el runbook (de la tabla del catálogo o preguntando).
  2. Leer la sub-decisión origen para extraer frecuencia, plazos, garantías.
  3. Elegir la plantilla según el tipo:
    • Rotación de secreto → plantilla de configuracion-y-secretos-en-modulos.md §9.
    • Procedimiento operativo (acceso, DR, brecha) → plantilla genérica de abajo.
  4. Rellenar con los datos concretos del ADR (cifras, comandos AWS CLI, cruces).
  5. Crear docs/runbooks/{nombre}.md.
  6. No commitear automáticamente.

Plantilla genérica (procedimiento operativo)

# Runbook — {título}

> Invocado por {ADR-XXXX DN}. {Una frase de propósito.}

## Cuándo se ejecuta

- {Disparador concreto, con cifra si aplica.}

## Quién puede ejecutarlo

- {Rol / persona. Para acciones sobre producción: requiere MFA, cruce ADR-0006 D27.}

## Prerrequisitos

- [ ] {Acceso AWS CLI con MFA / ventana de mantenimiento / equipo notificado / etc.}

## Procedimiento

1. **{Paso}**:
   ```bash
   {comando concreto}
  1. {Paso}: ...

Verificación

  • {Cómo comprobar que salió bien.}

Rollback

  • {Cómo deshacer si el paso falla.}

Registro

  • Anotar la ejecución en docs/runbooks/log-{tipo}.md: fecha, ejecutor, resultado.

Cruces

  • {ADR-XXXX DN}, {subdocumento.md §N}.

## Plantilla de rotación de secreto

Usar la de [`configuracion-y-secretos-en-modulos.md`](../../../docs/arquitectura/configuracion-y-secretos-en-modulos.md) §9, que ya incluye:

- Frecuencia (trimestral DB / anual crypto y proveedor — ADR-0013 D10).
- Generación del nuevo valor (`openssl rand -hex 32` para crypto; dashboard del proveedor para tokens).
- Persistencia en SSM (`aws ssm put-parameter --name /runcriticon/{env}/{component}/{name} --value ... --type SecureString --overwrite`).
- Redeploy de App Runner (`aws apprunner start-deployment`).
- Verificación del flujo afectado.
- Consecuencias (ej. rotar `session-signing-key` invalida sesiones activas — ADR-0003 D11).
- Registro en `docs/runbooks/log-rotaciones.md`.

## Reglas

- **Comandos concretos**, no genéricos. Si el runbook menciona SSM, el comando lleva el path canónico real.
- **Cruce inline** al ADR origen en cada paso relevante.
- **Rollback siempre presente**, aunque sea "no aplica" con justificación.
- **Registro siempre presente**: ningún procedimiento operativo se ejecuta "en silencio" (coherente con el principio de responsabilidad proactiva de ADR-0014).
- Si el runbook es de rotación y el secreto **no está en el catálogo** (ADR-0013 D6), avisar de que falta añadirlo primero.

## Antipatrones

- Comandos con valores reales de secretos (usar placeholders `$NUEVO_VALOR`).
- Runbook sin sección de verificación.
- Rotación sin mencionar el efecto colateral (invalidación de sesiones, cuota del proveedor, etc.).
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall