# Base de conocimiento

> La base de conocimiento del proyecto: notas Markdown en .ai-game-dev/knowledge/, versionadas con el proyecto, indexadas como grafo y buscables por el agente. El agente registra decisiones de diseño y convenciones, organiza las notas en espacios, reescribe los enlaces al mover y encuentra enlaces rotos; la app de escritorio muestra las notas como un grafo 3D.

- Id: `aigd.knowledge`
- Origen: Oficial (propio `aigd.*`)
- Categoría: 3D
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 0.3.22 (publicado el 2026-11-22)
- Licencia: Apache-2.0
- Requiere la app AI Game Dev: `>=0.25.11`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.knowledge

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

```bash
gamedev pkg add aigd.knowledge
```

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.knowledge` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 0.3.22 | 2026-11-22 | `>=0.25.11` | la más reciente |
| 0.3.21 | 2026-11-19 | `>=0.25.11` | - |
| 0.3.20 | 2026-11-13 | `>=0.25.11` | - |
| 0.3.19 | 2026-11-13 | `>=0.25.11` | - |
| 0.3.18 | 2026-11-06 | `>=0.25.11` | - |
| 0.3.17 | 2026-11-02 | `>=0.25.11` | - |
| 0.3.16 | 2026-11-01 | `>=0.25.11` | - |
| 0.3.15 | 2026-11-01 | `>=0.25.11` | - |
| 0.3.7 | 2026-10-15 | `>=0.22.0` | - |
| 0.3.6 | 2026-10-13 | `>=0.22.0` | - |
| 0.3.5 | 2026-10-12 | `>=0.22.0` | - |
| 0.3.4 | 2026-10-11 | `>=0.22.0` | - |
| 0.3.3 | 2026-10-09 | `>=0.22.0` | - |
| 0.3.2 | 2026-10-07 | `>=0.22.0` | - |
| 0.2.1 | 2026-10-05 | `>=0.20.0` | - |

## Descripción

````markdown
# Base de conocimiento (`aigd.knowledge`)

La base de conocimiento del proyecto para el agente de AI Game Dev: notas Markdown en `.ai-game-dev/knowledge/`, versionadas con el proyecto y compartidas con el equipo mediante git. El paquete indexa las notas y sus enlaces como un grafo, da al agente herramientas para explorarlas, buscarlas, enlazarlas y organizarlas, y muestra el grafo en una ventana 3D. Encaja con equipos de juego que quieren que las decisiones de diseño, las convenciones y el funcionamiento de sus sistemas queden escritos donde tanto las personas como el agente puedan encontrarlos.

## Qué puedes hacer

- Hacer que el agente registre las decisiones de diseño y sus motivos, las convenciones y los detalles poco obvios que pueden dar problemas mientras trabajas, en el espacio temático correcto.
- Preguntar al agente qué decidió el equipo sobre un sistema; puede buscar en las notas para responder.
- Organizar las notas en espacios (carpetas con un `README.md`), y mover o renombrar notas y carpetas sin romper los enlaces.
- Encontrar enlaces rotos y notas huérfanas, y ver cómo se conecta todo en el grafo.
- Explorar tú mismo las notas en la ventana de grafo 3D o en la vista previa del panel lateral de la app de escritorio.

## Ejemplos de solicitudes

- "Apunta que elegimos un paso de física fijo de 60 Hz para el sistema de combate, y por qué."
- "¿Qué dice la base de conocimiento sobre nuestro formato de guardado?"
- "Crea un espacio para el sistema de inventario y mueve ahí las notas de objetos."
- "Revisa la base de conocimiento en busca de enlaces rotos y corrígelos."
- `/kb systems` (los totales de la base de conocimiento y los enlaces rotos, con el árbol del espacio `systems`)

## Cómo funciona

Las notas son archivos Markdown sin más bajo `<project>/.ai-game-dev/knowledge/`, así que viven en el control de versiones junto a tu juego. Un **espacio** es una carpeta con un `README.md`: un `# Title` y después una descripción de un párrafo. Las notas se enlazan entre sí con rutas desde la raíz de la base de conocimiento, por ejemplo `[Combat](/systems/combat.md)`; también se indexan los enlaces relativos y los wikilinks (`[[Combat]]`).

El agente ve la lista de espacios de nivel superior en sus instrucciones y va bajando de un espacio a otro. Lee y escribe notas con sus herramientas de archivos habituales y usa estas herramientas para lo demás:

| Herramienta | Qué hace |
|---|---|
| `kb_space_get` | Abrir un espacio: su descripción, los espacios hijos y las notas. |
| `kb_space_create` | Crear un espacio: una carpeta con un `README.md` (título y descripción). |
| `kb_search` | Búsqueda clasificada de notas por título, ruta y texto, con fragmentos. |
| `kb_links` | Enlaces salientes, enlaces entrantes y enlaces rotos de una nota, o de todas las notas de una carpeta. |
| `kb_move` | Mover o renombrar una nota o carpeta y reescribir todos los enlaces que apuntan a ella. |
| `kb_lint` | Enlaces rotos, notas huérfanas, problemas de convenciones y sugerencias. |

Al agente se le indica que registre solo conocimiento importante y duradero (decisiones y sus motivos, convenciones, cómo funciona un sistema, detalles poco obvios), que busque primero y actualice una nota existente en lugar de duplicarla, y que base cada dato en lo que dijiste o en lo que muestra el código.

El paquete aporta:

- la capacidad **Base de conocimiento**, activada de forma predeterminada;
- el comando `/kb [folder or note]` (CLI y escritorio): notas, carpetas, enlaces, enlaces rotos y huérfanos, y después el árbol;
- en la app de escritorio, la ventana de grafo 3D (desde la barra de estado, el menú de herramientas de la sesión o "Abrir en el grafo de la base de conocimiento" en una nota o carpeta del explorador de archivos), una vista de la base de conocimiento en el panel derecho y un consejo que apunta a ella. El grafo se actualiza en vivo mientras el agente escribe notas.

## Requisitos

- AI Game Dev 0.25.11 o posterior. La ventana de grafo y el panel lateral forman parte de la app de escritorio.
- Una carpeta de proyecto; `git` para compartir las notas con tu equipo.

## Licencia

Apache-2.0.
````
