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

  1. 펴낸 사이트의 주소 https://reddiana.github.io/AriadneNSD/ns: 돈이 들지 않고, 그 주소에 형식을 알리는 페이지를 둘 수 있다. 계정 이름이 들어간다. (Claude의 추천)
  2. 도메인을 사서 https://ariadnensd.com/ns: 가장 깔끔하다. 해마다 돈이 들고, 갱신하지 않으면 남이 그 주소를 가져간다.
  3. 저장소 주소 그대로 https://github.com/reddiana/AriadneNSD: 지금 가진 주소다. 그 주소는 저장소의 첫 화면이지 형식을 알리는 곳은 아니다.
  4. URN urn:ariadne-nsd:model: 주소에 매이지 않는다. 등록하지 않은 URN 이름공간이라 규칙에 맞지 않는다.

프로토타입의 v0 파일

  1. 열지 않는다 (Claude의 추천)
  2. 열어서 v1로 바꾼다(v0 → v1 마이그레이션)
  3. 제품은 열지 않고, 바꾸는 스크립트만 둔다

결정

메인테이너가 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