자녀 학습앱 2주차
2026.10.14
하려던 것 📝
지난주에는 Claude로 간단한 HTML 영어 단어 테스트를 만들고, 아이 혼자 공부할 수 있는 앱으로 확장할 기능을 구상했습니다.
이번 주에는 계획에서 한 걸음 더 나아가, 실제로 작동하는 작은 앱과 검증 장치를 만들었습니다. 목표는 “AI에게 개발 규칙을 알려주고, 중요한 규칙은 테스트로 확인하며, 확인에 실패하면 결과물 생성을 멈추기”였습니다.
여행 중이라 직접 개발 환경을 실행하기 어려웠습니다. 그래서 ChatGPT에 실제 구현과 테스트 실행을 요청하고, 실행 결과를 바탕으로 이번 과제를 정리했습니다.
활용한 툴 ⚒️
ChatGPT: 프로젝트 파일 생성, 학습 로직 구현, 테스트 실행과 결과 정리
Node.js 내장 테스트 도구: 학습 기능 자동 검증
HTML·JavaScript: 단일 파일 학습 앱 구현
지난주 원본 HTML을 이번 작업에 전달하지 못했기 때문에, 동일한 학습 목적을 가진 새 실험용 프로젝트로 만들었습니다. 이번 구현과 검증은 ChatGPT의 실행 환경에서 진행했습니다.
진행 세부 내용 🔍
1️⃣ 작지만 작동하는 학습 앱 구현
예시 단어 6개로 다음 기능을 구현했습니다.
영어 단어를 보고 뜻 선택하기
정답과 오답을 즉시 안내하기
마지막에 정답 수 확인하기
틀린 단어만 다시 풀기
처음부터 다시 시작하기
음성 인식과 문장 암송까지 한꺼번에 넣기보다, 기본 학습 흐름부터 검증하기로 했습니다. 오답에는 정답을 알려주고 다시 익히도록 격려하는 문구를 넣었습니다.
2️⃣ AI가 읽을 개발 규칙 작성
프로젝트에 CLAUDE.md를 만들었습니다. 초등학생이 혼자 사용하는 앱이라는 목적과 함께 다음 규칙을 적었습니다.
요청과 관련된 부분만 수정할 것
단어 원본을 임의로 바꾸지 말 것
학습 로직을 바꾸면 관련 테스트도 확인할 것
실제로 확인한 결과와 확인하지 못한 부분을 구분해 보고할 것
이 문서는 앞으로 Claude로 개발을 이어갈 때 사용할 규칙 초안입니다. Claude가 실제로 이 문서를 읽고 준수하는지는 아직 확인하지 않았습니다.
3️⃣ 말로 적은 규칙을 자동 테스트로 연결
“잘 작동하게 만들어줘”라는 요청을 구체적인 확인 항목으로 바꿨습니다.
예를 들어 다음 상황을 테스트에 포함했습니다.
정답 버튼을 두 번 눌러도 점수는 한 번만 올라가는가?
답하기 전에는 다음 문제로 넘어가지 않는가?
오답 복습에는 틀린 단어만 포함되는가?
틀린 단어가 하나뿐이어도 복습이 가능한가?
모두 맞히면 복습할 문제가 없는 것으로 처리되는가?
다시 시작하면 점수와 오답이 초기화되는가?
학습 중 원본 단어 데이터가 바뀌지 않는가?
실행 결과, 학습 로직 테스트 12개가 모두 통과했습니다. 단어 데이터 검사와 JavaScript 구문 검사도 통과했습니다.
4️⃣ 검증에 실패하면 앱 생성을 중단
빌드 명령에 데이터 검사, 구문 검사, 자동 테스트를 연결했습니다. 모두 통과해야 실행용 HTML 파일을 생성하도록 했습니다.
검사가 실패할 때 이전 HTML이 최신 결과처럼 남지 않도록, 빌드 시작 시 기존 출력 파일을 제거하게 했습니다.
개발 규칙을 문서로 작성하는 데서 그치지 않고, 결과물을 만드는 과정에 실제 확인 절차를 넣었습니다.
5️⃣ 일부러 오류를 넣어 차단 여부 확인
정상 코드가 통과하는 것만으로는 검증 장치가 제대로 작동하는지 확인하기 부족하다고 생각했습니다. 그래서 ChatGPT에 임시 복사본에서 오류를 넣어 확인하도록 요청했습니다.
실험
실제 결과
단어 ID를 일부러 중복시킴
데이터 검사 실패, HTML 생성 차단
중복 클릭 방어 코드를 제거함
관련 테스트 실패, HTML 생성 차단
오류 주입은 격리된 복사본에서 진행했고, 최종 결과물에는 정상 코드를 유지했습니다.
시행착오와 한계 ⚠️
자동 검증과 화면 확인은 별개의 작업이라는 점이 드러났습니다.
학습 로직은 테스트했지만, 브라우저 자동 확인은 실행 환경에 필요한 브라우저 파일이 없어 완료하지 못했습니다. 실제 휴대폰에서의 사용성과 아이의 반응도 아직 확인하지 못했습니다.
또한 CLAUDE.md는 AI가 참고할 규칙이지, 그 자체로 실행을 강제하는 장치는 아닙니다. 이번 빌드 명령은 검증 실패 시 생성을 막지만, 그 명령을 우회하는 작업까지 막지는 못합니다.
배운 점 📚
이번에는 하네스를 설명으로만 이해하지 않고, 작은 프로젝트에 적용해봤습니다.
CLAUDE.md에는 AI가 읽고 판단할 규칙을 담고, 테스트에는 프로그램이 직접 확인할 동작을 담았습니다. 그리고 빌드 과정에 검증을 연결해 실패하면 결과물이 나오지 않도록 했습니다.
특히 일부러 오류를 넣었을 때 차단되는 것을 확인하면서, 테스트가 단순한 통과 표시를 넘어 수정 과정의 실수를 잡는 장치가 될 수 있다는 점을 배웠습니다.
개발 경험이 많지 않은 저에게는 “AI가 만들어줬으니 잘 되겠지”에서 “어떤 기준으로 제대로 작동하는지 확인할까?”로 생각을 옮겨본 시간이었습니다.
향후 계획 🧭
여행 후에는 실제 휴대폰에서 앱을 열어보고, 아이가 사용하면서 불편해하는 부분을 살펴볼 계획입니다.
이후 Claude에서 같은 프로젝트를 이어서 수정하며 개발 규칙이 잘 반영되는지도 확인하고 싶습니다. 기본 흐름이 안정되면 철자 쓰기와 학습 기록을 하나씩 추가하겠습니다.
도움이 필요한 점 🤝
작은 HTML 학습 앱에서 화면과 버튼 동작까지 자동으로 확인하려면 어떤 방식으로 시작하면 좋을지 궁금합니다.
또한 기능이 늘어날 때 CLAUDE.md와 테스트를 함께 관리하는 방법에 대한 조언을 받고 싶습니다.



