계획 먼저, 그다음 변경 — 게임 개발에서 AI 에이전트를 위한 플랜 모드

AI 에이전트는 빠릅니다. 그리고 바로 그렇기 때문에 큰 작업이 순식간에 잘못될 수 있습니다. 무엇을 해야 하는지 합의하기도 전에 코드를 고치기 시작하기 때문입니다. AI Game Developer의 플랜 모드는 이를 뒤집습니다. 에이전트가 프로젝트를 읽고 계획을 작성하며, 승인하기 전까지 모든 변경은 거부되고, 승인 후에야 작업을 시작합니다.

명확화 질문, 메시지 큐, 코드 리뷰 파인딩 카드와 함께라면 플랜 모드는 더 큰 게임 개발 작업에서 AI 에이전트를 조종하는 간단한 방법을 제공합니다. 이 글에서는 데모 게임 Skyward Keep의 한 세션에서 이 모든 것을 활용해 플레이어 캐릭터에 활강을 추가합니다. 영상은 앱의 실제 녹화본입니다. 에이전트의 응답은 데모를 위해 대본으로 작성되었고, 영상 속 모든 도구 호출은 실제로 실행되었습니다.

에이전트가 편집하기 전에 계획해야 하는 이유

"점프를 더 높게 해줘" 같은 작은 요청에는 계획이 필요 없습니다. 더 큰 요청에는 필요합니다. 새로운 이동 능력은 플레이어 컨트롤러, 입력, 튜닝 값, 문서, 그리고 종종 오디오까지 건드립니다. 에이전트가 그중 하나를 잘못 추측하면 여러 파일에 걸친 변경을 되돌려야 합니다.

계획은 세 가지 문제를 한 번에 해결합니다.

• 무엇이 바뀌기 전에 범위를 볼 수 있습니다. 어떤 파일, 어떤 시스템, 어떤 순서인지.
• 오해는 문장 하나로 고칠 수 있는 이른 시점에 드러납니다.
• 승인한 계획은 결과를 리뷰할 때 쓰는 체크리스트가 됩니다.

1단계: 플랜 모드 켜기

플랜 모드는 컴포저의 세션별 스위치입니다. 작업을 보내기 전에 켜세요. 플랜 모드에서 에이전트는 파일을 읽고 프로젝트와 노트를 검색할 수 있지만, 계획을 제시할 때까지 모든 변경은 거부됩니다.

그다음에는 단계가 아니라 목표를 설명하세요. 데모 요청은 짧습니다.

"활강 추가: 공중에서 점프를 누르고 있으면 Wren의 망토로 활강."

에이전트는 플레이어 컨트롤러와 프로젝트의 플레이어 능력 관련 노트를 읽는 것으로 시작합니다.

2단계: 에이전트의 질문에 답하기

좋은 계획에는 당신만이 내릴 수 있는 몇 가지 결정이 필요합니다. 에이전트는 선택지가 있는 질문을 할 수 있고, 그 질문은 입력창 위로 슬라이드되어 나옵니다. 데모에서는 계획을 작성하기 전에 디자인 질문 하나를 던집니다. "Wren은 얼마나 오래 활강할 수 있나요?" 세 가지 선택지가 있습니다.

• 3초의 스태미나, 착지 시 회복되어 아늑한 페이스를 유지합니다.
• 점프를 누르고 있는 동안 무제한.
• 업그레이드 가능, 1.5초에서 시작해 망토 업그레이드로 늘어납니다.

질문이 여러 개면 편집 가능한 설문이 됩니다. 아무 질문이나 클릭해 다시 보고, 이전 답을 바꾸거나 건너뛸 수 있으며, 모든 질문에 답이 있어야만 답변이 전송됩니다. 답하는 데 1분이면 되고, 나중에 재작업 한 라운드를 아낄 수 있습니다. 프로젝트에 Knowledge Base가 있으면 에이전트가 이미 정해 둔 규칙을 그곳에서 읽고 질문을 더 적게 합니다.

3단계: 계획 검토하기

에이전트는 승인 카드와 함께 계획을 제시하며, 카드에는 두 가지 선택지가 있습니다. 승인하고 실행, 또는 계속 계획하기. 데모 계획에는 네 항목이 있습니다.

1. 새 Glide 스크립트: 공중에서 하강 중일 때 점프를 누르고 있으면 하강 속도를 2.5 m/s로 제한합니다.
2. 질문에 대한 답인 3초의 스태미나로, 활강 중 소모되고 착지 시 회복됩니다.
3. 플레이어 컨트롤러가 중력 적용 후 활강을 호출하며, 점프 버퍼링이나 코요테 타임은 바뀌지 않습니다.
4. 활강 규칙이 Knowledge Base의 Player abilities 노트에 추가됩니다.

