# Knowledge Base

> Die Knowledge Base des Projekts: Markdown-Notizen in .ai-game-dev/knowledge/, mit dem Projekt committet, als Graph indexiert und vom Agenten durchsuchbar. Der Agent hält Designentscheidungen und Konventionen fest, organisiert Notizen in Spaces, korrigiert Links beim Verschieben und findet defekte Links; die Desktop-App zeigt die Notizen als 3D-Graph.

- Id: `aigd.knowledge`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: 3D
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 0.3.22 (veröffentlicht am 2026-11-22)
- Lizenz: Apache-2.0
- Erfordert die AI Game Dev App: `>=0.25.11`
- Nativer Code: nein
- Bewertung: noch nicht bewertet
- HTML-Seite: https://ai-game.dev/de/packages/aigd.knowledge

## Installieren

Mit der gamedev CLI im Projektordner:

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

In der Desktop-App: Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle **Browse**, suche nach `aigd.knowledge` und klicke auf **Add to Project**. Mehr: https://ai-game.dev/docs/wiki/app/packages

## Versionen

| Version | Veröffentlicht | Erfordert App | Hinweise |
|---|---|---|---|
| 0.3.22 | 2026-11-22 | `>=0.25.11` | neueste |
| 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` | - |

## Beschreibung

````markdown
# Knowledge Base (`aigd.knowledge`)

Die Knowledge Base des Projekts für den Agenten von AI Game Dev: Markdown-Notizen in `.ai-game-dev/knowledge/`, mit dem Projekt committet und über git mit dem Team geteilt. Das Paket indexiert die Notizen und ihre Links als Graph, gibt dem Agenten Werkzeuge zum Durchstöbern, Suchen, Verlinken und Organisieren und zeigt den Graphen in einem 3D-Fenster. Es passt zu Spielteams, die Designentscheidungen, Konventionen und die Funktionsweise ihrer Systeme dort festhalten wollen, wo sowohl Menschen als auch der Agent sie finden.

## Was du tun kannst

- Lass den Agenten Designentscheidungen samt Begründung, Konventionen und nicht offensichtliche Stolperfallen während der Arbeit im passenden Themen-Space festhalten.
- Frag den Agenten, was das Team zu einem System entschieden hat; er kann die Notizen durchsuchen, um zu antworten.
- Ordne Notizen in Spaces (Ordner mit einer `README.md`) und verschiebe oder benenne Notizen und Ordner um, ohne Links zu brechen.
- Finde defekte Links und verwaiste Notizen und sieh im Graph, wie alles zusammenhängt.
- Durchstöbere die Notizen selbst im 3D-Graph-Fenster oder in der Vorschau im Seitenpanel der Desktop-App.

## Beispielanfragen

- "Halte fest, dass wir für das Kampfsystem einen festen Physik-Schritt von 60 Hz gewählt haben, und warum."
- "Was sagt die Knowledge Base zu unserem Speicherformat?"
- "Erstelle einen Space für das Inventarsystem und verschiebe die Item-Notizen hinein."
- "Prüfe die Knowledge Base auf defekte Links und repariere sie."
- `/kb systems` (die Summen und defekten Links der Knowledge Base, mit dem Baum des Space `systems`)

## So funktioniert es

Die Notizen sind einfache Markdown-Dateien unter `<project>/.ai-game-dev/knowledge/` und liegen damit in der Versionsverwaltung neben deinem Spiel. Ein **Space** ist ein Ordner mit einer `README.md`: einem `# Title`, dann eine Beschreibung in einem Absatz. Notizen verlinken sich gegenseitig mit Pfaden ab dem Wurzelverzeichnis der Knowledge Base, zum Beispiel `[Combat](/systems/combat.md)`; auch relative Links und Wikilinks (`[[Combat]]`) werden indexiert.

Der Agent sieht die Liste der Spaces der obersten Ebene in seinen Instruktionen und arbeitet sich Space für Space nach unten. Notizen liest und schreibt er mit seinen normalen Dateiwerkzeugen; für den Rest nutzt er diese Werkzeuge:

| Werkzeug | Was es macht |
|---|---|
| `kb_space_get` | Einen Space öffnen: seine Beschreibung, untergeordnete Spaces und Notizen. |
| `kb_space_create` | Einen Space erstellen: ein Ordner mit einer `README.md` (Titel und Beschreibung). |
| `kb_search` | Gewichtete Suche in Notizen nach Titel, Pfad und Text, mit Textausschnitten. |
| `kb_links` | Ausgehende Links, Backlinks und defekte Links einer Notiz oder aller Notizen in einem Ordner. |
| `kb_move` | Eine Notiz oder einen Ordner verschieben oder umbenennen und jeden Link darauf umschreiben. |
| `kb_lint` | Defekte Links, verwaiste Notizen, Konventionsprobleme und Hinweise. |

Dem Agenten wird vorgegeben, nur wichtiges, dauerhaftes Wissen festzuhalten (Entscheidungen samt Begründung, Konventionen, die Funktionsweise eines Systems, nicht offensichtliche Stolperfallen), zuerst zu suchen und eine vorhandene Notiz zu aktualisieren statt sie zu duplizieren, und jede Aussage auf das zu stützen, was du gesagt hast oder was der Code zeigt.

Das Paket bringt mit:

- die Fähigkeit **Knowledge Base**, standardmäßig aktiv;
- den Befehl `/kb [folder or note]` (CLI und Desktop): Notizen, Ordner, Links, defekte Links und Waisen, dann der Baum;
- in der Desktop-App das 3D-Graph-Fenster (über die Statusleiste, das Werkzeugmenü der Session oder "Im Knowledge-Base-Graph öffnen" bei einer Notiz oder einem Ordner im Datei-Explorer), eine Knowledge-Base-Ansicht im rechten Panel und einen Hinweis, der darauf verweist. Der Graph aktualisiert sich live, während der Agent Notizen schreibt.

## Voraussetzungen

- AI Game Dev 0.25.11 oder neuer. Das Graph-Fenster und das Seitenpanel sind Teil der Desktop-App.
- Ein Projektordner; `git`, um die Notizen mit deinem Team zu teilen.

## Lizenz

Apache-2.0.
````
