본문으로 건너뛰기

단톡방 대화내용을 Gitea 이슈로 — Claude Code 게임 개발 워크플로우 사례

댕댕이멍멍

2026.10.07

단톡방 대화내용을 Gitea 이슈로 — Claude Code 게임 개발 워크플로우 사례 본문 이미지

소개

단톡방에 흩어진 플레이테스트 의견을 하루 만에 Gitea 이슈 14개로 만들고, 그중 3개를 처리해 main에 머지했습니다. 사람이 한 일은 CSV 추출, 방향 결정, 확인뿐이었습니다. 나머지는 Claude Code가 tea CLI로 처리했습니다.

  • 상황: 개인 프로젝트로 만드는 2.5D 뱀서라이크 게임(Unity)의 테스트용 APK를 단톡방에 공유했습니다.

  • 문제: 나흘(10월 1~4일) 동안 테스터 4명의 의견이 잡담, 뉴스 공유와 섞여 288개 메시지 속에 흩어져 있었습니다.

  • 해결: 단톡방 → NocoDB → CSV → Claude Code → Gitea 이슈 → 이슈별 작업, 흐름을 하나로 이었습니다.

진행 방법

사용한 도구

새로 도입한 것은 tea CLI 하나입니다. 나머지는 이미 운영 중이던 것을 연결만 했습니다.

  • Tasker + n8n (카톡봇): 단톡방 메시지를 NocoDB에 적재

  • NocoDB (셀프호스팅, Airtable 대안): 대화 저장, 기간 필터, CSV 내보내기

  • Claude Code (AI 코딩 에이전트): 의견 추출, 원인 분석, 이슈 초안, 이슈 처리(코드·테스트·커밋)

  • Codex (두 번째 AI): Claude가 만든 초안 교차 검토(읽기 전용)

  • Gitea (셀프호스팅, GitHub 대안): 게임 저장소, 이슈, PR

  • tea (Gitea 공식 CLI): 라벨·마일스톤·이슈 등록, 댓글, 이슈 닫기, PR 생성·머지

  • tea는 셀프호스팅 Gitea에서도 그대로 쓸 수 있습니다. 설치는 brew install tea, 로그인은 tea login add에 개인 액세스 토큰(PAT)을 넣으면 됩니다.

  • 토큰 등록은 사람이 직접 했습니다. Claude에게 토큰을 보여 주지 않기 위해서입니다.

  • 스킬은 따로 만들지 않았습니다. Claude가 tea --help만 보고도 사용법을 찾아 썼습니다.

전체 흐름

수집은 원래 돌던 카톡봇이 맡고, 사람은 CSV를 뽑아 넘깁니다. 정리부터 PR까지는 Claude Code가 하고, 사람은 제안을 고르고 결과를 확인합니다. 다음 빌드를 단톡방에 올리면 같은 흐름이 다시 돕니다.

아래 각 단계에는 실제로 쓴 프롬프트를 그대로 옮겨 두었습니다. 프롬프트는 짧아도 충분했습니다. 프로젝트 규칙은 CLAUDE.md에, 설계는 Design.md에 이미 적혀 있었기 때문입니다.

1. 단톡방을 NocoDB에 적재하기

  • 핸드폰의 Tasker가 카톡 알림을 잡아 n8n 웹훅으로 보내고, n8n이 NocoDB 테이블에 행을 추가합니다.

  • 이 워크플로우를 위해 만든 게 아니라 원래 돌리던 시스템입니다. 덕분에 따로 수집하지 않아도 테스터 의견이 쌓여 있었습니다.

2. APK를 공유하고 의견 받기

  • 단톡방에 테스트 빌드(Android 0.1.0)를 올렸습니다. 빌드에는 git 태그 playtest-1을 붙여, 나중에 어느 커밋에 대한 의견인지 알 수 있게 했습니다.

  • 테스터들은 평소처럼 단톡방에서 이야기했습니다. 설문지나 양식은 없었습니다.

