JaneDuck - 마이크로 영작문 코칭 에이전트

• 최종 배포 URL: https://janeduck.vercel.app

• 깃허브 링크: https://github.com/hyrocket/janeduck

프로젝트 설명:

JaneDuck은 영어 단어를 이용해 짧은 문장을 직접 써보게 하는 AI 작문 코치입니다. 전체적인 형태는 Quizlet, Anki 같은 FlashCard 앱에 AI 작문 코칭이 붙은 형태입니다. JaneDuck(오리 캐릭터)이 단어를 소개하고, 학생이 그 단어로 문장을 쓰면, AI가 점수와 피드백을 주고, 잘하면 한 단계 더 어려운 모드로 도전하게 합니다.

중학생 딸을 위해 시작한 프로젝트입니다. 단어의 뜻은 알아도, 그 단어를 제대로 쓰려면 그 단어로 직접 말하고 써보는 연습이 필요하다고 느꼈습니다.

영어 학습자를 위한 영어 작문 훈련 도구이기 때문에, 학습 단어·예문·AI 피드백은 모두 영어를 기반으로 했습니다.

핵심 기능 설명:

1. 3단계 작문,코칭모드 (Guided / Practice / Challenge Mode) — 해당 단어에 대한 숙련도(Mastery Level)에 따라 작문 난이도가 달라집니다.

   • Guided Mode :  단어가 포함된 문장 틀의 빈칸을 채우기. 

   • Practice Mode: 해당  단어와 주어진  배경을 활용하여 1문장을 작문하기

   • Challenge Mode : 해당 단어를 사용하여 이어지는 2문장을 작문하기 

2.  AI 작문 평가 & 코칭 — 학생이 쓴 문장을 AI가 평가해, 점수와 함께 "무엇이 좋았고 어떻게 고치면 되는지"를 짚어줍니다. 

3. 숙련도 기반 학습 추적 (Mastery) — 작문 점수에 따라 단어별 숙련도가 오르내리고, 그에 맞춰 다음 세션에 공부할 단어 카드와 복습 우선순위가 정해집니다.

관련 스크린샷:

[단어 학습 ( Flash card) ]

[작문모드]

[작문모드-코칭피드백 ]

개발 기술/스택:

• Agent Framework : LangGraph (Python)

• LLM : OpenAI GPT-4o-mini ( 문제출제· 단어 소개), GPT-4.1-mini (작문 평가)

• 백엔드 : FastAPI (Python)

• 프론트엔드 : Next.js 14 (TypeScript, Tailwind)

• DB : Neon PostgreSQL

• 배포 : Vercel

엔지니어 클럽을 진행하며 느낀 점 과 팁 :

바쁘다는 핑계로 충분한 시간을 쏟지 못한 점이 가장 아쉽습니다. 좀 더 집중했다면 더 많이 배웠을 텐데 하는 마음이 남습니다.

처음에는 카드 학습 모드 + 작문 모드까지 모든 학습 흐름을 LangGraph로 만들려 했습니다. 하지만 단어 카드 학습부분에는 굳이 필요하지 않아 작문 부분에만 LangGraph를 썼습니다. 

그리고 과제 필수 조건이 Streamlit 기반이었는데, 이 조건을 뒤늦게 인지했습니다. 원래 진행했던 Next.js와 FastAPI로 그대로 완성하는 쪽을 택했습니다.

솔직히 말씀드리면 바이브 코딩으로 많이 진행해서 완성했습니다. 그래서 코드를 손으로 익히는 경험은 부족했고, 대신 LangGraph로 학습 흐름을 어떻게 설계할지를 먼저신경 썼습니다. 코딩 역량은 앞으로 더 채워야 할 숙제로 남았습니다.

저는 특별한 팁은 드릴 것이 없지만 강의를 미리 듣는 것이 정말 중요한 것 같습니다.  강의를 미리 들어두셔야 과제에 들어갔을 때 막히지 않고 따라갈 수 있습니다. 그리고 과제 조건, 스케줄도 미리 확인해두시면 좋습니다.

6주 동안 페이스메이커가 되어주신 2기 여러분들, 그리고 Nico 선생님, Bora님께 감사드립니다.

P.S. 작성 당시 배포 환경에서 작문 모드 연결 이슈가 있었으나, 수정 완료했습니다. 지금은 정상 작동합니다.