Fill me in

{
  "lang": "es",
  "idea": "One sentence.",
  "summary": ["Line 1", "Line 2"],
  "parts": [
    { "id": "skill", "label": "Skill", "purpose": "...", "reason": "...",
      "from": ["part:skills/fill-me-in", "part:skills/fill-me-in/scripts"] }
  ],
  "existing": [{ "id": "docs", "label": "Docs", "from": ["existing:."] }],
  "edges": [{ "from": "skill", "to": "docs", "label": "updates" }],
  "phases": [{ "name": "Build", "moves": ["..."] }],
  "open": { "pending": ["..."], "unverified": ["..."], "next": "..." }
}

Por qué lo construí

Después de una sesión larga con un agente, pierdo el hilo de qué cambió y por qué. Una lista de archivos no me ayuda. Fill-me-in busca que entienda, no un inventario: la idea del cambio, la razón de cada parte y cómo encaja con el código que ya existe.

Lo pido con palabras normales, como “ponme al tanto”, “qué hiciste” o “fill me in”.

Solo esta sesión, en números pequeños

La skill toma lo que cambió solo de la sesión actual: los mensajes, las llamadas a herramientas y sus resultados. Para encontrar los cambios, no usa el historial de git, el ledger ni otras sesiones, porque pueden tener trabajo que esta sesión no hizo. Si la sesión no tiene trabajo, lo dice y se detiene.

Un lector retiene unas 4 cosas a la vez. Por eso la página usa como máximo 4 partes, 4 fases y 6 nodos en el diagrama.

Partes y movimientos

Una parte es un grupo de archivos tocados con un solo propósito. La skill nombra cada parte por su propósito, no por su directorio, y explica el cambio parte por parte, nunca archivo por archivo.

Un movimiento es una acción que cambió el estado del trabajo. La página cuenta los movimientos como una historia corta de fases, por ejemplo preparación, construcción y verificación. Siempre nombra cada comando que falló o fue denegado, y lo que hizo la sesión en su lugar.

La página

map.mjs encuentra las partes, sus estados y el código existente que se refiere a cada parte. También lista las conexiones entre ellas.

Después el modelo escribe los datos de la página con la forma del snippet. Luego render.mjs arma una sola página HTML autocontenida, imprime su ruta y la abre en el navegador.

La página muestra un diagrama de las conexiones, con un panel de detalle para cada parte. Si el render falla dos veces, el resumen completo va al chat, con un árbol de texto como diagrama. Cada afirmación que la sesión no muestra queda marcada como no verificada.