# Knowledge Base

> 프로젝트의 Knowledge Base입니다. .ai-game-dev/knowledge/에 있는 마크다운 노트로, 프로젝트와 함께 커밋되고 그래프로 인덱싱되어 에이전트가 검색할 수 있습니다. 에이전트는 설계 결정과 컨벤션을 기록하고, 노트를 스페이스로 정리하며, 이동할 때 링크를 고치고 끊어진 링크를 찾아냅니다. 데스크톱 앱은 이 노트를 3D 그래프로 보여 줍니다.

- Id: `aigd.knowledge`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 3D
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 0.3.22 (2026-11-22 게시)
- 라이선스: Apache-2.0
- AI Game Dev 앱 필요: `>=0.25.11`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.knowledge

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

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

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.knowledge`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 0.3.22 | 2026-11-22 | `>=0.25.11` | 최신 |
| 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` | - |

## 설명

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

AI Game Dev 에이전트를 위한 프로젝트의 Knowledge Base입니다. `.ai-game-dev/knowledge/`에 있는 Markdown 노트로, 프로젝트와 함께 커밋되고 git을 통해 팀과 공유됩니다. 이 패키지는 노트와 그 링크를 그래프로 인덱싱하고, 에이전트가 노트를 둘러보고 검색하고 연결하고 정리할 수 있는 도구를 제공하며, 그래프를 3D 창에 표시합니다. 설계 결정과 컨벤션, 시스템이 동작하는 방식을 사람과 에이전트 모두가 찾을 수 있는 곳에 적어 두고 싶은 게임 팀에 적합합니다.

## 할 수 있는 일

- 작업하는 동안 에이전트가 설계 결정과 그 이유, 컨벤션, 쉽게 놓치는 함정을 알맞은 주제 스페이스에 기록하도록 합니다.
- 팀이 어떤 시스템에 대해 무엇을 결정했는지 에이전트에게 물어보세요. 에이전트가 노트를 검색해 답해 줍니다.
- 노트를 스페이스(`README.md`이 있는 폴더)로 정리하고, 링크를 깨뜨리지 않으면서 노트와 폴더를 옮기거나 이름을 바꿉니다.
- 끊어진 링크와 고아 노트를 찾고, 그래프에서 모든 것이 어떻게 연결되어 있는지 확인합니다.
- 데스크톱 앱의 3D 그래프 창이나 사이드 패널 미리보기에서 노트를 직접 둘러봅니다.

## 요청 예시

- "전투 시스템에 고정 60 Hz 물리 스텝을 선택했다는 점과 그 이유를 적어 주세요."
- "우리 세이브 게임 형식에 대해 Knowledge Base에 무엇이라고 나와 있나요?"
- "인벤토리 시스템을 위한 스페이스를 만들고 아이템 노트를 그쪽으로 옮겨 주세요."
- "Knowledge Base에서 끊어진 링크를 확인하고 고쳐 주세요."
- `/kb systems` (Knowledge Base 집계와 끊어진 링크, 그리고 `systems` 스페이스의 트리)

## 작동 방식

노트는 `<project>/.ai-game-dev/knowledge/` 아래의 평범한 Markdown 파일이라 게임과 함께 버전 관리에 들어갑니다. **스페이스**는 `README.md`이 있는 폴더입니다. `# Title`이 먼저 오고, 그다음 한 문단짜리 설명이 옵니다. 노트는 Knowledge Base 루트부터의 경로로 서로 연결됩니다. 예를 들어 `[Combat](/systems/combat.md)`와 같습니다. 상대 링크와 위키링크(`[[Combat]]`)도 인덱싱됩니다.

에이전트는 지침에서 최상위 스페이스 목록을 보고, 한 번에 한 스페이스씩 내려갑니다. 노트 읽기와 쓰기는 평소 쓰는 파일 도구로 하고, 나머지 작업에는 다음 도구를 사용합니다:

| 도구 | 하는 일 |
|---|---|
| `kb_space_get` | 스페이스를 엽니다. 설명, 하위 스페이스, 노트를 보여 줍니다. |
| `kb_space_create` | 스페이스를 만듭니다. `README.md`(제목과 설명)이 있는 폴더입니다. |
| `kb_search` | 제목, 경로, 본문을 기준으로 노트를 순위 매겨 검색하고 스니펫을 함께 보여 줍니다. |
| `kb_links` | 한 노트의, 또는 폴더 안 모든 노트의 나가는 링크, 백링크, 끊어진 링크를 보여 줍니다. |
| `kb_move` | 노트나 폴더를 옮기거나 이름을 바꾸고, 그곳을 가리키는 모든 링크를 다시 씁니다. |
| `kb_lint` | 끊어진 링크, 고아 노트, 컨벤션 문제, 힌트를 보여 줍니다. |

에이전트는 중요하고 오래 남는 지식(결정과 그 이유, 컨벤션, 시스템이 동작하는 방식, 쉽게 놓치는 함정)만 기록하고, 먼저 검색하고, 중복해서 새로 쓰지 않고 기존 노트를 갱신하며, 모든 사실을 사용자가 말한 것 또는 코드가 보여 주는 것에 근거하도록 지침을 받습니다.

이 패키지가 제공하는 것:

- **Knowledge Base** 기능(기본으로 켜짐),
- `/kb [folder or note]` 명령(CLI 및 데스크톱): 노트, 폴더, 링크, 끊어진 링크와 고아 노트, 그리고 트리,
- 데스크톱 앱에서는 3D 그래프 창(상태 표시줄, 세션의 도구 메뉴, 또는 파일 탐색기의 노트나 폴더에서 "Knowledge Base 그래프에서 열기")과 오른쪽 패널의 Knowledge Base 뷰, 그리고 이를 알려 주는 팁을 제공합니다. 그래프는 에이전트가 노트를 쓰는 동안 실시간으로 갱신됩니다.

## 요구 사항

- AI Game Dev 0.25.11 이상. 그래프 창과 사이드 패널은 데스크톱 앱의 일부입니다.
- 프로젝트 폴더, 그리고 노트를 팀과 공유하려면 `git`.

## 라이선스

Apache-2.0.
````
