Codigdex란?
서버 구름 위 픽셀 마을 코드빌(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"에 있습니다.
문서
기여
개인이 만들고 검토하는 프로젝트라 외부 Pull Request는 받지 않지만, 버그나 틀린 설명을 발견하면 Issue로 알려 주세요. 자세한 내용은 기여 가이드를 참고하세요.
라이선스
MIT © codingnanyong
