AI 수학 코치 만들기 - '매스콕' 개발 기록
2026.08.04

소개
초등학생을 위한 AI 수학 코칭 서비스 매스콕을 만들고 있습니다. 매일 5분, 문제 하나를 AI와 함께 푸는 서비스입니다.
핵심 원칙이 하나 있는데, AI가 절대 정답을 알려주지 않습니다. 힌트도 네 단계로 나눠서 최소한만 줍니다. 수학 성적이 목표가 아니기 때문입니다. 진짜 목표는 AI 시대에 필요한 능력 — 추상화, 구조화, 질문하는 힘, 메타인지 — 이고, 수학은 그걸 훈련하기 좋은 재료일 뿐입니다.
SQPSR이라는 인지 훈련 프레임워크를 활용하는 프로그램인데, LLM이 나오면서 예전엔 사람이 1:1로 붙어야 가능했던 관찰과 코칭을, 이제는 매일 아이 한 명 한 명에게 붙여줄 수 있다고 생각했습니다.
진행 방법
사용 도구
Claude (웹) — 서비스 설계, 문서 작성, 의사결정 상대
Claude Code — 실제 구현 전부
Claude API (Sonnet) — 서비스 안에서 아이와 대화하는 엔진
Netlify — 배포, 서버리스 함수, 데이터 저장
저는 개발자가 아닙니다. 코드를 직접 쓰지 않고 Claude Code에게 지시문을 던지는 방식으로 만들었습니다.
구조
훈련 프레임워크는 SQPSR 다섯 단계입니다.
단계 | 이름 | 하는 일 |
|---|---|---|
Survey | 발견하기 | 문제를 끝까지 읽고 무엇을 묻는지 찾기 |
Question | 분석하기 | 조건을 따지고 함정을 의심하기 |
Plan | 설계하기 | 표·그림으로 구조를 옮기기 |
Solve | 실행하기 | 어림한 방향과 계산 결과 대조하기 |
Review | 성찰하기 | 오늘 배운 것을 한 줄로 |
<매스콕 랜딩페이지 https://mathcog-pilot.netlify.app/>

<매스콕 대화 화면>
결과와 배운 점
배운 점과 나만의 꿀팁을 알려주세요.
바이브코딩 초보라 기획과 프롬프트 작성은 클로드(웹)과 의논했고, 클로드가 작성해준 지시문을 클로드코드에 입력하는 방식을 취했습니다.(오류를 배제하기 위해)
개발 프로세스와 폴더 구조 - 깃허브 - 배포 등 전체 생태계의 구조를 이해하는 계기가 되었습니다.
과정 중에 어떤 시행착오를 겪었나요?
클로드코드 세션 관리 실수 : Claude Code를 홈 디렉터리에서 실행하는 바람에, 여러 프로젝트의 세션이 한 바구니에 쌓여 있었습니다. 클로드의 도움으로 해결했습니다.
도움이 필요한 부분이 있나요?
1. 아이가 그림으로 구조화하는 훈련을 어떻게 받을까요?
문제를 표나 그림으로 옮기는 게 추상화 훈련의 핵심인데, 여기서 막혔습니다. 태블릿은 펜으로 그리면 되지만 PC에서 마우스로 그리는 건 아이에겐 사실상 불가능합니다. 종이에 그려서 웹캠으로 보여주는 방식도 노트북 카메라가 정면 고정이라 자세가 어색하고요.
일단 표·수직선처럼 클릭만으로 되는 도구로 대체하려 하는데, 더 나은 접근이 있을지 궁금합니다.
2. 아이의 짧은 답변에서 관찰 데이터를 뽑는 법
리포트의 근거가 아이의 서술 응답인데, 초등 저학년은 타이핑이 느려 한 단어로만 답합니다. 음성 입력을 붙일까 고민 중입니다.
앞으로의 계획이 있다면 들려주세요.
아직은 미완성입니다. AI 대화와 UI를 좀더 다듬은 후 파일럿을 10~20명 규모로 돌려볼 예정입니다. 확인하려는 건 두 가지입니다.
아이가 매일 접속하는가 — 콘텐츠 품질보다 이게 먼저 성립해야 관찰 데이터가 쌓입니다
부모가 "성적표 없는 리포트"에 반응하는가 — 이게 관건입니다.
그다음 — 헤르메스 에이전트 접목
지금은 하나의 시스템 프롬프트로 모든 아이를 대합니다. 학년에 따라 조립이 달라지긴 하지만, 결국 정해진 틀입니다.
다음 단계로 헤르메스 에이전트를 붙이려고 합니다. 구조는 이렇습니다.
두뇌는 Claude — 추론, 문제 설계, 관찰 판단
대화는 헤르메스 — 아이와의 실제 상호작용과 관계 형성
헤르메스에 아이마다 별도 프로필을 만들어 파견
비유하자면 인력 파견업입니다. 본사(Claude)가 판단력을 대고, 현장에 나가는 코치(헤르메스 프로필)는 아이마다 따로 있습니다. 파견된 코치는 그 아이와 쌓은 시간만큼 스스로 진화합니다.
지금 구조에서는 "어제 뭘 했는지"를 매번 요약해서 컨텍스트로 밀어넣어야 합니다. 프로필이 아이별로 살아 있으면, 그 아이만의 말투와 관심사와 막히는 지점이 코치 안에 축적됩니다. 1년 뒤엔 그 아이만을 위한 코치가 되어 있는 것이 목표입니다.
이게 되면 매스콕은 "AI가 수학을 가르치는 서비스"가 아니라 "아이마다 한 명씩 배정되는 코치"가 됩니다.
로그인하고 댓글을 남겨 주세요
오오오오오!!!
이 아이디어 너무 좋은데요?
저도 한참 아이 학원 알아보고 있는데 너무 좋은 것 같습니다-!
오늘 스터디때 발표해주실 수 있으면 좋을 것 같아요-! ㅎㅎ

![[부업스터디] 라고 하지만 여러개의 본업같은 서비스 개발/운영기 공유 #1 - 멍패스 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F122f1ba50b90cbc13508f251.jpg&w=3840&q=75)

개발자가 아닌데 SQPSR 인지 훈련 프레임워크를 구현하고 Netlify 배포까지 마치셨다는 게 인상적이에요. "AI가 절대 정답을 알려주지 않는다"는 핵심 설계 원칙 — 수학 성적이 아니라 추상화·구조화·메타인지를 키우겠다는 목표가 서비스 방향을 처음부터 선명하게 잡아줬을 것 같아요.
홈 디렉터리에서 Claude Code를 실행해 세션이 한 바구니에 쌓인 실수도 솔직하게 적어주셨네요. 비슷하게 겪어보신 분들한테 유용한 팁이에요.
헤르메스 에이전트를 아이마다 파견하는 구조, "1년 뒤엔 그 아이만을 위한 코치"라는 목표가 실제로 구현되면 매스콕이 정말 달라질 것 같아요. 파일럿 결과 기대할게요 🐈⬛