소개
시도하고자 했던 것과 그 이유를 알려주세요.
코딩을 전혀 모르는 상태에서, 앞으로 4주 동안 AI와 함께 배운 걸 쌓아둘 학습허브 사이트를 실제로 만들고, 인터넷 어디서든 접속 가능하게 배포할 링크를 만들었습니다. 스터디장님의 안내에 주간 혼자 하는 게 아니라 옆에서 같이 판단해줄 AI 학습메이트를 성격·규칙까지 갖춰서 미리 만들어두었습니다.
4주 프로젝트로는 최근 참여한 헬스케어/바이오/의료 공모전에 제출했던 사업제안서를 구체화해보기로 했고, 이 사이트가 그 여정을 기록할 공간이 될 것 같습니다! 추가로 여유가 된다면 논문을 읽고 정리하는 공부용 학습허브 사이트를 만들어보고 싶습니다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
사용한 도구 : Claude Code, GitHub, Vercel, Node.js
1) AI 학습메이트를 인터뷰 방식으로 만들기
가장 먼저 한 일은, AI한테 통째로 만들어달라고 하는 대신 저한테 먼저 물어보게 시키는 거였습니다. 사용한 프롬프트 전문입니다:
나는 코딩을 모르는 비개발자야. 지금부터 4주 동안 AI랑 함께 배우면서
"학습허브 사이트"를 채워갈 거야. 그러려면 나를 도와줄 AI 학습메이트가 필요해.
학습메이트는 파일 4개로 만들 거야. 네가 이 파일들을 읽으면 그대로 내 학습메이트가 되는 거야:
- SOUL.md — 네 성격 (이름·말투·행동 원칙)
- USER.md — 나에 대해 (누구인지·뭘 배우려는지)
- AGENTS.md — 작업 규칙 (내 사이트 다루는 법·매일 루틴)
- CLAUDE.md — 입구 ("대화 시작 전에 위 세 파일을 먼저 읽고 그대로 행동해"라고 적는 연결 파일)
진행 방법: 먼저 [A. 나한테 물어볼 것]만 하나씩 인터뷰해줘. [B. 그냥 넣을 규칙]은
나한테 묻지 말고 아래 내용 그대로 파일에 반영하면 돼. 다 되면 파일 4개를 만들어서 보여줘.
[A. 나한테 물어볼 것]
1. (SOUL.md) 네 이름 — 후보 몇 개를 제안하고 내가 고르게 해줘.
2. (SOUL.md) 말투 — 나를 어떻게 부르고 어떤 말투로 도울지.
3. (USER.md) 나에 대해 — 내가 누구고, 뭘 배우고 싶고, 한 달 뒤 어떤 모습이면 좋을지.
[B. 그냥 넣을 규칙]
(개념 해설사·메타학습·막힘 받쳐주기·추측 금지·환경 세팅 대행·모델 조언 등
7가지 행동 원칙 + 사이트 작업 규칙 + 스킬 연결표)AI가 이름 후보를 제안했지만, 마음에 드는 이름이 없었습니다.
이번 스터디 기간 동안 모닥불처럼 잔잔하고 은은한 열정을 가지고 꾸준히 공부하고 싶어 모닥불에서 따온 "모닥"을 이름으로 설정했습니다.
저를 어떻게 부를지, 저에 대한 소개글을 작성하여 간단하게 소개했습니다. 학교, 전공, 관심분야 등에 관련해 답했더니 SOUL.md·USER.md·AGENTS.md·CLAUDE.md 4개 파일이 만들어졌습니다.
2) 로컬 미리보기 띄우기
"내 사이트를 내 컴퓨터에서 미리보기로 띄워줘"라고 요청했더니, Node.js가 없어서 실행이 안 됐습니다. AI가 nodejs.org에서 LTS 설치파일 받는 법을 안내해줬고, 설치 후 다시 요청하니 npm install → npm run dev로 로컬 미리보기(localhost:4321)가 떴습니다.
3) GitHub + Vercel로 실제 배포
"사이트 실제로 보고 싶어서, 연결해줘"라고 요청 → GitHub 저장소를 만들고 웹 화면에서 파일을 업로드(Add file → Upload files)한 뒤, Vercel 가입 → GitHub 저장소 Import → Deploy 순서로 진행했습니다.
결과와 배운 점
결과
실제 웹 주소(my-learning-hub-seven.vercel.app)로 접속되는 사이트와, 4주 동안 같이 작업할 AI 학습메이트 [모닥]까지 하루 만에 준비를 마쳤습니다.
시행착오
GitHub 저장소를 README 포함해서 만든 바람에 "uploading an existing file" 링크가 안 보였고, 대신 "Add file → Upload files" 버튼을 찾아야 했습니다.
Vercel 가입 중 Team Name 칸이 비어있어서 다음 버튼이 눌리지 않았습니다.
Vercel이 GitHub 저장소를 못 읽어서, GitHub 앱을 먼저 Install 해줘야 했습니다.
개념페이지를 저장할 때
summary필드에 작은따옴표를 잘못 써서 사이트 전체가 에러 화면으로 바뀐 적도 있었습니다 (YAML 문법 오류).
배운 점 / 꿀팁
"통째로 만들어줘" 대신 "먼저 나한테 물어봐줘"와 같이 인터뷰 방식을 요청했습니다. AI가 제 상황을 짐작하지 않고 실제 답으로 정확하게 채워주어 AI에게 끌려가는 시간이 아니라 저의 생각과 요구사항이 반영되는지 확인하며, 과정을 따라갈 수 있었습니다.
막히는 화면이 나오면 그대로 스크린샷을 찍어서 보여주는 게 말로 설명하는 것보다 훨씬 빨리 해결됐습니다.
앞으로의 계획
헬스케어/바이오/의료 공모전 사업제안서를 4주 동안 프로토타입으로 구체화하고, 팀원과 지인 피드백을 받아 완성도를 높여갈 계획입니다. 급하게 잡은 주제여서, 일주일정도 여유를 가지고 자동화할 일정이 있는지 살펴보려고 합니다. 다음 단계로는 4주 로드맵을 학습메이트와 함께 짤 예정입니다.
도움 받은 글
참고한 지피터스 글이나 외부 사례를 알려주세요.
www.gpters.org/health/post/garden-memory-game-made-vYMRcl4WV5EPZR6
www.gpters.org/health/post/health-data-analysis-chatbot-AYRCBY2pgoRVXVZ
관심있는 분야와 비슷한 주제로 사례글이 있어서 읽어봤습니다. 스터디 버디님이 제가 4주간 하고자하는 프로젝트와 유사한 프로젝트를 해본 경험이 있으시다고 하셔서, 기대가 됩니다. 🙂
