버그 몬스터를 물리치고, 나만의 코딩 도감을 완성하는 픽셀 아트 교육 게임
한국어 · English
서버 구름 위 픽셀 마을 코드빌(Codeville) 에는 코드 속 개념이 버그 몬스터가 되어 돌아다닙니다. 막 첫 모험을 떠난 주니어 개발자가 되어 몬스터와 맞서고, 그 개념을 정말 이해했는지 증명해 나만의 도감 Codigdex를 채워 보세요.
읽고 넘어가는 공부 대신, 한 마리씩 잡아서 모으는 코딩 공부입니다.
- 의뢰 받기 — 안내 NPC가 지역에 나타난 버그 몬스터를 알려 줍니다.
- 문제 배틀 — 몬스터가 내는 코딩 문제를 풀어 공격합니다. 문제를 맞힐수록 몬스터가 약해져요.
- 도감 등록 — 60% 이상 맞히면 몬스터를 포획해 도감에 카드로 남깁니다. 실패해도 잃는 건 없고, 다시 도전하면 새로운 문제가 나옵니다.
- 다음 지역으로 — 한 단계를 잡으면 더 강한 몬스터가, 챕터를 끝내면 새 지역이 열립니다.
튜토리얼 · 반복문의 숲
→ CH.01 Git · 기록의 들판
→ CH.02 Linux · 셸 동굴
→ 1차 전직: 웹 프론트엔드 · 백엔드 · DevOps · 데이터 엔지니어 · 데이터 분석가
→ 2차 전직: 두 직업을 잇는 하이브리드 직업
→ 3차 전직: 마스터 직업
모든 개발자가 알아야 할 Git과 Linux를 먼저 익힌 뒤, 원하는 직업을 골라 그 직업만의 지도를 탐험합니다. 직업마다 길을 안내하는 선배 NPC가 있고, 풀스택 엔지니어나 ML Developer 같은 상위 직업은 ???로 가려진 채 여러분이 두 직업의 길을 모두 걸어오기를 기다립니다.
- 몬스터 도감 — 반복문 버그부터 깃새싹, 커널 수호자까지. 기술마다 Lv.1에서 Lv.5로 진화하는 몬스터가 있습니다. 아직 발견하지 못한 몬스터는
???로 남아 있어요. - 직업 도감 — 주니어 개발자부터 3차 마스터 직업까지 16종의 직업 심볼을 모읍니다. 처음 전직한 날과 마스터한 날이 기록됩니다.
- 튜토리얼, Git, Linux 챕터의 몬스터 11종 수집
- 5개 1차 직업 전직과 직업별 지도 탐험
- 몬스터 도감과 직업 도감
- 설정에서 한국어·영어 전환
직업별 전문 챕터(HTML/CSS, Docker, SQL 등)는 지도와 몬스터가 준비되어 있고, 배틀을 순서대로 여는 중입니다. 진행 상황은 브라우저에 자동 저장됩니다.
👉 codigdex.vercel.app에서 바로 플레이하기
Next.js, Phaser, TypeScript로 만들었습니다.
npm install
npm run dev --workspace @codigdex/web브라우저에서 http://localhost:3001을 엽니다. 테스트는 npm run test로 실행합니다.
이 저장소는 Claude와 Codex 두 에이전트가 함께 작업하고, 두 에이전트는 하나의 설정 트리를 공유합니다. 저장소 루트의 여덟 폴더가 에이전트 설정의 유일한 원본입니다.
| 폴더 | 내용 |
|---|---|
agents/ |
서브에이전트 정의 |
commands/ |
슬래시 커맨드 |
hooks/ |
훅 스크립트 |
output-styles/ |
출력 스타일 |
plugins/ |
플러그인 레지스트리 |
rules/ |
항상 적용되는 짧은 규칙 |
skills/ |
스킬 (폴더마다 SKILL.md) |
templates/ |
문서 템플릿 |
폴더 안의 모든 항목은 shared-(두 에이전트 공용), claude-(Claude 전용), codex-(Codex 전용) 중 하나로 시작합니다.
npm run setup:agents(postinstall에도 연결되어 있어 npm install만으로도 실행됩니다)는 .claude/, .codex/, .agents/ 아래에 각 도구가 기대하는 위치에서 위 루트 폴더로 향하는 디렉터리 링크(POSIX는 심볼릭 링크, Windows는 junction)를 만듭니다. 이 링크 경로는 모두 git에서 무시되므로, 루트 폴더가 여전히 유일한 원본입니다. 링크 경로를 통해 파일을 고치거나 커밋하지 말고 루트 폴더를 수정하세요.
.claude/settings.json은 저장소가 추적하는 유일한 Claude 전용 안전 설정입니다(권한 차단 목록, 보호 경로 훅과 상태줄 등록). CLAUDE.md는 @AGENTS.md를 가져오기만 하므로 규칙은 AGENTS.md에 적습니다.
설정을 바꾼 뒤에는 npm run check:agents로 링크·필수 파일·접두사·훅 동작을 검증하세요(CI도 같은 명령을 실행합니다). 작업을 넘길 때는 templates/shared-handoff.md 형식으로 인수인계 보고를 씁니다. 자세한 규칙은 AGENTS.md의 "Agent workspace layout"에 있습니다.
- 게임 기획서 — 게임 규칙, 화면, 비주얼 가이드
- 직업 전직 Path 설계 — 커리큘럼, 전직 조건, 저장 구조
- Git 작업 흐름 — 브랜치 전략, PR·이슈 자동화
- 모노레포 아키텍처 — web/mobile 앱과 공유 패키지 경계
- 계정 연동과 클라우드 세이브 — Google·GitHub·Apple 로그인, Web/Mobile 저장 귀속·병합
- 기여 가이드 · 프로젝트 및 PR 정책
개인이 만들고 검토하는 프로젝트라 외부 Pull Request는 받지 않지만, 버그나 틀린 설명을 발견하면 Issue로 알려 주세요. 자세한 내용은 기여 가이드를 참고하세요.
MIT © codingnanyong