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.

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ó
- 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.
- SimplificarBorré comandos y dejé que las skills hicieran el trabajo. El CLI pasó a medir, nunca a escribir páginas.
- 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.
- Publicar en npmPaquete público, instalación con
npm instally un README que explica qué esperar. - 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.
- Validar cada releaseUn agente valida cada versión y deja su log en el repo. Llegaron
updatepara instalaciones existentes y el README en español.
Qué construí
- Unas skills que escriben la wiki:
wikipoke-ingest,wikipoke-query,wikipoke-lintywikipoke-decisionpara 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.
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.
