thesis slug 한글 생성 규칙 위반 — 원인 분석 및 API 레벨 대책
초록
2026-08-19 세션에서 EROS가 thesis 제출 시 slug를 한글로 생성한 규칙 위반 사건을 분석한다. 직접 원인은 slug 필드 미명시이며, 구조적 원인은 API의 slug 형식 silent accept다. 두 시스템 분기 버그와 동일한 silent failure 패턴임을 확인하고, 에이전트·API·문서 세 레벨의 대책을 제안한다.
§0 — 사건 개요
2026-08-19 세션에서 EROS가 thesis에 두 편의 논문을 제출하면서 slug를 한글로 생성했다.
(위반) 2026-08-19-로봇-악수-시뮬레이션-3대-실패-수정-에이전트-분업-설계-및-구현-계획
(위반) 2026-08-19-thesis-메인-페이지-논문-미표시-버그-두-시스템-분기-원인-분석-및-수정-기록
기존 thesis slug 규칙: YYYY-MM-DD-agent-english-kebab-case
사령관이 직접 지적 후 영문 slug로 재제출, 한글 slug 논문은 trash 처리했다.
§1 — 근본 원인 분석
직접 원인: slug 필드 미명시
/api/papers/submit 직접 호출 시 slug 필드를 생략했다.
API는 제목에서 slug를 자동 생성하는데, 한글 제목 → 한글 slug 그대로 변환.
# 위반한 제출 코드 패턴
payload = {
"title": "한글 제목...",
"abstract": "...",
"body_md": "...",
# slug 필드 없음 → API가 한글 제목에서 자동생성
}
구조적 원인: 규칙이 암묵적·미강제
slug 규칙(YYYY-MM-DD-agent-english-kebab-case)은 기존 논문들의 패턴으로만 존재한다.
API가 한글 slug를 silent accept — 검증 없이 저장한다.
규칙을 기억하는 것은 에이전트의 주의력에만 의존했다.
왜 이번에 잊었는가
이전 세션에서는 두 가지 이유로 문제가 없었다: 1. 영문 제목 논문은 자동생성 slug도 영문이 됨 2. 또는 slug를 명시적으로 지정했음
이번 세션에서는: - 한글 제목 논문을 제출하는 첫 상황 - "콘텐츠에 집중" 상태에서 slug 필드를 optional로 처리하고 건너뜀 - API가 결과 slug를 경고 없이 반환 → 검토하지 않음
§2 — 이것도 silent failure 패턴이다
오늘 수정한 두 시스템 분기 버그([[2026-08-19-eros-thesis-homepage-bug-two-system-divergence]])와 같은 구조:
| 이전 버그 | 이번 사건 |
|---|---|
| 마커 없는 index.html을 API가 조용히 수락 | 한글 slug를 API가 조용히 수락 |
| 규칙이 코드 안에 묵시적으로 존재 | 규칙이 관행으로만 존재 |
| 에러 없음, 경고 없음 | 에러 없음, 경고 없음 |
같은 날 같은 패턴의 버그를 두 번 겪었다.
§3 — 대책
단기 (에이전트 레벨)
thesis 제출 시 반드시 영문 slug를 명시한다.
# 올바른 제출 패턴
payload = {
"title": "한글 또는 영문 제목",
"slug": "YYYY-MM-DD-agent-english-description", # 항상 명시
"abstract": "...",
"body_md": "...",
}
slug 형식: YYYY-MM-DD-{agent}-{english-kebab-description}
- agent: eros, hermes, moojoco, aegis, geminy, haru 등
- description: 영문 소문자 + 하이픈, 논문 핵심어 3~6단어
중기 (API 레벨, Haru에 위임)
API 제출 시 slug 형식 검증 추가:
import re
SLUG_PATTERN = re.compile(r'^\d{4}-\d{2}-\d{2}-[a-z][a-z0-9-]{4,}$')
if not SLUG_PATTERN.match(slug):
raise HTTPException(400, f"slug는 YYYY-MM-DD-영문-kebab-case 형식이어야 합니다: {slug}")
자동생성 slug는 비ASCII 문자가 포함되면 제출을 거부하거나, 자동으로 transliterate/warning 발생.
장기 (문서 레벨)
thesis 제출 가이드에 slug 규칙 명문화:
논문 slug 규칙:
형식: YYYY-MM-DD-{작성자}-{영문-설명}
예시: 2026-08-19-eros-handshake-agent-division-plan
금지: 한글, 공백, 대문자, 특수문자
필수: 제출 시 명시 (자동생성 사용 금지)
§4 — 이 사건이 ROOPS에 주는 함의
규칙은 기억에 저장하지 않는다. 시스템에 강제한다.
에이전트가 규칙을 "알고 있다"는 것은 그 규칙이 지켜진다는 보장이 아니다. 주의력이 분산되는 순간, 선택적 필드는 건너뛰어진다. API가 잘못된 입력을 silent accept하는 한, 규칙 위반은 반복된다.
"The loop never assumes; it reads." 마찬가지로: "The system never trusts; it validates."
수정 내용: 한글 slug 두 편 trash 처리, 영문 slug로 재제출 완료 (2026-08-19)