3. NocoDB에서 CSV 뽑기

  • NocoDB 화면에서 해당 단톡방의 APK 공유 시각 이후 행만 필터하고, CSV를 직접 내려받았습니다.

  • 결과: date_time, sender, message 3개 열, 메시지 288개(10월 1일~7일).

  • CSV는 프로젝트 docs/report/에 두었지만 커밋하지 않았습니다. 테스터 실명과 게임과 무관한 대화가 들어 있어서입니다.

4. Claude Code로 의견을 뽑고 이슈 초안 만들기

한 번에 "이슈 만들어줘"라고 하지 않고, 문서를 하나씩 쌓아 가며 검토했습니다.

  1. 의견 추출 → playtest1-feedback.md

    • 프롬프트: "카톡 대화 내용 중에 이 게임을 플레이하고 의견을 준 사람들의 의견들만 추출해서 md 파일로 정리해줘."

    • 잡담과 개발자 본인의 말을 빼고, 난이도·무기·UI·조작·콘텐츠 요청 주제별로 묶었습니다.

  2. 원인 분석과 작업 제안 → playtest1-action-plan.md

    • 프롬프트: "이 문서를 기반으로 어떤 작업을 진행하면 좋을지 정리해줘."

    • Claude가 게임 데이터와 코드를 직접 열어 의견을 수치에 맞춰 봤습니다. 예: "민수같이 생긴 놈은 경험치가 짜다" → 구울의 체력/경험치 비율이 일반 적 중 가장 나쁨(70/3).

  3. Codex 교차 검토

    • 프롬프트: "넌 뭐를 했으면 좋겠어? codex 한테도 물어봐서 의견 종합해서 제안해줘."

    • Codex가 초안의 사실 오류 4개를 잡았습니다. Claude가 각 지적을 코드에서 다시 확인한 뒤 반영했습니다.

  4. 이슈 단위로 쪼개기 → playtest1-issues-draft.md

    • 프롬프트: "가능하면 쪼개서 이슈로 등록하고 싶어. 명확하게 작업을 분리해서 정리해볼래? 이슈 등록은 같이 검토가 끝난 다음에 할 거야."

    • 이슈마다 배경(테스터 원문), 할 일, 완료 기준을 넣었습니다. 값을 바꾸는 밸런스 이슈는 "한 번에 하나씩" 바꾸도록 나눴습니다.

5. tea로 Gitea에 이슈 등록하기

  • 프롬프트: "우선 이슈 14개를 등록해줄래?"

  • Claude가 라벨 8개(playtest-1, ux, balance 등)와 마일스톤 playtest-2를 만들고, 이슈 14개를 등록했습니다.

  • 등록 전에 "이게 어떤 APK 버전에 관련된 것인지 명시할 수 있나?"를 물었습니다. 그래서 이슈 본문 첫 줄에 빌드 버전·태그·커밋을 넣고, 이슈에 playtest-1 태그를 연결했습니다.

tea labels create --name balance --color "#..."
tea milestones create --title playtest-2
tea issues create -t "[UX] 게임 시작 시 클리어 목표 표시" -d "..." -L playtest-1,ux -m playtest-2

