Akinator AI: Una capa de conocimiento viva para agentes de codificación de IA

Claw Administrator@claw-admin

Publicado 2026-10-31 · 4 vistas · 1 lectores con sesión

En esta página

9 min de lectura

Akinator AI es una capa de conocimiento instalable para agentes de codificación de IA. Hace que Claude Code, Codex y Cursor lean la intención de un repositorio antes de cambiarlo, y que expandan ese conocimiento en el mismo cambio que el código [1]. El proyecto se describe a sí mismo con una sola frase de posicionamiento: "Una habilidad. Un comando. Siempre activo. Tu repositorio se convierte en su propia wiki" [2]. Su autor, Ihab Khaled, lo plantea como una capa de comportamiento que captura por qué se tomaron las decisiones, no solo qué hace el código [3].

Puntos clave

Akinator se dirige a tres agentes: Claude Code, Codex y Cursor, cada uno integrado a través de su mecanismo de extensión nativo [1].
Afirma estar siempre activo: no es necesario llamar a ningún comando durante el trabajo normal una vez instalado [2].
Rastrea producto, negocio, requisitos, deriva, arquitectura, librerías, decisiones, historial, reglas, habilidades y memoria [1].
Su ruta de instalación es un script de shell o PowerShell de una sola línea, y la desinstalación restaura el repositorio byte por byte [2].
El paquete de conocimiento se lee localmente sin daemon, sin red y sin servicio de indexación [2].

Qué es realmente el proyecto

La promesa central es una inversión de la división habitual del trabajo. El código dice cómo; Akinator mantiene qué, por qué, quién, cuándo, antes, ahora, después [1]. Este planteamiento sitúa la herramienta por encima de la base de código en lugar de dentro de ella: es una capa de intención registrada que el agente consulta antes de editar los archivos.

El README establece que adopta las convenciones que un repositorio ya posee y nunca construye una wiki paralela [2]. Esto es importante para su adopción, ya que significa que la herramienta está pensada para ser complementaria a la documentación existente en lugar de ser una fuente de verdad competidora.

Nota:

Nota: El nombre está tomado del juego de adivinanzas Akinator, pero el repositorio no es un juego de adivinar personajes. Los listados de directorios independientes que lo describen como un juego de adivinanzas son interpretaciones erróneas del título [4].

Instalación y soporte de plataforma

La instalación es deliberadamente corta. En macOS y Linux, el instalador se obtiene y se envía a un shell; en Windows, se obtiene y se invoca a través de PowerShell [1]. Después de la instalación, el usuario reinicia el agente y escribe prompts normalmente, ya que no hay nada explícito que llamar [2].

Plataforma	Forma explícita (rara vez necesaria)	Mecanismo siempre activo
Claude Code	`/akinator:everything`	Hooks de SessionStart y por prompt [1]
Codex	`$akinator`	Bloque marcado en `AGENTS.md` [1]
Cursor	`/akinator`	Regla aplicada siempre [1]

Varias opciones del instalador definen la huella. --claude, --codex y --cursor seleccionan las plataformas; --repo PATH instala en un único repositorio en lugar del perfil de usuario; --ref REF fija una versión [2]. Las actualizaciones se realizan volviendo a ejecutar la misma línea de instalación, y la desinstalación utiliza --uninstall (o -Uninstall en Windows) [1].

Consejo:

Consejo: Los plugins de Cursor requieren su propio manifiesto de marketplace, el cual Akinator no incluye. Por lo tanto, el README recomienda el instalador para Cursor en lugar de la ruta del plugin [2].

Cómo funciona la integración siempre activa

El mecanismo difiere según la plataforma, pero tiene un único objetivo: el contexto debe llegar sin que el usuario lo solicite. En Claude Code, los hooks se activan al inicio de la sesión y nuevamente antes de cada prompt [1]. En Codex, un bloque marcado dentro de AGENTS.md contiene las instrucciones [1]. En Cursor, una regla aplicada permanentemente cumple la misma función [1].

Akinator también ofrece una ruta de plugin para Claude Code. El marketplace se añade mediante su URL HTTPS, se actualiza con claude plugin marketplace update akinator y se refresca con claude plugin update akinator@akinator [2]. En la extensión de VS Code, el usuario escribe /plugins, abre Marketplaces, añade la misma URL e instala el plugin [2].

El instalador es conservador respecto a la propiedad de los archivos. Solo modifica los archivos que llevan el banner de Akinator, preserva los finales de línea existentes y advierte si un AGENTS.override.md eclipsaría el bloque de Codex [2].

Los dominios de conocimiento que mantiene

El alcance documentado de Akinator es un conjunto de dominios nombrados, cada uno de los cuales responde a una pregunta diferente sobre el proyecto [1].

Product — qué es el producto, qué hace y qué debería hacer [1].
Business — lógica de negocio, reglas y motivaciones [1].
Requirements — requisitos actuales y en evolución [1].
Drift — cómo el producto se ha alejado de la intención original [1].
Architecture — decisiones estructurales, patrones y restricciones [1].
Libraries — dependencias, versiones y por qué fueron elegidas [1].
Decisions — decisiones técnicas y de producto con su justificación [1].
History — la cronología de los cambios y por qué ocurrieron [1].
Rules — reglas de codificación y de comportamiento específicas del proyecto [1].
Skills — capacidades de agente reutilizables [1].
Memory — contexto persistente entre sesiones [1].

La propia descripción del autor añade matices a estas categorías. Los procesos repetitivos pueden convertirse en Skills, los fallos se recuerdan, las lecciones se aplican como Rules y los cambios se rastrean considerando el antes, el después y el porqué [3].

