NS 차트(Nassi-Shneiderman Diagram) 편집기입니다. 블록을 고르고 감싸는 구조 편집으로 차트를 그리면, 레이아웃은 자동으로 맞춰집니다. 저장 파일(.ns.svg)은 그냥 SVG라서 README나 블로그에 넣으면 그림으로 보이고, 같은 파일을 편집기에서 다시 열면 고칠 수 있습니다. 그림과 편집용 파일을 따로 챙기지 않아도 됩니다.
AriadneNSD로 그린 NS 차트: 다익스트라 최단 경로(왼쪽)와 병합 정렬(오른쪽)
TIP
웹 베타를 브라우저에서 바로 써 볼 수 있습니다:
웹 베타입니다. 설치 없이 열리고, 서버 없이 내 컴퓨터의 파일에 저장합니다(Chrome · Edge. Firefox · Safari는 내려받기). 사용법은 ariadnensd.com/manual/ko/, 키는 도움말 › 단축키 목록(?)에 있습니다.
이름난 알고리즘을 NS 차트로 그려 모은 알고리즘 갤러리도 있습니다.
Claude를 쓴다면 AriadneNSD 스킬을 설치해 대화 중에 다이어그램을 만들고, 코드를 그리고, 받은 다이어그램을 고칠 수 있습니다.
아직 1.0 전이라, 지금 저장한 파일은 뒤의 버전에서 열리지 않을 수 있습니다.
Claude 스킬
Claude에게 “이 함수를 NS 차트로 그려 줘”라고 하면 .ns.svg 파일과 공유 링크를 만들어 줍니다. 코드를 다이어그램으로 옮기고, 받은 다이어그램을 읽고 고칠 수도 있습니다. 한 번 설치하면 따로 부르지 않아도 Claude가 알아서 씁니다.
Claude Code: 터미널에서 두 명령을 차례로 실행합니다(마켓플레이스 등록 → 설치). 대화창에서 /plugin marketplace add …로도 되고, 데스크톱 앱에서는 /plugin이 플러그인 창을 여니 거기서 reddiana/AriadneNSD를 추가합니다.
claude plugin marketplace add reddiana/AriadneNSD
claude plugin install ariadne-nsd@ariadne-nsdclaude.ai: 최신 Release에서 ariadne-nsd.zip을 받아 Settings › Capabilities › Skills에 올립니다(“Code execution and file creation”을 켜 두어야 합니다).
자세한 것은 사용법의 AI 꼭지에 있습니다.
NOTE
지금은 웹 베타입니다. 요구사항 · 아키텍처 · 상세 설계를 바탕으로 코드를
src/에서 만들고 있고, 만든 것은 위의 주소에 올라갑니다. Obsidian 플러그인과 데스크톱 앱은 아직 설계 단계입니다.
이 저장소를 읽는 법
| 폴더 | 내용 |
|---|---|
docs/ | 애플리케이션 문서: 요구사항, 아키텍처, UX 설계, 상세 설계, 파일 형식 명세 |
src/ | 코드: pnpm 모노레포(모델 · 레이아웃 · 파일 형식의 core, 글꼴의 fonts, 편집 화면의 editor, 웹 앱). 개발을 시작하는 법은 src/README.md |
atelier/ | 아뜰리에: 현재 상태, 할 일, 답을 기다리는 것, 프로토타입, 결정 기록(아키텍처는 ADR, 그 밖은 DR), 세션 기록, inbox |
journal/ | 여정 기록: 타임라인, Claude Code 초보자의 배움 기록 |
til/ | Today I Learned: 백엔드 개발자가 프론트엔드를 배우며 정리한 것 |
site/ | 펴낸 사이트(GitHub Pages, Quartz)의 설정과 빌드 스크립트 |
로드맵
웹에서 먼저 다듬고, 같은 편집기를 Obsidian 플러그인과 데스크톱 앱으로 넓힙니다. 웹은 MVP → 베타 → 1.0을 거칩니다.
| 단계 | 버전 | 무엇을 | 저장한 파일 |
|---|---|---|---|
| 웹 MVP | 0.1 · 0.2 | 블록을 고르고 감싸는 구조 편집, Event · Method 헤더와 호출 블록, 예제, PNG 내보내기(0.1). 0.2에서 아래 1.0의 기능을 먼저 더했습니다. 링크를 아는 사람이 써 봅니다 | 뒤의 버전에서 열리지 않을 수 있음 |
| 웹 베타 (지금) | 0.3부터 | 널리 알리기 시작합니다. 사용법과 문제 알리기 채널을 갖추고, 아래 1.0의 기능을 판마다 더합니다 | 뒤의 버전에서 열리지 않을 수 있음 |
| Obsidian 베타 | 0.x | 웹 베타와 함께 시작합니다. BRAT 플러그인으로 GitHub에서 바로 설치합니다 | 뒤의 버전에서 열리지 않을 수 있음 |
| 웹 1.0 | 1.0 | 접기, Method로 빼기, 호출 블록 펴 보기, 구문 강조, 테마, 공유 URL, PDF · 인쇄, 고대비 화면. 키 배치가 굳습니다 | 뒤의 모든 버전이 엽니다 |
| Obsidian 1.0 | Obsidian 커뮤니티 플러그인 목록에 올립니다 | 뒤의 모든 버전이 엽니다 | |
| 데스크톱 앱 | 내 컴퓨터의 .ns · .ns.svg 파일을 바로 열어 편집 | ||
| 그 뒤 | Google Drive 연동, Confluence 앱, IDE 플러그인(VSCode · IntelliJ), Claude skill |
날짜는 정하지 않았습니다. 단계를 정한 과정은 DR-0018에, 기능마다의 우선순위는 요구사항에 있습니다.
어떻게 만들고 있나
이 프로젝트는 Claude Code를 처음 쓰는 백엔드 개발자가 AI와 함께 프론트엔드 앱을 만들어 가는 과정이기도 합니다. 그 과정에서 겪은 실수와 배움도 그대로 남깁니다. 누구라도 이 기록을 따라가 보며 “나도 해 볼 수 있겠다”는 용기를 얻기를 바랍니다.
- 설계: 요구사항부터 UX · 아키텍처 · 상세 설계까지 문서로 먼저 썼습니다. 결정의 근거는 결정 기록(ADR · DR)으로, 세션마다 의논한 것은 세션 기록으로 남깁니다.
- 시안과 프로토타입: 말로 견주기 어려운 것은 그림으로 그려 놓고 골랐고, 버릴 프로토타입으로 요구사항을 써 보았습니다. 페이지마다 무엇을 견주어 왜 골랐는지 적혀 있습니다:
atelier/sketchbook.md - MVP: 그 설계대로 코드를
src/에서 새로 짜서 v0.1.0으로 펴냈고, 웹 1.0의 기능을 더한 v0.2.0까지 냈습니다. - 웹 베타: v0.3.0부터 널리 알리고 써 보며 다듬습니다.
처음부터 지금까지의 흐름은 journal/timeline.md에, AI와 일하는 법을 배워 간 기록은 journal/learning-claude-code.md에 있습니다.
이름
AriadneNSD는 “아리아드네의 NS 차트”입니다. 그리스 신화에서 아리아드네는 미궁에 들어가는 테세우스에게 실타래를 건네, 그 실을 따라 되돌아 나올 수 있게 했습니다. 그래서 “아리아드네의 실(Ariadne’s Thread)“은 복잡한 곳에서 길을 잃지 않게 해 주는 것을 뜻합니다. 코드라는 미궁을 지나는 실이 NS 차트(NSD)라는 생각으로, 문자 로고에서는 Ariadne’s NSD라고 적습니다. 글로 적을 때의 이름은 언제나 AriadneNSD입니다.
더 긴 이야기는 journal/name-story.md에 있습니다.
로고
크노소스 궁전의 벽화 “푸른 옷의 여인들”에서 가운데 여인을 옮겨 그렸습니다. 아리아드네는 크노소스의 공주이고, 미궁에서 길을 잃지 않게 실타래를 건넨 사람입니다.
바탕 그림은 메트로폴리탄 미술관이 CC0로 공개한 Emile Gilliéron의 모사화 사진입니다. 자세한 것은 journal/logo-source.md에 있습니다.
라이선스
누구나 가져다 사용하고, 고치고, 팔 수 있습니다. 가져다 사용했다고 알려 주세요.
| 대상 | 라이선스 |
|---|---|
| 코드 (소스 코드, 프로토타입, 스크립트) | Apache License 2.0. 가져다 사용한 배포물에 NOTICE 파일의 글을 함께 실어 주세요 |
글 (docs/ · atelier/ · journal/ · til/의 문서, 이 README와 저장소 맨 위의 문서, 시안과 스파이크 페이지) | CC BY 4.0. 출처를 AriadneNSD (https://github.com/reddiana/AriadneNSD)로 밝혀 주세요 |
| 로고 (그림 로고와 문자 로고의 그림 파일) | 허락하지 않습니다. 이 프로젝트를 가리키는 데에만 사용할 수 있습니다 |
이름 (AriadneNSD) | 허락하지 않습니다. 가져다 만든 제품에 이 이름을 붙일 수 없습니다. “AriadneNSD를 가져다 사용했다”고 알리는 데에는 사용할 수 있습니다 |
위의 두 라이선스는 코드와 글을 사용할 권리만 줍니다. 이름과 로고를 사용할 권리는 주지 않습니다. 로고의 바탕이 된 메트로폴리탄 미술관의 사진은 CC0로 공개된 것입니다.