AI 팀으로 마크 서버 만들기#1AI 팀장 1명 + 팀원 15명으로 MMORPG 플러그인 만드는 구조! 🤖

안녕하세요! Mojangcam입니다 😎

요즘 지인들과 마인크래프트 MMORPG 서버를 만들고 있어요. 레벨·스탯·클래스·스킬·퀘스트·상점·몹·펫까지 전부 직접 만든 플러그인으로 돌아가는 서버예요. 문제는 이걸 거의 혼자 만들어야 한다는 거였죠.

그래서 방법을 바꿨어요. AI(Claude) 한 명을 "개발팀장"으로 두고, 그 아래에 기획·디자인·모듈별 개발팀 15개를 AI 예약 작업으로 붙였어요. 저는 방향을 정하고, 게임에 들어가 테스트하고, 결정만 내려요.

이 시리즈는 그렇게 1주일 동안 만든 기록이에요. 1편에서는 "AI 팀이 어떻게 일하는지" 구조부터 정리해 볼게요.

• 🧑‍💼 팀장 1명 + 팀원 15명은 각자 무슨 일을 하나
• 📄 지시서와 보고서는 어떻게 생겼나
• 🔀 여러 팀이 동시에 코드를 만질 때 어떻게 합치나
• 🧯 실제로 팀이 멈췄던 사건들

📌 왜 "AI 팀"으로 나눴나 🧠

처음엔 AI 대화창 하나에서 전부 만들었어요. 그런데 모듈이 늘어날수록 문제가 생겼어요.

1. 맥락이 넘쳐요 — 전투 공식을 고치다가 퀘스트 코드를 잊어버려요.
2. 동시에 못 해요 — 한 번에 한 가지만 진행돼요.
3. 기록이 안 남아요 — "그때 왜 이렇게 정했지?"를 다시 찾기 어려워요.

그래서 실제 회사처럼 나눴어요. 팀원은 자기 모듈 폴더만 보고, 팀장은 전체 그림과 합치기만 봐요.

📌 1단계 - 지시서: 말하지 말고 파일에 적기

팀원(예약 작업)은 매번 기억 없이 새로 시작해요. 그래서 할 일을 전부 파일에 적어 둬요. 팀마다 orders/<팀>.md 파일이 있고, 규칙은 딱 세 개예요.

• 맨 위 ## 이번 실행 절이 이번에 할 일
• 예전 지시는 ## (이전 실행)으로 이름만 바꿔서 아래로 (지우지 않음)
• 팀장은 팀을 실행할 때 말을 덧붙이지 않아요. 지시는 파일에만

실제 지시서는 이런 모양이에요 (일부 줄임).

## 이번 실행 — 2026-09-30 #9 — 퀘스트 GUI 그림 연결
근거: 사용자 요청. 슬롯 배치 정본 = design/prompts-for-user_v7.md ① §3 표.
1. 배경: 창 제목 = 음수 공백 + 배경 글리프 + 흰 제목 (오르벨 메뉴와 같은 방식)
2. 아이콘 = item_model myserver:gui/quest/<id>, 설명은 전부 툴팁으로
3. 일지: 탭 0-1 메인 · 2-3 서브 · 4-5 일일 · 6-7 완료, 9-44 목록 36칸 …
9. 테스트: 슬롯 배치 단위 테스트, quest/ 밖 파일 수정 금지
시간: 11:45 전에 끝나면 오늘 테스트 빌드에 넣음

하나씩 뜯어볼게요 💡

• 근거 : 누가 왜 요청했는지. 나중에 "왜 이렇게 했지?"의 답이 돼요.
• 번호 목록 : 팀원이 그대로 체크리스트로 써요.
• 테스트·범위 : "자기 폴더 밖은 건드리지 마" 같은 울타리를 매번 적어요.
• 시간 : 급한 건 "몇 시까지 되면 이번 빌드, 아니면 다음"처럼 적어서 서두르다 망가뜨리지 않게 해요.

말 대신 파일에 적으니까, 같은 작업을 다시 돌려도 결과가 거의 같고 지시 이력이 그대로 남아요. 이게 제일 큰 장점이었어요.

📌 2단계 - 보고서: 팀장이 3분 안에 읽을 수 있게

