궁금한 주제를 세계와 섬을 탐험하며 배우는 로컬 학습 프로젝트입니다. 그림과 짧은 이야기로 개념을 관찰하고, 한 번에 질문 하나를 풀어 갑니다. 배운 개념은 아이템이 되고 답변과 피드백은 개인 학습 일지에 남습니다.
- 이 저장소를 내려받아 로컬 폴더에 둡니다.
- Python 3.10 이상을 준비하고 그 폴더에서 python -m pip install -r requirements.txt를 실행합니다.
- 폴더를 읽고 수정할 수 있는 채팅 에이전트의 프로젝트로 연결합니다. 시작 지침은 AGENTS.md와 TUTOR.md입니다.
- 대화에 **“여정을 시작한다.”**라고 입력합니다.
처음이면 세계·여정·질문·개념 가방을 소개하는 공통 튜토리얼이 나옵니다. 이어서 배우고 싶은 목표를 묻고, 답을 받으면 나만의 세계와 여정을 준비합니다. 기존 여정이 있다면 선택 목록에서 골라 마지막 미응답 질문을 이어갑니다. 새 여정도 추가할 수 있습니다.
로컬 폴더 접근과 명령 실행 권한이 필요합니다. 일반 채팅의 파일 업로드만으로 폴더를 읽거나 자동 저장할 수 있는 것은 아닙니다. 로컬 MCP를 지원하는 앱은 연결 안내를 참고하세요. 웹 화면 자체가 질문을 분석하거나 이미지를 생성하는 것은 아니며 연결된 LLM과 이미지 도구가 수업을 준비합니다.
python game/tools/serve.py 실행 후 로컬 모험 도서관을 엽니다. Windows에서는 game/start.ps1도 사용할 수 있습니다.
- 개인 자료 없음: 첫 튜토리얼과 학습 목표 입력.
- 저장된 여정 있음: 제목·상태를 보고 선택.
- 여정 선택: 개인 진행 기록과 현재 질문에서 이어하기.
웹에서 입력한 목표나 답변은 복사해서 연결된 대화에 보냅니다. 지원되는 대화 내 화면에서는 요청을 바로 대화로 전달합니다. 학습 평가는 튜터가 수행하고 이동·복귀·초안 저장은 로컬 웹에서도 동작합니다.
Git에는 공통 코드·튜토리얼·문서·합성 테스트만 포함합니다. 여정과 세계 도감, 커리큘럼, 삽화, 아이템, 답변, 평가와 생성 화면은 gitignore로 제외합니다. 새로 내려받은 사용자는 다른 사람의 세계나 진도를 받지 않습니다.
기존 개인 파일은 삭제하거나 초기화하지 않습니다. 파일 위치와 백업 범위는 개인 자료 경계를 보세요. gitignore는 암호화가 아니며 폴더 자체를 공유하면 개인 자료가 포함될 수 있습니다. 세계관·여정 공유 기능은 TBD입니다.
여정은 이해하고 싶은 목표이고 세계는 큰 지식 분야입니다. 섬의 동그란 칸 하나에 이벤트 3개, 각 이벤트에 질문 3개를 둡니다. 미래 내용은 미리 모두 채우지 않고 진행하면서 준비합니다. 같은 사람의 다른 여정은 세계와 개념 가방을 함께 사용할 수 있습니다.
관련된 다른 지식이 궁금하면 적합한 과정을 찾아 경로를 제안합니다. 수락하면 같은 세계는 갈림길, 다른 세계는 포탈로 열립니다. 원래 질문과 초안을 보관하므로 언제든 돌아올 수 있습니다. 지도 이동이나 설명 요청만으로 문제를 통과시키지 않습니다.
- python game/tools/workspace.py start: 첫 시작 또는 여정 목록.
- python game/tools/workspace.py create --title "여정 제목" --goal "이해하고 싶은 목표": 개인 여정 생성.
- python game/tools/adventures.py list / load "제목 또는 ID": 목록과 이어하기.
- python game/tools/build.py --start: 튜토리얼/선택 화면 갱신.
- python game/tools/build.py --adventure : 선택한 여정 화면 갱신.
- python game/tools/build.py --session : 포탈 탐험 이어가기.
- python -m unittest discover -s tests: 개인 자료 없이 합성 데이터로 검사.
- python game/tools/public_check.py: Git의 개인 자료 제외 검사.
공통 구현은 game/, 작성 방식은 여정 작성 안내에 있습니다. 개인 생성 자료를 공통 코드·문서·테스트에 복사하지 마세요.