# 게임 프로젝트를 위한 지식 베이스 — AI가 대화 사이에 기억하는 메모리 — AI Game Dev

게임 디자인 결정과 규칙, 문서를 지식 베이스에 두면 AI 에이전트가 읽고 갱신하며, 프로젝트와 함께 Git에 커밋되고 3D 그래프로 표시됩니다.

이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/blog/game-project-knowledge-base-for-ai).

[블로그](https://ai-game.dev/ko/blog)

게임 디자인 결정과 규칙, 문서를 지식 베이스에 두면 AI 에이전트가 읽고 갱신하며, 프로젝트와 함께 Git에 커밋되고 3D 그래프로 표시됩니다.

Ivan Murzak · 2026년 10월 26일 · 6분 소요 ·

AI 에이전트와의 새 대화는 매번 빈 기억에서 시작합니다. 전투 규칙을 다시 설명하고, 명명 규칙을 다시 설명하고, 아트 스타일을 다시 설명해도 에이전트는 지난주에 세이브 파일에 대해 내린 결정을 여전히 잊어버립니다. AI Game Developer의 지식 베이스가 이 문제를 해결합니다. 에이전트가 읽고 검색하고 갱신하는 게임 프로젝트 지식 베이스로, 프로젝트 안에 Markdown 노트로 보관되고 게임의 나머지와 함께 Git에 커밋됩니다.

이 글에서는 데모 게임인 Skyward Keep의 한 세션을 통해 이것이 어떻게 작동하는지, 지식 베이스에 무엇을 넣어야 하는지, 그리고 세션이 바뀌어도 에이전트가 일관된 결정을 내리도록 어떻게 함께 작업해야 하는지 보여줍니다. 영상은 앱을 실제로 녹화한 것입니다. 에이전트의 답변은 데모를 위해 대본으로 작성되었고, 영상 속 모든 도구 호출은 실제로 실행되었습니다.

한 대화에서 기록된 결정을 완전히 새로운 대화에서 떠올린다.

## 지식 베이스란 무엇인가

지식 베이스는 프로젝트 안 .ai-game-dev/knowledge/ 에 있는 평범한 Markdown 노트 폴더입니다. 저장소 안의 일반 파일이기 때문에:

- Git으로 버전 관리되므로 디자인 결정의 모든 변경에 이력이 남고 풀 리퀘스트에서 검토할 수 있습니다.
- 프로젝트와 함께 따라갑니다. 저장소를 클론한 팀원도, 그 팀원의 에이전트도 같은 지식을 얻습니다.
- 앱이 아니라 어떤 편집기에서든 노트를 읽고 편집할 수 있습니다.

파일 위에 앱은 인덱스를 유지합니다. 노트 사이의 링크를 추적하고, 끊어진 링크를 보고하며, 에이전트가 노트를 탐색하고 검색하고 읽고 정리할 수 있는 도구를 제공합니다. 인덱스는 노트가 바뀔 때마다 증분 갱신되므로, 한 세션에서 에이전트가 작성한 노트를 다음 세션에서 사용할 수 있습니다.

## 스페이스: 노트가 구성되는 방식

README가 있는 지식 베이스 폴더는 모두 스페이스이며, 제목과 그 안에 무엇이 들어갈지에 대한 짧은 설명을 가집니다. 에이전트는 스페이스의 짧은 목록을 보고 필요할 때만 하나를 열며, 새로 만들 수도 있습니다. 덕분에 컨텍스트가 작게 유지됩니다. 모든 대화에 모든 노트를 불러오지 않고, 작업에 중요한 스페이스로 찾아갑니다.

게임에 잘 맞는 구성:

- design: 핵심 루프, 메커니즘, 진행, 경제.
- systems: 전투, 인벤토리, 저장, 대화가 어떻게 구현되는지.
- art: 스타일 가이드, 팔레트, 에셋 명명과 임포트 설정.
- audio: 음악 방향, 효과음 규칙, 믹싱 레벨.
- decisions: 이유와 함께 남긴 선택 기록.
- references: 참고 중인 게임과 도구에 대한 링크와 노트.

구조를 직접 만들 필요는 없습니다. 에이전트에게 요청하세요. "design, systems, art, decisions 스페이스를 각각 한 단락짜리 설명과 함께 만들어줘."

## 결정이 남도록 기록하기

가장 가치 있는 노트는 결정입니다. 대화에서 결정을 말하면, 에이전트는 그 이유와 무엇을 대체했는지와 함께 기록하고, 새 노트를 해당 스페이스의 README에서 링크합니다.

데모에서 결정은 아트 스타일에 관한 것입니다:

"수작업 페인팅 스타일로 가자. 부드러운 텍스처, 따뜻한 림 라이트, 외곽선 없음. 64 px에서 셀 셰이딩 테스트보다 더 잘 읽혔어."

에이전트는 먼저 지식 베이스에 이미 적힌 내용을 확인하고, 스타일 탐색 노트에서 열린 질문을 찾습니다. 두꺼운 외곽선의 셀 셰이딩인지, 부드러운 수작업 페인팅 텍스처인지. 그다음 art direction 스페이스에 Visual style: hand-painted 라는 새 노트를 작성하며, 결정과 이유(수작업 페인팅 히어로는 64 픽셀에서도 판독성이 유지된 반면 셀 셰이딩 외곽선은 노이즈가 되었다), 그리고 무엇을 대체하는지를 담습니다. 열린 질문은 새 노트 링크와 함께 해결됨으로 표시하고, 해당 스페이스의 README에서 이 노트를 링크합니다. 노트는 평범한 Markdown이며 프로젝트와 함께 커밋되므로 모든 새 대화와 모든 팀원이 이를 얻습니다.

결정이 노트로 기록되고 스페이스에 링크되며 그래프에 표시된다

기록할 만한 결정은 이런 모습입니다:

- "플랫포밍에는 일정한 점프 높이가 필요하므로 물리에는 50 Hz 고정 타임스텝을 쓴다. 가변 타임스텝을 대체한다."
- "적 체력은 항상 10의 배수로 한다. 그래야 데미지 숫자가 읽기 쉽다."
- "모든 아이템 아이콘은 정사각형이고, 가운데 정렬이며, 단색 어두운 배경 위에 둔다."

다음 세션이 물리, 적, UI를 다룰 때 에이전트는 지식 베이스에서 그 결정을 찾아 따릅니다. 데모에서는 완전히 새로운 대화에 "Skyward Keep에서 어떤 아트 스타일을 골랐고 왜?"라고 묻고, 에이전트는 그 노트를 출처로 인용하며 결정과 이유를 답합니다.

완전히 새로운 대화가 결정과 이유를 찾아낸다

마음이 바뀌면 말하기만 하면 됩니다. 노트는 새 이유와 함께 갱신되고, Git은 이전 버전을 보관합니다.

### 에이전트에게 지식 베이스를 확인하라고 요청하기

에이전트에게 지식 베이스를 직접 가리킬 수 있습니다. "인벤토리를 바꾸기 전에 systems 스페이스를 읽고 어떤 규칙이 적용되는지 알려줘." 또는 /kb 명령으로 요약을 요청할 수 있는데, 이 명령은 전체 베이스나 특정 폴더에 대해 노트 트리, 링크, 끊어진 링크를 보여줍니다.

## 지식 베이스를 건강하게 유지하기

지식 베이스는 연결되어 있고 최신일 때만 쓸모가 있습니다. 도구들이 이를 돕습니다:

- 노트 간 링크가 추적되며, 노트나 폴더별로 나가는 링크, 백링크, 끊어진 링크를 볼 수 있습니다.
- 린트 검사는 끊어진 링크, 고아 노트, 규칙을 따르지 않는 노트를 보고합니다. 스페이스에 소속된 노트는 고아로 계산되지 않습니다.
- 프로젝트가 커지면 노트를 폴더 간에 옮길 수 있습니다.

몇 주에 한 번씩 에이전트에게 린트 검사를 실행하고 발견된 문제를 고치라고 요청하세요. 코드 리팩터링처럼 생각하면 됩니다. 작고 규칙적인 정리가 전체를 쓸 만하게 유지합니다.

## 3D 그래프

지식 베이스는 자체 창에서 애니메이션되는 3D 그래프로 열립니다. 폴더는 링이고, 노트는 연결 정도에 따라 크기가 정해지고 폴더별로 색이 칠해진 노드이며, 포함 관계와 링크를 선으로 보여줍니다. 디자인의 어느 부분이 잘 문서화되어 있고 어떤 노트가 혼자 떨어져 있는지 빠르게 볼 수 있는 방법입니다.

여러 곳에서 열 수 있습니다. 프로젝트의 노트 수를 보여주고 에이전트가 노트를 작성할 때 맥동하는 상태 표시줄 항목, 세션의 Tools 행에 있는 "지식 베이스 그래프 열기" 버튼, Explorer의 폴더나 노트에서 "지식 베이스 그래프에서 열기", 그리고 오른쪽 패널의 Knowledge Base 뷰입니다.

## 무엇을 넣고 무엇을 빼야 할까

에이전트가 코드에서 알아낼 수 없는 것들, 즉 의도, 제약, 이유, 관례에 대해 노트를 쓰세요. 모든 클래스 목록처럼 코드가 이미 말해주는 것들은 금방 낡아버리므로 빼세요.

새 프로젝트와 함께하는 좋은 첫 주:

1. 에이전트에게 스페이스를 만들게 한다.
2. 핵심 루프에 관한 노트 하나, 아트 스타일에 관한 노트 하나를 쓴다.
3. 결정을 내릴 때마다 대화에서 말하고, 에이전트가 기록하게 한다.
4. 주말에 그래프를 열고 에이전트에게 베이스 린트를 요청한다.

지식 베이스는 0.21.0 릴리스에서 등장했고, 0.22.1 ([https://ai-game.dev/releases/0.22.1](https://ai-game.dev/releases/0.22.1)) 에서 스페이스와 함께 더 쉽게 접근할 수 있게 되었습니다. Unity, Godot, Unreal 프로젝트 모두에서, 그리고 일반 폴더에서도 작동합니다. [ai-game.dev/download](https://ai-game.dev/download) 에서 앱을 내려받아 다음 세션에 기억을 선물하세요.

## 블로그의 다른 글

[전체 글](https://ai-game.dev/ko/blog)

### [레퍼런스 이미지에서 게임에 바로 쓸 3D 모델까지 — AI Game Developer 속 Tripo AI](https://ai-game.dev/ko/blog/tripo-ai-3d-models-from-reference-images)

2026년 10월 26일

AI Game Developer에서 Tripo로 2~4장의 레퍼런스 뷰를 하나의 3D 모델로 만들고, 같은 채팅에서 텍스처와 정리, 리깅, 애니메이션까지 처리하세요.

Ivan Murzak 7분 소요

### [계획 먼저, 그다음 변경 — 게임 개발에서 AI 에이전트를 위한 플랜 모드](https://ai-game.dev/ko/blog/plan-mode-ai-agent-game-development)

2026년 10월 26일

AI Game Developer의 플랜 모드, 명확화 질문, 메시지 큐, 코드 리뷰 카드로 큰 게임 작업에서도 AI 에이전트를 통제하세요.

Ivan Murzak 6분 소요

---

Source (HTML): https://ai-game.dev/ko/blog/game-project-knowledge-base-for-ai

Machine-translated (ko) from the English page: https://ai-game.dev/blog/game-project-knowledge-base-for-ai