problems

Imported from yurimn/nemodemic-problem (problems/AGENTS.md). Install upstream with npx skills add yurimn/nemodemic-problem --skill problems. Copyright stays with the author.

Problem Sources

Purpose

레벨별 퍼즐의 메타데이터와 공백 구분 격자 원본을 관리합니다.

Key Directories

Format

• 파일명은 problem_XX.txt, 폴더명은 LevelN 형식을 유지한다.
• 메타데이터는 title, description, optimal, maxsafe이고 ---MAP--- 아래에 격자를 둔다.
• 기본 토큰은 . 빈칸, # 벽, S 시작, E 출구, U/D/L/R/A 방향 바이러스, V 백신이다.
• @, $는 시작·출구 별칭으로 validator가 허용한다. 확산 객체는 A:3처럼 :<delay>를 붙일 수 있다.

For AI Agents

• 각 문제에는 시작점과 출구가 정확히 하나씩 있어야 하고 모든 행의 셀 수가 같아야 한다.
• 기존 토큰의 의미나 좌표 방향을 추측해 바꾸지 않는다. Unity 파서는 파일의 좌상단 기준 행을 Unity의 좌하단 기준 좌표로 변환한다.
• 문제 추가 시 레벨 내부 번호를 연속적으로 유지한다. 빌더가 정렬 순서대로 전역 ID를 다시 부여한다는 점을 고려한다.
• optimal과 maxsafe는 실제 플레이 가능한 경로와 바이러스 확산을 기준으로 검토한다.

Testing / Verification

• 저장소 루트에서 빌더와 validator를 실행한다.
• 시작→출구 경로, 바이러스 방향·지연, 백신 배치, 최적 이동 수를 게임에서 플레이 검증한다.
• 문제를 삭제하거나 순서를 바꾸면 기존 전역 ID와 클라이언트 진행 데이터에 미치는 영향을 확인한다.