Dani Primo

Wikipoke: una wiki del código que escribe tu agente

Rol: autor y mantenedor. Stack: TypeScript, Node, npm, GitHub Actions, skills para Claude Code y OpenCode.

Repositorio en GitHub · Paquete en npm · el README tiene dos vídeos de la herramienta funcionando.

Una página en wikipoke atlas: la lista de páginas agrupadas por tipo, la página con sus fuentes y el commit contra el que se comprobó, y el índice y el grafo local al lado
wikipoke atlas: cada página cita las líneas de código de las que sale.

El problema

Cada vez que preguntas algo a tu agente sobre un repo, vuelve a explorarlo desde cero. Gasta tokens y no siempre responde igual. Quería comprobar si una wiki mantenida por el propio agente, donde cada afirmación apunta a una línea de código, abarata esas preguntas y además avisa cuando se queda vieja.

Cómo avanzó

  1. Una primera versión con demasiadoMuchos comandos y una puerta de diseño formal. Los modelos se atascaban en la primera ingesta y acababan escribiendo sus propios scripts.
  2. SimplificarBorré comandos y dejé que las skills hicieran el trabajo. El CLI pasó a medir, nunca a escribir páginas.
  3. Probarla fuera de casaLa instalé desde OpenCode con un modelo pequeño en otro proyecto. De ahí salieron cambios en la instalación, los hooks y la medida de tokens.
  4. Publicar en npmPaquete público, instalación con npm install y un README que explica qué esperar.
  5. Issues en bucle con revisiónCada issue en su rama, tres agentes revisores antes de cada PR y una plantilla de PR que separa decisiones reversibles e irreversibles.
  6. Validar cada releaseUn agente valida cada versión y deja su log en el repo. Llegaron update para instalaciones existentes y el README en español.

Qué construí

  • Unas skills que escriben la wiki: wikipoke-ingest, wikipoke-query, wikipoke-lint y wikipoke-decision para registrar decisiones con su porqué.
  • Un CLI que instala, comprueba (check, check drift --against), actualiza (update) y muestra la wiki en el navegador (atlas).
  • Hooks para git, Claude Code y OpenCode que avisan de que el código se ha movido por delante de la wiki.
  • CI y publicación en npm a partir de etiquetas.
Cómo funciona wikipoke en seis pasos: init instala skills y hooks, ingest siembra la wiki citando ruta y línea, un hook avisa cuando el código se adelanta, ingest reconcilia solo lo que cambió, query responde desde la wiki y atlas la muestra en el navegador

Decisiones

  • Las skills escriben, el CLI mide. Separar esos dos papeles fue lo que desatascó la primera ingesta.
  • Sin compatibilidad hacia atrás al principio. Todavía no había instalaciones, así que rompí lo que hizo falta para que el diseño quedara limpio.
  • Probar con un modelo pequeño. Si funciona con GLM 5.3 Flash en OpenCode, funciona en casi cualquier agente.
  • Medir antes de prometer. El README no promete ahorro: enseña cuándo compensa y cuándo no.

Resultados

  • Publicado en npm, versión v0.4.1. 847 descargas entre septiembre y mediados de noviembre de 2026.
  • En el propio repo, la primera ingesta generó 20 páginas en seis minutos y bajó los ficheros sin cubrir de 43 a 1.
  • En un repo pequeño, las preguntas ya cubiertas costaron un 37 % y un 49 % menos tokens.
Gráfica de tokens por pregunta con y sin wiki
El grafo de wikipoke atlas: las 21 páginas del repositorio como nodos coloreados por tipo, unidos por sus enlaces
El grafo de la wiki que el repo mantiene de sí mismo.