또한 활강 액션이 이미 존재하므로 입력 바인딩은 변경할 필요가 없다고 언급합니다.

팀 동료의 디자인 노트를 읽듯 계획을 읽으세요. 꼭 건드려야 할 파일만 건드리나요? 순서가 합리적인가요? 빠진 것은 없나요? 뭔가 잘못됐다면 계속 계획하기를 선택하고 무엇을 바꿔야 하는지 입력하세요. 에이전트가 계획을 수정해 다시 보여줍니다. 맞으면 승인하세요. 그러면 에이전트가 작업을 시작합니다.

4단계: 작업 중에 메시지 대기열에 넣기

에이전트가 작업하는 동안 여러 가지 생각이 떠오릅니다. 이제 기다리거나 방해할 필요가 없습니다. 데모에서는 활강이 구현되는 동안 후속 요청을 입력해 대기열에 넣습니다.

"활강이 시작될 때 부드러운 휙 소리도 재생해 줘."

실행 중인 턴에 보낸 메시지는 컴포저 위의 대기열 서랍에서 기다립니다. 즉시 보내거나 다시 컴포저로 끌어와 편집할 수 있습니다. 중지를 누르면 실행 중인 턴이 취소되고 대기열에 있던 텍스트가 컴포저로 돌아오므로, 철회한 메시지가 실행되는 일은 결코 없습니다. 에이전트는 승인된 계획을 먼저 끝내고 나서 대기열에 넣은 요청을 처리합니다.

도구 권한 요청도 같은 서랍에 나타나며, 프롬프트가 열려 있는 동안 세션에 당신을 기다리는 표시가 나타나므로 어떤 세션이 당신을 필요로 하는지 한눈에 볼 수 있습니다.

5단계: 코드 리뷰 카드로 결과 확인하기

작업을 넘기기 전에 에이전트가 자신의 변경 사항을 리뷰합니다. 코드 리뷰 결과는 파인딩 카드로 표시되며, 각 카드에는 판정, 파일과 줄, 카테고리, 짧은 요약, 그리고 그 문제가 게임에서 어떻게 드러날지 설명하는 실패 시나리오가 담깁니다. 아무것도 발견되지 않으면 카드가 그렇게 분명히 알려줍니다.

데모에서 리뷰 카드는 두 가지 파인딩을 보여줍니다.

• 확인 후 수정됨: 착지 시 스태미나가 회복되지 않았습니다. 3초간 활강하고, 착지하고, 다시 점프하면 두 번째 활강이 시작되지 않습니다.
• 그럴듯하지만 당신이 판단하도록 남김: 활강이 이전 프레임의 지면 상태를 읽기 때문에, 점프를 누른 채 움직이는 발판에 착지하면 지면에서 한 프레임 동안 활강 속도가 적용될 수 있습니다.

카드를 할 일 목록으로 다루세요. 동의하는 파인딩은 에이전트에게 수정을 요청하고, 나머지를 건너뛰는 이유는 말해 주세요. 그런 다음 승인한 계획을 항목별로 확인하고 게임을 플레이하세요. 코드상 올바른 활강도 플레이해 보면 어색하게 느껴질 수 있습니다.

긴 세션을 건강하게 유지하기

큰 작업은 에이전트의 컨텍스트를 채웁니다. 긴 세션에서 관련 없는 새 작업을 막 시작하려 할 때 컴포저가 새로 시작할 것을 제안하여 한도를 아낄 수 있습니다. 이 제안은 에이전트가 유휴 상태이고 컨텍스트가 클 때만 나타나며, 언제든 현재 세션에서 계속 작업할 수 있습니다. 좋은 리듬은 기능당 세션 하나입니다. 계획하고, 만들고, 리뷰한 뒤 다음 기능은 새 세션에서 시작하세요.

재사용할 수 있는 워크플로

파일 두어 개 이상을 건드리는 모든 작업에 대해:

1. 플랜 모드를 켜고 목표를 설명합니다.
2. 에이전트의 질문에 답합니다.
3. 계획을 검토하고 제대로 될 때까지 계속 계획합니다.
4. 승인하고, 방해하는 대신 후속 생각을 대기열에 넣습니다.
5. 파인딩 카드로 변경 사항을 리뷰한 뒤 플레이테스트합니다.

플랜 모드와 에이전트 질문은 0.25.0 릴리스에서, 메시지 큐와 파인딩 카드는 0.25.8 (https://ai-game.dev/releases/0.25.8) 에서 등장했습니다. 엔진별 모범 사례는 ai-game.dev/docs/best-practices 에서 AI 에이전트를 위해 작업 크기를 어떻게 정할지 더 자세히 다룹니다. ai-game.dev/download 에서 앱을 내려받아 다음 기능에 플랜 모드를 사용해 보세요.