ADR-0035: 모델 네임스페이스 URI는 저장소 주소로 하고, 프로토타입의 v0 파일은 열지 않는다
이후 변경
- 2026-11-01: 열지 못한 까닭에 “프로토타입의 파일”(
prototype)을 따로 두었다. 사용자에게는 모델이 없는 파일과 같게 보이되, 문장으로 그 까닭을 알린다 → 1. 확장자와 판별
배경
저장되는 파일에서 모델 JSON은 <metadata> 안의 모델 요소에 든다(ADR-0005, 2. 문서 구조). 이 요소는 네임스페이스 URI로 다른 프로그램의 데이터와 갈린다. URI는 모든 파일에 영원히 남아 나중에 바꾸기 어렵다. 그래서 MVP 전에 정한다(MVP 개발).
프로토타입(버리는 코드)이 저장한 파일은 version: 0이고 짜임이 다르다(7. 프로토타입과 다른 곳). 제품이 이것을 열지도 함께 정한다.
견준 안과 파일의 모습은 시안 M30에 있다: https://claude.ai/artifact/PB8PsUo575CvUJMJbhuupE (저장소의 사본 journal/assets/2026-10-25-file-format-names-study.html).
결정 기준
- 다른 누구의 이름과 겹치지 않는다
- 해마다 갱신하지 않아도 이름이 우리 것으로 남는다
- 규칙(URI · URN의 표준)에 맞는다
검토한 대안
네임스페이스 URI
- 펴낸 사이트의 주소
https://reddiana.github.io/AriadneNSD/ns: 돈이 들지 않고, 그 주소에 형식을 알리는 페이지를 둘 수 있다. 계정 이름이 들어간다. (Claude의 추천) - 도메인을 사서
https://ariadnensd.com/ns: 가장 깔끔하다. 해마다 돈이 들고, 갱신하지 않으면 남이 그 주소를 가져간다. - 저장소 주소 그대로
https://github.com/reddiana/AriadneNSD: 지금 가진 주소다. 그 주소는 저장소의 첫 화면이지 형식을 알리는 곳은 아니다. - URN
urn:ariadne-nsd:model: 주소에 매이지 않는다. 등록하지 않은 URN 이름공간이라 규칙에 맞지 않는다.
프로토타입의 v0 파일
- 열지 않는다 (Claude의 추천)
- 열어서 v1로 바꾼다(v0 → v1 마이그레이션)
- 제품은 열지 않고, 바꾸는 스크립트만 둔다
결정
메인테이너가 M30에서 고르는 창으로 정했다(2026-10-25).
- 모델 네임스페이스 URI는
https://github.com/reddiana/AriadneNSD다(N1 · 3번). 접두어는ans다. 판 번호는 넣지 않는다. 판은 모델 요소의version속성이 나른다. - URI는 이름일 뿐이다. 나중에 저장소의 이름이나 자리가 바뀌어도 이 문자열은 그대로 두고, 옛 파일과 새 파일이 같은 이름을 쓴다.
- 프로토타입이 저장한
version: 0파일은 열지 않는다(N2 · 1번). 모델 요소가 없는 파일과 같이 “편집할 수 없음”으로 다루고(R-FMT-06), 원본은 건드리지 않는다. 그림은 어디서나 그대로 보인다.
결과
- 좋아지는 점: 이미 가진 주소라 돈과 갱신이 들지 않는다. v0을 읽는 코드와 시험을 제품에 지고 가지 않는다.
- 감수하는 점: URI에 계정 이름이 들어간다. 프로토타입으로 그린 것을 제품에서 이어 고치려면 다시 그려야 한다.
- 후속 작업: 파일 형식 명세의 예시와 미결정, 7장을 고침 → 01-file-format. 모델 요소의 이름(
ans:document)과 필드 이름은 모델 설계를 굳히며 정한다 → 01-model