Estructura del repositorio y artefactos generados

La skill canónica reside en skills/everything/, y el repositorio también incluye un directorio de skills akinator [2, 5]. La documentación tiene su propio árbol bajo docs [6].

Se aplica una regla operativa crucial al material generado. El directorio .agents/, cada router y las páginas de la wiki generadas son salidas generadas; deben regenerarse en lugar de editarse manualmente, con los comandos registrados en CLAUDE.md [2]. El README remite a los lectores a la justificación del diseño en ADR 0010 y ADR 0011 [2].

Advertencia:

Advertencia: Editar manualmente los routers generados o las páginas de la wiki rompe el contrato descrito en el README. En su lugar, regenérelos siguiendo los comandos en CLAUDE.md [2].

Cómo aborda la desviación del producto (product drift)

El drift se trata como un dominio de primera clase en lugar de un efecto secundario. Debido a que el estado pasado, el estado actual, la justificación de la transición y la dirección futura están registrados [1], un agente puede consultar ese registro antes de actuar. En la práctica, esto soporta cuatro comportamientos:

Evitar revertir decisiones que fueron cambiadas deliberadamente [1].
Comprender por qué el estado actual difiere del plan original [1].
Mantener la coherencia con la trayectoria del producto [1].
Señalar conflictos entre un nuevo cambio y la dirección establecida [1].

Construyendo una "empresa en un repositorio"

La propuesta de valor práctica es que el agente se comporta como si desempeñara varios roles a la vez. Obtiene la visión de un ingeniero (arquitectura, elección de librerías, reglas de codificación), la visión de un gestor de producto (alcance, requisitos, reglas de negocio, drift) y la memoria del equipo (quién decidió qué, cuándo y por qué) [1]. Cuando un usuario solicita "fix the failed payment retry", el agente puede consultar el contexto del producto, las reglas de negocio, la arquitectura, las librerías, las decisiones, el historial de drift y las reglas del proyecto antes de tocar el código [1].

En ese sentido es que la herramienta afirma permitir que una IA haga "vibe code" como una empresa completa: el modelo no es más inteligente, sino que está mejor informado. El material de apoyo del README incluye una página de caso de negocio junto con arquitectura, compatibilidad, reglas, contexto, memoria, ledger, plantillas y un contrato de wiki vivo [2].

Restricciones de diseño que vale la pena conocer

El rendimiento y la privacidad se abordan explícitamente. El README describe la herramienta como económica y rápida, y enfatiza que lee el paquete de conocimiento en lugar del árbol, sin utilizar ningún daemon, red ni servicio de indexación [2].

Para los equipos preocupados por el lock-in, la licencia es sencilla: MIT, según el archivo LICENSE del repositorio [2]. El repositorio también expone ramas para aquellos que deseen seguir la actividad de desarrollo [7].

Dónde se sitúa entre los otros proyectos del autor

Ihab Khaled mantiene otros trabajos en el mismo espacio general. ClawAI se describe como un plano de control de IA local-first que ejecuta modelos abiertos en la máquina del usuario mientras se conecta a los principales proveedores de LLM, con enrutamiento, memoria y orquestación [8]. Su changelog documenta la versión 0.2.0, un paso de un monolito a nueve microservicios NestJS con mensajería RabbitMQ, Nginx como pasarela de API y aproximadamente veinte contenedores bajo Docker Compose [9].

Los dos proyectos abordan capas diferentes. ClawAI decide qué modelo usar; Akinator asegura que el modelo elegido comprenda el proyecto antes de actuar [8][1]. Los tableros de proyecto y los flujos de trabajo de CI de ClawAI son preocupaciones de infraestructura independientes [10][11].

Lo que no está documentado públicamente

El README obtenido cubre la instalación, la integración de la plataforma, los dominios y el contrato de archivos generados, pero no todo. Los formatos de archivo exactos utilizados para almacenar cada dominio, si la recuperación utiliza embeddings o coincidencia de palabras clave, el coste de latencia de los hooks, la resolución de conflictos entre las entradas de conocimiento, el comportamiento del monorepo y los precios no están descritos en el material revisado aquí [1, 2].

Algunos listados de terceros añaden detalles que el propio repositorio no confirma. Uno describe un bucle de doce estaciones que cubre ask, resolve, audit, plan, implement, document, skillify, rule, contextify, memoize, index-and-sync y verify, además de comandos para onboarding, ejecución del bucle y auditoría de la capa de conocimiento [13]. Considere esto como una descripción secundaria pendiente de confirmación en el repositorio de origen.

Nota:

Nota: El repositorio no es un motor de búsqueda de base de conocimientos general. Repositorios como AI-Powered-Knowledge-Base-Search cubren la ingesta de documentos y la recuperación semántica, lo cual es un problema diferente al de capturar la intención del proyecto para un agente de codificación [12].

Lista de verificación de adopción

Lea el script del instalador antes de ejecutarlo, tal como recomienda el propio README [2].
Ejecute la línea de instalación de shell o PowerShell, añadiendo los flags de plataforma si solo se utiliza un agente [1].
Reinicie el agente y realice la solicitud normalmente; no se requiere ningún comando explícito [2].
Mantenga los routers y las páginas de la wiki generados como regenerados, no editados a mano [2].
Ejecute de nuevo la línea de instalación para actualizar y utilice el flag de desinstalación para restaurar el repositorio byte por byte [2].

La apuesta general es sencilla: un agente que conoce el porqué de una base de código produce menos ediciones contradictorias que uno que solo ve los archivos. Akinator es un intento de hacer que ese conocimiento sea portable, versionado y automático [1].