# Base de Conhecimento

> A Base de Conhecimento do projeto: notas em markdown em .ai-game-dev/knowledge/, versionadas junto com o projeto, indexadas como um grafo e pesquisáveis pelo agente. O agente registra decisões de design e convenções, organiza as notas em espaços, corrige links ao mover e encontra links quebrados; o aplicativo desktop mostra as notas como um grafo 3D.

- Id: `aigd.knowledge`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: 3D
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 0.3.22 (publicado em 2026-11-22)
- Licença: Apache-2.0
- Requer o app AI Game Dev: `>=0.25.11`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.knowledge

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.knowledge` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 0.3.22 | 2026-11-22 | `>=0.25.11` | mais recente |
| 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` | - |

## Descrição

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

A Base de Conhecimento do projeto para o agente do AI Game Dev: notas em Markdown em `.ai-game-dev/knowledge/`, versionadas junto com o projeto e compartilhadas com a equipe pelo git. O pacote indexa as notas e seus links como um grafo, dá ao agente ferramentas para navegar, pesquisar, vincular e organizar as notas, e mostra o grafo em uma janela 3D. Ele é indicado para equipes de jogos que querem decisões de design, convenções e o funcionamento dos seus sistemas registrados onde tanto as pessoas quanto o agente possam encontrá-los.

## O que você pode fazer

- Pedir ao agente que registre decisões de design e seus motivos, convenções e pegadinhas nada óbvias enquanto você trabalha, no espaço de tópico certo.
- Perguntar ao agente o que a equipe decidiu sobre um sistema; ele pode pesquisar nas notas para responder.
- Organizar as notas em espaços (pastas com um `README.md`) e mover ou renomear notas e pastas sem quebrar links.
- Encontrar links quebrados e notas órfãs e ver como tudo se conecta no grafo.
- Navegar pelas notas você mesmo na janela de grafo 3D ou na prévia do painel lateral do aplicativo desktop.

## Exemplos de pedidos

- "Anote que escolhemos um passo de física fixo de 60 Hz para o sistema de combate, e por quê."
- "O que a Base de Conhecimento diz sobre o nosso formato de save?"
- "Crie um espaço para o sistema de inventário e mova as notas de itens para lá."
- "Verifique a Base de Conhecimento em busca de links quebrados e corrija-os."
- `/kb systems` (os totais e links quebrados da Base de Conhecimento, com a árvore do espaço `systems`)

## Como funciona

As notas são arquivos Markdown simples em `<project>/.ai-game-dev/knowledge/`, então ficam no controle de versão junto com o seu jogo. Um **espaço** é uma pasta com um `README.md`: um `# Title`, seguido de uma descrição de um parágrafo. As notas se vinculam umas às outras com caminhos a partir da raiz da Base de Conhecimento, por exemplo `[Combat](/systems/combat.md)`; links relativos e wikilinks (`[[Combat]]`) também são indexados.

O agente vê a lista de espaços de nível superior nas suas instruções e desce um espaço de cada vez. Ele lê e escreve notas com as ferramentas de arquivo comuns e usa estas ferramentas para o resto:

| Ferramenta | O que ela faz |
|---|---|
| `kb_space_get` | Abre um espaço: sua descrição, espaços filhos e notas. |
| `kb_space_create` | Cria um espaço: uma pasta com um `README.md` (título e descrição). |
| `kb_search` | Busca classificada de notas por título, caminho e texto, com trechos. |
| `kb_links` | Links de saída, backlinks e links quebrados de uma nota, ou de todas as notas de uma pasta. |
| `kb_move` | Move ou renomeia uma nota ou pasta e reescreve todos os links que apontam para ela. |
| `kb_lint` | Links quebrados, notas órfãs, problemas de convenção e dicas. |

O agente é instruído a registrar apenas conhecimento importante e duradouro (decisões e seus motivos, convenções, como um sistema funciona, pegadinhas nada óbvias), a pesquisar primeiro e atualizar uma nota existente em vez de duplicá-la, e a basear cada fato no que você disse ou no que o código mostra.

O pacote contribui com:

- o recurso **Base de Conhecimento**, ativado por padrão;
- o comando `/kb [folder or note]` (CLI e desktop): notas, pastas, links, links quebrados e órfãs, depois a árvore;
- no aplicativo desktop, a janela de grafo 3D (a partir da barra de status, do menu de ferramentas da sessão ou de "Abrir no grafo da Base de Conhecimento" em uma nota ou pasta no explorador de arquivos), uma visão da Base de Conhecimento no painel direito e uma dica que aponta para ela. O grafo é atualizado ao vivo enquanto o agente escreve notas.

## Requisitos

- AI Game Dev 0.25.11 ou mais recente. A janela de grafo e o painel lateral fazem parte do aplicativo desktop.
- Uma pasta de projeto; `git` para compartilhar as notas com a sua equipe.

## Licença

Apache-2.0.
````
