DR-0002: 개발 순서

이후 변경

  • 2026-10-17: 아키텍처 결정 기록 ADR-0011에서 결정 기록 DR-0002로 옮겨 왔다. ADR은 아키텍처 결정만 두기로 했기 때문이다 → DR-0001. 본문은 그대로이고, 번호와 링크만 새 것으로 고쳤다. 본문의 “이 ADR”은 이 기록을 말한다. 이 ADR의 “검토한 대안”은 2026-10-07에 세 대상(웹 · Obsidian · 데스크톱)만 놓고 쓴 것이다. 그 뒤 배포 대상이 늘었지만 대안을 다시 쓰지 않고 2026-10-10에 그대로 승인했다. 늘어난 대상이 이 순서의 어디에 오는지는 아래와 같다.

  • 2026-10-09: Google Drive 연동이 더해졌다. 따로 만드는 대상이 아니라 웹 버전 위에 얹는 기능이다 → ADR-0012. 그래서 웹 다음에 만들 수 있지만, Obsidian · 데스크톱과 견주어 언제 만들지는 아직 정하지 않았다.

  • 2026-10-10: Confluence(유료, P2)와 Claude skill(#P3)이 요구사항에 들어갔다. 둘 다 “나중에”로 정한 것이라 이 순서에 들어 있지 않고, 세 대상 뒤에 온다 → 2. 배포 대상

  • 2026-10-14: IDE 플러그인(#P2)이 요구사항에 들어갔다. 이것도 “나중에”라 세 대상 뒤에 오고, 그 안에서는 VSCode가 IntelliJ보다 먼저다 → 2.7 IDE 플러그인 (나중에)

  • 2026-10-25: Google Drive 연동은 세 대상(웹 · Obsidian · 데스크톱)을 모두 만든 뒤에 만든다. 위 2026-10-09 줄의 “언제 만들지는 아직 정하지 않았다”가 이것으로 정해졌다 → 2026-10-25-04-outbox-cleanup

  • 2026-10-25: MVP 범위를 넓혔다. 웹의 P0에 Case · For · 감싸기 · 복사 · 갈래 편집을 더했고, 우선순위 태그는 “그 대상을 낼 때 꼭 있어야 하는 것”으로 읽는다. 대상의 순서(웹 → Obsidian → 데스크톱)는 이 기록 그대로다 → DR-0015

  • 2026-11-02: 웹은 MVP → 웹 베타 → 웹 1.0을 거치고, Obsidian은 웹 베타 동안 베타로 시작해 웹 1.0 뒤에 커뮤니티 플러그인 목록에 올린다. 대상의 순서는 이 기록 그대로다 → DR-0018

  • 2026-11-21: Claude skill을 P3에서 P2로 올리고 요구사항을 셋(알고리즘 그리기 · 코드 → 다이어그램 · 다이어그램 읽기 · 고치기)으로 늘렸다. 셸이 아니고 core를 그대로 묶어 쓰므로 세 대상의 순서와 따로, 웹 베타 동안 만든다. 세 대상의 순서는 이 기록 그대로다 → R-SKILL-01 ~ 03

배경

ADR-0002에 따라 세 대상을 모두 만든다. MVP를 어느 대상으로 먼저 낼지 정해야 한다. (5. MVP 범위)

결정 기준

  • 개발·테스트 주기가 빨라야 한다 (코어와 편집기를 다듬는 기간이 가장 길다).
  • 첫 결과물을 실제로 써 볼 수 있어야 한다.
  • 위험이 큰 부분을 일찍 확인해야 한다.

검토한 대안

웹 → Obsidian → 데스크톱

  • 장점: 브라우저 개발 도구와 즉시 새로고침으로 가장 빠르게 개발. 나머지 둘은 같은 편집기를 감싸는 셸 작업
  • 단점: 사용자가 주로 쓰는 Obsidian 연동 위험(.ns.svg 가로채기)을 늦게 확인

Obsidian → 웹 → 데스크톱

  • 장점: 사용자가 가장 많이 쓸 환경에서 바로 사용 가능
  • 단점: 플러그인 재로드가 필요해 개발 주기가 느림

결정

웹 → Obsidian → 데스크톱 순서로 개발한다 (2026-10-10 승인). MVP는 웹으로 낸다.

개발 주기가 가장 빠른 웹에서 코어와 편집기를 다듬고, 나머지 둘은 같은 편집기를 감싸는 셸로 만든다. 이 순서의 단점이던 Obsidian 연동 위험은 스파이크로 먼저 확인했다: .ns.svg만 편집기로 열 수 있다 (2026-10-10, [[04-obsidian-plugin#1-nssvg-파일-열기|1. .ns.svg 파일 열기]]).

결과

  • 좋아지는 점: 브라우저 개발 도구와 즉시 새로고침으로 빠르게 개발하고 테스트한다. 설치 없이 열 수 있어 첫 결과물을 누구나 바로 써 볼 수 있다.
  • 감수하는 점: 메인테이너가 주로 쓰는 Obsidian에서는 MVP 다음에야 쓸 수 있다.
  • 후속 작업: MVP 범위의 배포 대상을 웹으로 적음 → 5. MVP 범위. 데스크톱 프레임워크는 ADR-0009에서 따로 정한다.