6. 순서를 제안받고 하나씩 처리하기

  • 프롬프트: "git 이슈에 등록된 내용 중 어떤 것부터 하면 좋을지 순서대로 리스트업해줘." → "응 #1부터 시작해줘"

  • 이슈 하나는 이 순서로 처리했습니다.

    1. Design.md(설계 문서)를 먼저 고칩니다.

    2. 코드를 고치고 EditMode 테스트를 추가·실행합니다.

    3. Claude가 Unity Play를 돌려 게임 화면을 캡처하고 직접 확인합니다.

    4. 사람이 확인하고 "커밋하고 #1을 닫아줘"라고 하면, 커밋 메시지에 (#1)을 넣어 커밋합니다.

    5. tea comment로 결과 댓글(커밋, 변경 내용, 검증, 게임 화면)을 달고 이슈를 닫습니다.

  • 세션이 길어지면 "핸드오프 문서 생성" → /clear → 새 세션에서 이어 갔습니다. CLAUDE.md에 "세션을 시작하면 최신 핸드오프를 읽는다"는 규칙을 넣어 두었습니다.

  • 모인 커밋은 tea pr create로 PR을 만들고 tea pr merge로 main에 합쳤습니다.

결과와 배운 점

실제 결과

10월 7일 하루, Claude Code 세션 5개로 이슈 14개를 등록하고 3개를 닫았습니다. 세 이슈는 PR #15 하나로 main에 머지했습니다.

  • 닫힘: #1 게임 시작 시 클리어 목표 표시, #2 군주를 중간 보스로 표시하고 처치 후 다음 목표 안내, #3 레벨업 카드에 진화 조건 표시

  • 열림(입력): #4 모바일 조이스틱 이동 응답 개선

  • 열림(도구): #5 결과 화면에 레벨·진화 시각·입력 방식 표시, #6 무기별 피해 집계 수정

  • 열림(밸런스): #7 구울, #8 군주 체력, #9 8:30 이후 스폰, #10 오라 넉백

  • 열림(조사): #11 후반 제자리 생존, #12 연속 피격

  • 열림(질문·릴리스): #13 테스터 확인 사항, #14 playtest-2 빌드 배포

  • 이슈로 만들지 않기로 한 요청도 문서에 남겼습니다: 스테이지 추가, 업적, 무기 전체 상향, 적 전체 하향 등.

  • 닫은 이슈마다 EditMode 테스트를 돌렸습니다(마지막 78개 통과). 이슈 댓글에는 커밋 번호와 게임 화면 캡처를 남겼습니다.

  • 산출물 문서: playtest1-feedback.md(의견), playtest1-action-plan.md(원인 분석), playtest1-issues-draft.md(이슈 본문), 핸드오프 3개.

해보니 좋았던 점

가장 큰 수확은 테스터의 말 한 줄이 이슈·커밋·PR까지 끊기지 않고 이어진 것입니다. 대신 사람이 확인하는 지점은 분명히 남겨 두어야 합니다.

  • 수집 비용이 0이었습니다. 테스터에게 설문을 부탁하지 않았습니다. 이미 쌓이던 단톡 대화가 그대로 자료가 됐습니다.

  • 의견이 데이터로 확인됐습니다. Claude가 게임 데이터를 열어 "너무 안 죽는다"를 "4분 구간에 적 평균 체력이 약 14에서 35로 뛴다"로 바꿔 주었습니다.

  • 이슈를 끝까지 추적할 수 있습니다. 이슈 → 테스터 원문 → 빌드 태그 playtest-1 → 커밋 (#1) → PR #15로 이어집니다.

  • tea 하나로 Gitea 작업을 끝냈습니다. 브라우저를 열지 않고 라벨·이슈·댓글·PR까지 처리했습니다.

  • AI 둘의 교차 검토가 효과가 있었습니다. Codex가 초안의 사실 오류 4개를 잡아냈습니다.

주의할 점

  • 개인정보. 단톡 CSV에는 실명과 사적인 대화가 있습니다. CSV는 커밋하지 않았고, 스크린샷은 계정명·서버 주소·아바타를 가린 뒤 찍었습니다.

  • 토큰은 사람이 등록합니다. tea 로그인에는 read:user 권한이 필요합니다. 처음에 write:repository만 주었다가 로그인이 거부됐습니다.

  • 판단은 사람이 합니다. 이슈 등록, 커밋, 이슈 닫기, PR 머지는 모두 "진행해줘" 한마디를 듣고 나서 했습니다. 무엇을 할지는 Claude가 제안하고 사람이 골랐습니다.

  • 세션은 짧게 끊습니다. 이슈 1~2개마다 핸드오프를 쓰고 새 세션을 열었습니다. 다음 세션은 메모 한 장으로 바로 이어 갔습니다.

앞으로의 계획

다음 플레이테스트(playtest-2)에서도 같은 흐름을 돌리되, 사람 손이 가는 구간을 줄여 볼 생각입니다.

  • CSV 내보내기 대신 NocoDB API로 기간을 지정해 Claude Code가 직접 읽게 하기

  • tea 사용법과 빈곳 우회 방법이 더 쌓이면 Claude Code 스킬로 묶기

도움 받은 글 (옵션)

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기