팀원은 끝날 때 reports/<팀>/YYYY-MM-DD_HHMM.md에 보고서를 남겨요. 형식이 고정돼 있어서 팀장이 빨리 읽을 수 있어요.

특히 ①과 ⑦이 중요해요. AI는 모르는 걸 그럴듯하게 정해 버리는 경향이 있는데, "가정"으로 따로 적게 하니까 제가 나중에 한 번에 확인할 수 있었어요.

📌 3단계 - 합치기: 팀은 브랜치에서, main은 팀장만

모듈 13개를 동시에 만지니까 코드 충돌이 제일 걱정이었어요. 규칙은 이렇게 잡았어요.

• 팀마다 git worktree로 자기 작업 폴더 + 자기 브랜치(module/<팀>)
• 팀원은 자기 모듈 폴더 밖 파일을 바꾸지 않음 — 코어에 필요한 게 있으면 "코어 요청"으로 적기만
• main에 합치기·빌드·서버 배포는 팀장 한 명만
• 합치기 전에 팀장이 두 가지를 기계적으로 검사
  • 브랜치가 자기 폴더 밖을 건드렸는지
  • 권한 노드 이름이 규칙(myserver.<모듈>.…)을 지켰는지

# 이 브랜치가 자기 모듈 밖 폴더를 바꿨는지 (결과가 비어 있어야 통과)
git diff --name-only main...module/quest | cut -d/ -f1 | sort -u | grep -vx quest

두 번째 검사가 왜 생겼는지는 2편에서 얘기할게요. (모듈 두 개가 통째로 꺼진 사건이 있었어요 😅)

빌드가 끝나면 jar를 서버의 plugins/update/ 폴더에 올려 두고, 서버를 재시작할 때 새 버전이 들어가게 했어요.

📌 AI 팀이 멈췄던 사건들 🧯

1. 팀이 조용히 멈춤 — "승인 대기"

한동안 팀원들이 작업을 끝내지 못하고 멈춰 있었어요. 에러도 없고 알림도 없었어요. 원인은 파일 삭제 권한 요청이었어요. 작업 규칙에 "필요하면 삭제 권한을 요청해라"라고 적어 뒀더니, 팀원이 정리하려고 권한을 요청하고 사람이 승인할 때까지 기다리고 있었던 거예요.

해결은 규칙을 바꾸는 거였어요.

• 팀원은 파일을 지우지 않는다. 필요 없는 파일은 _to_delete/<팀>/으로 옮기기만
• git에서 빼야 하는 파일은 git rm --cached로만
• 사람 승인이 꼭 필요하면 기다리지 말고 보고서에 "막힘"으로 적고 끝내기

AI 팀에서 제일 무서운 건 에러가 아니라 아무 말 없이 기다리는 것이었어요.

2. git 잠금 파일

여러 작업이 같은 저장소를 만지다 보니 index.lock, HEAD.lock이 남아서 다음 작업이 막히는 일이 잦았어요. 지우는 대신 고유한 이름을 붙여 다른 폴더로 옮기는 규칙으로 해결했어요.

3. PC가 잠들면 팀도 잠듦

팀원들은 제 PC에 연결된 폴더에서 일해요. PC가 절전에 들어가면 연결이 끊겨요. 팀장이 연결을 확인하고, 안 되면 1시간 뒤 다시 시도하도록 스스로 예약하게 했어요.

📌 사람이 한 일 vs AI가 한 일 💬

결국 제가 제일 많이 한 일은 게임에 들어가서 보고, 짧게 말하는 것이었어요. 이 역할 분담이 이 시리즈의 핵심이에요.

📌 마무리

오늘은 AI 팀이 일하는 구조를 정리했어요.

• 지시는 파일에, 보고는 고정된 형식으로
• 팀은 자기 브랜치에서만, 합치기는 팀장 한 명만
• AI 팀이 멈추는 가장 흔한 이유는 사람 승인 대기

다음 편에서는 플러그인 하나에 코어 + 모듈 13개를 넣은 구조와, 모듈이 통째로 꺼진 사건, 데미지가 1000029로 뜬 사건을 다룰게요. 기대해주세요 🙌

이 글은 제가 방향을 정하고 Claude와 함께 정리했어요. 이 서버는 개인 프로젝트이며, 마인크래프트 공식 콘텐츠가 아니고 Mojang·Microsoft와 관계없습니다.