DevOps — operar y ampliar el catálogo

Instalación, ciclo operativo con agentes externos y publicación del sitio estático.

Onboarding para agentes LLM

llms.md

Documento de contexto obligatorio antes de tocar código o datos: estructura del repo, ciclo MCS, CI y convenciones.

llms.md · rama main

Prompts operativos

Plantillas en docs/prompts/ para gestionar buffers y cuarentena con agentes externos.

Llenar buffer

Pedir a un agente externo un nuevo buffer MCS-N.

docs/prompts/llenar_buffer.md

Limpiar cuarentena (pedir)

Solicitar solidificación o descarte de ítems en cuarentena L3.

docs/prompts/limpiar_cuarentena_pedir.md

Limpiar cuarentena (recibir)

Formato de respuesta del agente para convertir a buffer o sesión.

docs/prompts/limpiar_cuarentena_recibir.md

Prompts ciudadano (pack ZIP)

Para interpretar un paquete descargado (medidor pack / public/prensa/downloads/). El agente solo lee archivos dentro del pack; el prompt puede vivir fuera.

Lectura ciudadana de medición

Mapa justicia–política desde un pack ZIP: tensión entre ejes procesales y contextuales, sin veredicto maniqueo; tablas trazables.

docs/prompts/lectura_pack_ciudadano.prompt.md

Instalación

git clone https://github.com/alephscriptorium-eng/medidor-lawfare.git
cd medidor-lawfare
pip install -e ".[dev]"

Comandos CLI

medidor cribar  data/buffers/MI-BUFFER.json --caso <caso-id>
medidor commit  data/buffers/MI-BUFFER.json --caso <caso-id>
medidor catalog sync
medidor build --target all
medidor pack --caso <caso-id> [--med M3] [--output dir]

medidor pack genera uno o más ZIP en public/prensa/downloads/ (por defecto) sin reconstruir todo el sitio. Sin --med, empaqueta el caso completo; con --med, solo esa medición.

Ciclo típico

  1. Agente externo llena buffer (llenar_buffer.md) → docs/sesiones/buffer-NN.md
  2. Operador convierte a data/buffers/MCS-N-entrada.json
  3. medidor cribarmedidor commit
  4. Si hay cuarentena L3: limpiar_cuarentena_pedir.md / limpiar_cuarentena_recibir.md
  5. medidor catalog sync + medidor build --target all
  6. Pack ciudadano: medidor pack --caso <id> → agente con lectura_pack_ciudadano.prompt.md

Publicar un nuevo caso

  1. Crear data/casos/{slug}/caso.json y estado.json con medición baseline
  2. medidor catalog sync
  3. medidor build --target all

Estructura public/

public/
  index.html   → índice (artefacto + centro de datos)
  prensa/      → catálogo de mediciones
    downloads/ → paquetes ZIP por medición y por caso
  foss/        → documentación del artefacto (esta sección)

Tests

pytest