Codigdex

Codigdex란?

서버 구름 위 픽셀 마을 코드빌(Codeville) 에는 코드 속 개념이 버그 몬스터가 되어 돌아다닙니다. 막 첫 모험을 떠난 주니어 개발자가 되어 몬스터와 맞서고, 그 개념을 정말 이해했는지 증명해 나만의 도감 Codigdex를 채워 보세요.

읽고 넘어가는 공부 대신, 한 마리씩 잡아서 모으는 코딩 공부입니다.

이렇게 플레이해요

1. 의뢰 받기 — 안내 NPC가 지역에 나타난 버그 몬스터를 알려 줍니다.
2. 문제 배틀 — 몬스터가 내는 코딩 문제를 풀어 공격합니다. 문제를 맞힐수록 몬스터가 약해져요.
3. 도감 등록 — 60% 이상 맞히면 몬스터를 포획해 도감에 카드로 남깁니다. 실패해도 잃는 건 없고, 다시 도전하면 새로운 문제가 나옵니다.
4. 다음 지역으로 — 한 단계를 잡으면 더 강한 몬스터가, 챕터를 끝내면 새 지역이 열립니다.

모험의 흐름

튜토리얼 · 반복문의 숲
  → 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