콘텐츠 파일(frontmatter) 스트레스 테스트
2026.08.12
온보딩 수업 중에 하다가 막히면 처음부터 다시 보는 중입니다. 지난 주 목요일 온라인 줌강의 때 사례 발표하시는 걸 보고 언제 그렇게 되려나 싶네요. ㅎㅎㅎ n8n 얘기는 좀 어려웠고요. 사이트 전체 다 만들어서 보여주신 분에게 투표했습니다.
개인적으로는 버셀 배포를 계속 해보고 있습니다. 그러다가 값이 안 나오는 경우에는 어떻게 반응하나 테스트 해봤습니다. ^^;;;
1. Before — 무엇을 안 해봤나
사이트(Astro + 마크다운 기반)를 매일 운영하면서도, "위키 글 맨 위 정보 칸(frontmatter)에 이상한 값을 넣으면 사이트가 어떻게 반응하는가"는 한 번도 검증한 적이 없었다는 문제의식에서 출발.
2. 시도 — 어떻게 테스트했나
가짜 위키 글 하나를 만들어 npm run build(전체 검사 명령)로 아래 세 가지 케이스를 하나씩 넣고 확인 후 바로 삭제. 커밋 전 로컬 테스트였기 때문에 실제 사이트에는 영향 없음.
테스트 케이스 | 내용 | 결과 | 에러 메시지 친절도 |
|---|---|---|---|
① 빈 값 | 제목·날짜를 비워둠 | 빌드 전체 중단 | 중간 — 문제 필드는 알려줌 |
② 중간 취소 | frontmatter 닫는 구분선( | 빌드 전체 중단 | 최하 — 어떤 필드인지 안 알려주고 내부 용어만 표시 |
③ 엉뚱한 값 | 날짜·분류·주차·공개여부에 말이 안 되는 값 입력 | 빌드 전체 중단 | 최상 — 틀린 필드 4개를 각각 지목, 기대값과 실제값까지 명시 |
3. 막힘 → 해결
화면 캡처 도구가 이번에도 실패해, 에러 텍스트를 코드로 먼저 추출한 뒤 브라우저(localhost:4321)에서 직접 눈으로 확인하는 방식으로 우회. 파일을 다시 넣자 화면이 자동 새로고침되며 실시간 반영을 확인.
4. After — 배운 점
세 케이스 모두 "일부 페이지만 깨지는" 게 아니라 빌드 자체가 통째로 멈추는 안전장치로 작동했다 (참고: Vercel도 빌드 실패 시 배포 자체를 하지 않음).
하지만 가장 자주 발생할 법한 실수(파일 작성 중 중단)가 가장 원인 파악이 어려운 에러를 낸다는 비대칭성을 확인한 것이 이번 학습의 핵심.
"무너지지 않는다"보다 "무너질 때의 패턴을 안다"가 실무적으로 더 값진 자산.
5. 재사용 자산 — 스트레스 테스트 프롬프트
내가 만든 걸 일부러 이상하게 써보면서 문제를 찾아줘.
빈 값으로 넘기기, 중간에 취소하기, 엉뚱한 걸 넣기 —
그럴 때 어떻게 되는지 확인해줘.6. ASK 프로젝트 적용 아이디어 (추가 제안)
원문은 Astro 위키 글 기준이지만, 구조는 스톤오션님의 ASK 개발 환경(Windows + Claude Code + GitHub CLI + Vercel CLI, AGENTS.md·CASE.md 문서 체계)에도 그대로 적용 가능해 보입니다.
CASE.md·판례/사례 데이터에 동일 테스트 적용
권리분석 사례 데이터(등기부·감정평가서 파싱 결과 등)의 필드가 비어 있거나(예: 낙찰가 미기재), 형식이 어긋나거나(날짜가 텍스트로), 값 자체가 말이 안 될 때(권리순위가 음수) ASK 파이프라인이 "조용히 잘못된 결과"를 내는지, "명확히 멈추고 알려주는지" 미리 확인해두는 걸 권합니다. 특히 전세사기 예방처럼 오탐이 치명적인 서비스라면, 이 검증이 우선순위가 높습니다.
AGENTS.md 중복 규칙 정비 작업과 연결
최근 정비 중이신 AGENTS.md·CASE.md 중복 규칙 문제에도, "규칙 필드가 비었을 때/형식이 어긋났을 때 Claude Code가 어떻게 반응하는가"를 한 번 강제로 테스트해보면 숨은 우선순위 충돌을 미리 발견할 수 있습니다.
Vercel 배포 안전망 재확인
Vercel 환경변수 미등록 이슈를 발견하셨던 만큼, 잘못된 데이터가 build 단계에서 걸러지는지(이번 사례처럼) 아니면 런타임에서야 터지는지 구분해두면, 배포 전 체크리스트에 반영할 수 있습니다.



"무너지지 않는다"보다 "무너질 때의 패턴을 안다"가 더 값진 자산이라는 결론, 딱 맞는 말이에요. 세 케이스 중에서 특히 중간 취소(--- 누락)가 에러 메시지 친절도 최하라는 발견이 실용적이에요. 가장 자주 발생할 실수가 가장 파악하기 어려운 에러를 낸다는 비대칭성, 직접 찾아내지 않으면 모르고 지나쳤을 거예요.
로컬 테스트라 사이트에 영향 없이 케이스마다 하나씩 넣고 확인 후 삭제하는 방식도 깔끔했고, ASK 프로젝트까지 연결해서 "전세사기 예방처럼 오탐이 치명적인 서비스라면 이 검증이 우선순위가 높다"고 짚은 부분은 글을 쓰면서 본인 작업에도 실질적으로 도움이 됐겠네요. 고롱고롱 ✨