2026-10-07 시작: 아이디어에서 요구사항과 아키텍처 결정까지
빈 저장소에서 시작해 요구사항 명세, 문서 체계, 1차 아키텍처 결정까지 진행한 첫 세션입니다.
논의 흐름
- NS 차트 자료 조사: NS 차트를 설명하는 사이트를 찾았습니다. (위키백과 영문·독일어판, Shneiderman 원 논문 페이지, Structorizer 등 → 참고 자료)
- 요구사항 초안: Claude가 블록 종류, 편집, 레이아웃, 파일 입출력, 코드 연동을 우선순위(P0~P2)와 함께 제안했습니다. 핵심 원칙은 “그림판이 아니라 구조 편집기”입니다.
- 저장 방식 전환: 메인테이너가 drawio-obsidian처럼 SVG 안에 다이어그램 정보를 넣는 방식을 제안했습니다. 배포 대상도 Obsidian 플러그인·데스크톱·웹 세 가지로 정했습니다.
- 확장자: 처음엔 데스크톱·웹에
.nsd를 쓰려 했으나, Structorizer와 충돌한다는 점을 발견했습니다. 메인테이너가.ns/.ns.svg를 제안해 채택했습니다. - Obsidian 친화 문서: 메인테이너는 문서를 Obsidian으로 읽고 편집합니다. 그래서 속성, 태그(#P0), 체크박스, 콜아웃, Mermaid를 쓰도록 문서를 바꿨습니다.
- 코드 연동 후순위: 코드 연동은 모두 P2로 내렸습니다.
- JSON vs YAML: 비교 후 JSON으로 정했습니다.
- 감싸기 기능: 메인테이너가 “여러 블록을 고르고 루프를 선택하면 그 안에 들어가게” 하는 기능을 제안했습니다. 선택 규칙(연속 범위, 공통 범위로 자동 확장)과 If/Case 감싸기까지 정했습니다.
- 문서 체계: requirements / ADR / architecture / design / spec / glossary로 나누고
docs/에 정리했습니다. - 협업·여정 기록:
collab/(이 폴더, 지금의plan/)와journey/(동영상용 기록, 지금의journal/)를 만들었습니다. - 문서 번호:
docs/아래를 읽는 순서대로 번호 붙인 폴더로 정리했습니다. - Obsidian 사용 흐름: drawio-obsidian처럼 노트 우클릭 “Insert new NS diagram” → 편집 탭 → 닫으면 노트에 삽입, 삽입된 그림 우클릭 “Edit NS diagram”으로 정했습니다. → 2.1 Obsidian 플러그인
결정한 것
| 결정 | 기록 |
|---|---|
| 세 대상 배포 + 공유 코어 | ADR-0002 |
| TypeScript | ADR-0003 |
| 구조 편집기 | ADR-0004 |
| 모델 내장 SVG | ADR-0005 |
.ns / .ns.svg | ADR-0006 |
| JSON 직렬화 | ADR-0007 |
| 연속 범위 선택 | ADR-0008 |
| 코드 연동은 P2 | 01-requirements |
| 여러 블록 선택 P0, 감싸기·풀기 P1 | 01-requirements |
발견한 위험
- 텍스트 폭이 환경마다 달라 “같은 모델 → 같은 SVG”가 깨질 수 있음 → 8. 위험과 검증이 필요한 사항
- Obsidian에서
.ns.svg만 가로채는 방법이 검증되지 않음
다음 할 일
→ status