UX 결정 모음
이 문서는
조작과 화면의 작은 결정을 물음 하나에 한 항목씩 모은 곳입니다. 무엇을 골랐고 왜인지, 처음의 추천과 달라졌으면 그 까닭을 적습니다. 큰 결정은 ADR(목록)과 DR(목록)에 있습니다 → DR-0012
- 지금의 규칙은
docs/의 02-interaction-rules(조작), 03-keymap(키), 04-visual-design(모습)에 있습니다. 이 문서는 규칙을 다시 적지 않습니다.- 아직 정하지 않은 물음은 9. 미결정 사항이 원본입니다. 여기에는 표의 한 줄만 둡니다.
- 견준 안과 장면 그림은 시안 페이지에 있습니다(sketchbook). 물음마다 그 시안의 ID를 적습니다.
- UX 규칙 시안 M09 (Q1
Q12, Q17Q23): https://claude.ai/artifact/A7sWbwCA4NFC8qSZg58d3y · 사본journal/assets/2026-10-11-ux-rules-study.html- 호출 블록 펴 보기 시안 M08 (Q13~Q16): https://claude.ai/artifact/SRXMaLyK5KFCbFiRw7iwwL · 사본
journal/assets/2026-10-11-call-expand-study.html- 접기 영역 테두리 시안 M11 (T1 · T2 · P1 · P2): https://claude.ai/artifact/PW426nxL2ScUNG5aPzxbW2 · 사본
journal/assets/2026-10-13-fold-border-study.html- 물음이 어느 공통 규칙(R1~R7)에 속하는지는 3. 공통 규칙에 있습니다. 빠진 번호(Q18, Q22, Q23)는 요구사항 문서에 대한 물음이라 requirements-rework에 있습니다.
- 2026-10-18에
docs/02-ux-design/05-ux-decisions에서 이리로 옮겼습니다(메인테이너: 시안 M25의 D1 1번).
1. 결정 모음
| 물음 | 무엇 | 상태 |
|---|---|---|
| Q1 | 고치기를 시작하는 방법을 하나로 | 정함 (11-01): 1 어디서나 같은 명령 |
| Q2 | 더블클릭은 어디서나 고치기, 접고 펴기는 세모로 | 정함 (11-01): 1 어디서나 고치기 |
| Q3 | 고치다 누른 Esc의 뜻 | 정함 (10-13): 3 Enter와 Esc 모두 받아들임 |
| Q4 | 비울 수 없는 칸을 비우면 기본 글자 | 정함 (11-01): 1 머리도 고치기 전 이름으로 |
| Q5 | 새로 생기는 것은 고른 것 뒤, Shift는 앞 | 정함 (11-01): 갈래도 갈래 이름을 고르고 o / O (Q10-c) |
| Q6 | ”옮기기” 명령 하나 (블록, 갈래, 다이어그램) | 정함 (11-01): 1 Alt+방향키 |
| Q7 | 푸는 명령 | 정함 (10-13): 3 껍데기 풀기와 접기 영역 풀기를 따로 |
| Q8 | 고른 것이 명령의 대상이 아닐 때 | 정함 (11-01): 모두 담은 것을 찾아 올라감(지금대로) |
| Q9 | 실행 취소의 대상 | 정함 (10-13): 1 내용은 대상, 보기 상태는 아님 → UN1로 바뀜 (11-21) |
| Q10 | 고를 수 있는 것 | 정함 (10-13): 2 갈래의 이름도 고를 수 있다. 세부 (11-01): If도, 첫 블록에서 k, o O x |
| Q11 | Ctrl+← →를 없앨까 | 정함 (11-01): 2 세 겹 그대로 |
| Q12 | ”갈래 빼기”를 “갈래 지우기”로 | 정함 (11-01): 1 “갈래 지우기” |
| Q13 | 펴 보인 블록을 고칠 수 있는가 | 정함 (10-11): E1 고칠 수 없다 |
| Q14 | 펴 보인 안쪽의 호출 블록도 펼 수 있는가 | 정함 (10-11): D2 펼 수 있다. 세 겹째부터 펼 때마다 알림 |
| Q14-a | 알림의 모양 | 정함 (10-11): 1 먼저 펴고 알림 한 줄 |
| Q15 | 펴진 접기 영역과 펴 보인 호출 블록의 모습 | 다시 정함 (11-18): 둘 다 굵은 테두리 + 띠. 접기 영역은 파랑, 호출 블록은 보라 |
| Q15-a | 둘을 가르는 법 | 다시 정함 (11-18): 색. 흑백 인쇄에서는 띠의 글자 |
| Q15-b | While과 가르는 법 | 없어진 물음 |
| Q15-c | 이름 띠를 끄면 | 정함 (10-11): 2 띠도 테두리도 사라진다 |
| Q15-d | 테두리의 색 | 다시 정함 (10-17): 파랑 3px, 고른 표시는 주황 |
| Q16 | 호출 블록을 풀 때의 글자 | 정함 (10-13): 그대로 복사. 인자와 결과는 사라짐 |
| Q17 | 이어진 곳이 없는 호출 블록 풀기 | 정함 (10-13): 풀 수 없다고 알림 |
| Q19 | 명령이 끝난 뒤 무엇이 골라지는가 | 정함 (11-01): 1 바뀐 것, 지운 뒤에는 다음 블록 |
| Q20 | 접기 · 펴기가 듣는 곳을 한 문장으로 | 정함 (11-03, Claude의 추천안): 1 접을 수 있는 것이면 그것, 아니면 담는 가장 가까운 것 → FD1 |
| Q21 | Method가 없어지는 길 셋 | 정함 (10-13): 2 지금대로. Event로 바꾸기만 막는다 |
| Q24 | If 갈래의 이름 | 정함 (10-18): 고칠 수 있다 |
| Q25 | Case의 default 이름의 자리 | 정함 (10-18): 오른쪽 정렬 |
| MD1 | 접기 영역의 끝에 넣은 블록 | 정함 (10-18): 1 고른 것을 따른다 |
| MD2 | 글자 고치기의 실행 취소 단위 | 정함 (10-18): 1 칸을 열고 닫을 때까지 한 번 |
| MD3 | Case 갈래의 최소 수 | 정함 (10-18): 1 하나 + default까지, If ↔ Case로 바꿀지 묻기 |
| E1 | 빈 갈래의 기호 | 정함 (10-18): 1 ∅ |
| H1 | 머리 모양 “제목처럼”에서 Event · Method 가르기 | 정함 (10-18): 1 이름 + 작은 딱지 |
| K1 | 두 키 조합의 안내 자리 | 정함 (10-18): 1 화면 아래 안내 상자 → K3로 바뀜 (11-02) |
| K2 | 목록 안에서 옮기는 키 | 정함 (10-25): j / k |
| K3 | 두 키 조합의 안내 자리 (다시) | 정함 (11-02): 1 선택 바로 아래, 세로 목록 |
| TB1 | 툴바의 For | 정함 (11-03): 툴바에서 뺌(키 · 메뉴로) |
| TB2 | 감싸기 ▾의 아이콘 | 정함 (11-21): 블록 아이콘 크기에 색을 칠한 그림, 안쪽 네모는 실선 |
| TB3 | 감쌀 것이 없을 때의 감싸기 ▾ | 정함 (11-21): 흐리게, 누르면 메뉴 대신 이유를 알림 |
| FD1~FD10 | 접기 (11-03 밤에 에이전트가 만듦) | 정함 (11-03, Claude의 추천안 — 메인테이너가 써 보고 정함) → 2026-11-03 접기 · 호출 블록 |
| FD11 | 접힌 칸의 펼침 삼각형 자리 | 정함 (11-19, 메인테이너): 이름 첫 줄의 가운데 → FD11 |
| CB3~CB12 | 호출 블록 펴 보기 · 풀기 · 이름을 적는 호출 블록 (11-03 밤에 에이전트가 만듦) | 정함 (11-03, Claude의 추천안 — 메인테이너가 써 보고 정함) → 2026-11-03 접기 · 호출 블록 |
| CB13 | 펴 보인 곳의 접힘 | 정함 (11-19, 메인테이너): 그 자리의 것. 처음 펼 때만 Method에서 가져옴 → CB13 (CB12를 대체) |
| UN1 | 접고 펴기도 실행 취소의 대상 | 정함 (11-21, 메인테이너): 모든 접고 펴기 · 펴 보기가 한 단계. 이름 띠 · 결과 기호는 그대로 대상이 아님 → UN1 (Q9를 대체) |
| CB14 | 펴 보인 곳의 Method 접기 영역 | 정함 (11-21, 메인테이너, M69 SF1 2번): 처음 펼 때 그 자리로 복사. 그 뒤로 그 자리의 것 → CB14 |
| CB15 | Method 만들기 | 정함 (11-21, 메인테이너가 추천안을 받아들임): 이름을 적는 호출 블록에서 gd · 컨텍스트 메뉴로 그 이름의 Method를 만들어 잇는다 → CB15 |
| CB16 | Method 풀어 넣고 지우기 | 정함 (11-21, 메인테이너가 추천안을 받아들임): 모든 호출 자리에 풀어 넣고 Method를 지움. 호출 블록 · Method 헤더의 컨텍스트 메뉴, 단축키 없음 → CB16 |
| RO1 | 다른 탭이 편집 중일 때의 “보기만 하는 중” | 정함 (11-21, Claude가 정함 · BUG-18): 라벨에 까닭, 툴팁에 나갈 길 → RO1 |
| LG1~LG7 | LLM · 에이전트 안내서 (M56) | 정함 (11-10, 메인테이너가 추천안을 받아들임) → 2026-11-10 LLM · 에이전트 안내서 |
| JP1~JP3, RQ1, GD1, RQ2 | AI가 준 텍스트로 열기 · 요청문 · 안내서 손질 (M57) | 정함 (11-21, 메인테이너가 추천안을 모두 받아들임) → 2026-11-21 AI가 준 텍스트로 열기 |
| IE1 | 인라인 에디터가 열린 동안의 선택 하이라이트 | 정함 (11-19): 1 그리지 않음 → IE1 |
| AR1 | 호출 블록의 결과 기호 ←를 그리는 법 | 정함 (11-19): 1 문자로 유지 → AR1 |
2. 고치기 · 넣기 · 옮기기
Q3. Esc의 뜻 (R1)
정함 (2026-10-13): 3. Enter와 Esc 모두 적은 대로 받아들인다. 고치기 전으로 되돌리려면 실행 취소를 한다. 받아들일 수 없어 다시 연 칸(겹친 머리 이름)에서만 Esc가 고치기 전으로 되돌린다.
- 까닭: Vim에서
Esc는 적은 것을 남기고 나가는 키라서, 되돌리기로 두면 Vim에 익은 손이 적은 글자를 매번 잃는다 → DR-0009. 처음의 추천은 “Esc는 되돌리기”(1)였다. - 지금의 규칙 → Event 헤더
3. 묶기 · 풀기 · 실행 취소
Q7. 푸는 명령을 하나로 (R5)
정함 (2026-10-13): 3. 껍데기를 없애고 안의 것을 남기는 “풀기”는 제어 블록과 호출 블록에 듣고, 접기 영역 풀기는 따로 둔다.
- 까닭: Vim에서 접기(
zd)와 둘레 지우기(vim-surround의ds)는 서로 다른 가족이다. 메인테이너: “vim 단축키를 도입한 이유는 vim 사용자에게 친숙한 환경을 제공하기 위함입니다. 그점도 고려가 되면 좋겠습니다.” 처음의 추천은 “풀기 하나가 셋 모두에 듣는다”(1)였다. - 안쪽 블록을 고르고 풀면 그것을 담은 가장 가까운 제어 블록이 벗겨진다. Q8의 추천 1과 어긋나는 곳이고, 실행 취소로 되돌린다.
- 지금의 규칙 → 감싸기 · 풀기, 접기 · 펼치기
Q9. 실행 취소의 대상 (R7)
대체됨
2026-11-21에 메인테이너가 접고 펴기도 실행 취소의 대상으로 다시 정했다 → UN1. 결과 기호와 이름 띠는 지금도 대상이 아니다.
정함 (2026-10-13): 1. 파일의 내용을 바꾸면 실행 취소의 대상이고, 보기 상태를 바꾸면 대상이 아니다. 결과 기호(← / =)는 보기 상태에 넣는다.
- 까닭: 결과 기호는 “같은 내용을 어떻게 보여 주는가”이고 설정 화면에서 바꾸는 것이다. 이 구분은 ADR-0018이 파일 안에서 나눠 둔 “내용”과 “보기 상태”와 같다. 접기만 해도 “저장 안 됨” 표시는 뜬다.
- 지금의 규칙 → 6. 실행 취소
4. 호출 블록
4.1 호출 블록 펴 보기 (R6)
호출 블록 자리에 부르는 Method의 블록을 보기로만 보여 주는 기능이다. 접기 · 펴기 명령이 듣는 것에 호출 블록을 더한다. 지금의 규칙 → 호출 블록 펴 보기, 펴 보인 곳의 접기 영역. 정한 과정은 2026-10-11-03-ux-review에 있다.
- 펴 보인 안쪽에서 접기 · 펴기. → 정함 (2026-10-13): 그것을 담은 가장 가까운 펴 보인 호출 블록이 접힌다. 이 자리에서 만든 접기 영역 안이면 그 접기 영역이 먼저 접힌다.
- 펴 보인 곳의 접기 영역. → 정함 (2026-10-13). 그 호출 블록 자리에만 생기고 Method의 원본은 그대로다.
- P1. 원본의 접기 영역과 가려 보이는가. → 정함: 똑같이 그린다 (1).
- P2. Method가 바뀌어 묶어 둔 블록이 달라지면. → 정함: 남은 블록으로 줄어든다 (1).
- Q13. 펴 보인 블록을 고칠 수 있는가. → 정함 (2026-10-11): 고칠 수 없다 (E1). 여기서 고치면 그 Method를 부르는 모든 곳이 함께 바뀌는데, 그것이 화면에서 보이지 않는다. 고르면 Method의 원래 블록으로 따라갈 수 있다.
- Q14. 재귀. → 정함 (2026-10-11): 펴 보인 안쪽의 호출 블록도 펼 수 있다 (D2). 같은 Method가 세 번째로 펴지는 때부터 펼 때마다 알린다. 다이어그램 자신을 첫 번째로 센다. 서로 다른 Method를 차례로 펴는 것은 재귀가 아니다(이 풀이는 2026-10-25에 확인받음 → 2026-10-25-04-outbox-cleanup).
- Q14-a. 알림의 모양. → 정함 (2026-10-11): 먼저 펴고 알림 한 줄 (1). 편집기에 입력을 막는 자리를 늘리지 않는다.
- Q15. 펴진 접기 영역과 펴 보인 호출 블록의 모습. → 다시 정함 (2026-11-18): 둘 다 굵은 테두리 + 띠. 접기 영역은 파랑, 펴 보인 호출 블록은 보라. 메인테이너: “호출블록 펼치기는 접기영역 펼치기에서 선과 띠 색상만 보라색 계열로 해주세요.” 2026-10-13에는 접기 영역은 굵은 실선, 펴 보기는 강조가 아니므로 가는 점선이었고, 2026-10-11의 “왼쪽 세로 막대”는 접기 영역이 겹치거나 이어질 때 알아보기 어려웠다. 견준 그림 → 시안 M60: https://claude.ai/artifact/Gwz1JEezrZMY9w2pYKYNi6, 사본
journal/assets/2026-11-18-call-peek-frame-study.html- T1. 겹치거나 이어진 테두리 사이. → 정함 (2026-10-13): 틈을 둔다. 보통 블록은 테두리에 붙인다. 모든 블록을 들이면 테두리와 블록의 선이 나란히 서서 호출 블록의 이중선처럼 보인다.
- T2. 펴 보인 호출 블록. → 다시 정함 (2026-11-18): 펴진 접기 영역과 같은 3px 실선 테두리. 띠만 두면 겹쳐 폈을 때 안쪽 호출 블록의 끝이 보이지 않는다는 까닭은 그대로다. 2026-10-13에는 가는 점선 테두리였다.
- Q15-a. 둘을 가르는 법. → 다시 정함 (2026-11-18): 색으로 가른다. 흑백 인쇄에서는 모양이 같아지고 띠의 글자(호출문과 영역 이름)로 구별한다. 안의 블록도 접기 영역 안과 같게 일반 글자색과 구문 강조로 그린다. 2026-10-13에는 선의 모양과 색(실선 / 점선)이었고, 2026-10-11에는 “똑같이 그리고 색만 다르게”(C1)였다.
- Q15-b. While과 가르는 법. → 없어진 물음 (2026-10-13). 사방을 두른 테두리는 While의 왼쪽 띠와 닮지 않았다.
- Q15-c. 이름 띠를 끄면. → 정함 (2026-10-11): 테두리도 함께 사라진다 (2).
- Q15-d. 테두리의 색과 굵기. → 다시 정함 (2026-10-17): 파랑 3px로 두고, 고른 표시를 주황으로. 같은 파랑이면 고른 상자가 저장되는 테두리처럼 보인다. 한때 접기 영역을 무채색으로 바꿨으나 메인테이너가 원하지 않았다. 견준 안 → M19 접기 영역 색 시안 https://claude.ai/artifact/R6G68CKoUa8aKsj8rhsRW9
- 굵기 · 색 · 치수의 값 → 6. 선, 3.3 밝은 기본 테마
4.2 호출 블록을 Method의 블록들로 바꾸기 (R5)
Q7의 “풀기”가 호출 블록에 듣는 경우다. Method로 빼기의 반대이고, 호출 블록 자리에 Method의 블록들이 복사되어 들어간다. 지금의 규칙 → 감싸기 · 풀기
- Q16. 인자와 결과. → 정함 (2026-10-13): 글자는 그대로 복사한다. 편집기는 글자 안을 검사하지 않으므로(ADR-0022) Method 안의 이름(
a, lo, hi)을 호출 블록의 인자(a, lo, mid)로 바꿔 적을 수 없다. 호출 블록에 적혀 있던 인자와 결과는 사라진다. - Q17. 이어진 곳이 없는 호출 블록. → 정함 (2026-10-13): 풀 수 없다. 아무 일도 하지 않고 알린다.
4.3 부를 Method가 이 문서에 없을 때
2026-10-17에 메인테이너가 “호출할 서브루틴(다이어그램)이 없거나 다른 문서에 있을 수도 있음”이라고 적었다. 견준 안과 그림 → M18 호출 대상 시안 https://claude.ai/artifact/RXopHw9gKu4hmz5GvFo6Vx, 사본 journal/assets/2026-10-17-call-target-study.html. 지금의 규칙 → 호출 블록
- CB1. 부를 것을 그리지 않았을 때. → 정함 (2026-10-17): 이름을 직접 적는 호출 블록, 보통 모양 (1). 라이브러리 함수를 부르는 것은 잘못이 아니므로 점선과
?로 그리지 않는다. 빈 Method를 만들어야만 부를 수 있게 하면 함수마다 빈 다이어그램이 늘어난다. - CB2. 다른 문서의 Method. → 정함 (2026-10-17): 파일과 Method를 가리켜 둔다 (1). 우선순위는
P2. 그 전에는 CB1의 이름을 적는 블록으로 부를 수 있다.
5. 고르기 · 이동 · 접기 · Method
Q10. 고를 수 있는 것의 목록
정함 (2026-10-13): 2. 갈래의 이름도 고를 수 있다. 갈래 전용 키를 줄이고, 지우기 · 옮기기가 갈래에도 듣게 하려는 것이다. 처음의 추천은 “갈래는 고를 수 없게 두고 지금 갈래로 대신한다”(1)였다(방향키가 멈추는 곳이 늘어 If · Case를 지나가기 번거로워진다는 까닭).
Q21. Method가 없어질 때
정함 (2026-10-13): 2. 지금대로 둔다. 부르는 곳이 있는 Method를 Event로 바꾸는 것만 막고, 머리 떼기와 다이어그램 지우기는 허용한다(호출 블록은 끊긴 채 남는다). 처음의 추천은 “셋 다 허용”(1)이었다. 지금의 규칙 → Method 헤더
6. 이미 정한 것 가운데 처음 읽는 눈에 놀라웠던 곳
독립 검토(요구사항 문서와 용어집만 건네받은 다른 검토자)가 다시 물은 것이다. 까닭을 알고 정한 것이므로 그대로 두는 것이 기본이고, 사용자가 처음 만났을 때 놀랄 수 있는 곳의 목록으로 남긴다. → 독립 검토와 같은 결론에 닿은 것
- 머리에서 괄호를 지우면 호출 블록의 인자가 사라지는 것. 2026-10-13에 “기억하지 않는다”로 정했다. 같은 파일이 기기에 따라 다르게 되살아나지 않게 하려는 것이다.
- 인자 칸을 비울 수 없는 것. Q4에서 공통 규칙의 한 경우가 되었다(2026-11-01).
- 접고 펴기가 실행 취소의 대상이 아닌 것. 그림이 바뀌었는데 실행 취소가 듣지 않는다. 대신 “저장 안 됨” 표시는 뜬다(Q9). → 2026-11-21에 UN1로 답했다(접고 펴기도 대상).
- 붙여넣기가 고른 것을 바꿔 놓지 않고 뒤에 붙는 것. 글자 편집기와 다르다. 구조 편집기에서는 뒤에 붙는 쪽이 안전하다고 보아 그대로 둔다.
- 새 Method가 맨 뒤에 생기고 화면이 그리로 가는 것. 블록을 뺀 사용자가 보던 자리를 잃는다. → 2026-11-03에 XM1(뺀 Method 바로 뒤)과 XM2(호출 블록으로 돌아옴)로 답했다.
- 머리에서 좌우 이동이 옆 다이어그램으로 가는데, 다이어그램은 위에서 아래로 쌓이는 것. 키의 방향과 화면의 방향이 맞지 않을 때가 있다.
7. 2026-10-18의 결정
Q24. If 갈래의 이름
2026-11-03에 처음 이름의 언어가 화면 언어에서 문서 설정의 "그림 문구의 언어"로 바뀌었다 → ADR-0041
정함 (2026-10-18): 고칠 수 있다. 처음 이름은 “참” · “거짓”(화면 언어)이고, 비우면 처음 이름으로 돌아간다. 메인테이너(inbox): “if블록 브랜치 레이블도 수정할 수 있게해주세요”. 지금의 규칙 → If 블록
Q25. Case의 default 이름의 자리
정함 (2026-10-18): 오른쪽 정렬. default 칸은 짧은 빗금 아래 오른쪽 끝이라 표준 모양에도 맞는다. 메인테이너(inbox): “case블록의 default 레이블은 우측 정렬 해주세요.” 지금의 모습 → 원칙 2. 뜻은 모양이 나르고, 색은 거들기만 한다
MD1. 접기 영역의 끝에 넣은 블록
정함 (2026-10-18): 1. 고른 것을 따른다. 영역 안의 블록을 골라 앞 · 뒤에 넣으면 영역 안에, 영역 전체(이름 띠, 접힌 칸)를 골라 넣으면 밖에. 접기 영역이 블록을 품지 않는 “줄의 표시”가 되어 생긴 물음이다. 견준 안 → 시안 M23의 MD1. 지금의 규칙 → 키보드로 이동하고 삽입하기, 4.3 규칙 F: 접기 영역의 범위가 줄 밖으로 나갈 때
MD2. 글자 고치기의 실행 취소 단위
정함 (2026-10-18): 1. 글자 칸을 열고 닫을 때까지가 한 번. 칸이 열려 있는 동안의 Ctrl+Z는 그 칸의 글자만 되돌리고(칸을 연 때까지), 칸 밖으로 넘어가지 않는다. 메인테이너가 “칸을 열고 고치는 도중 (아직 엔터를 입력하기 전)에 crtl+z는 어떻게 동작하나요?”라고 물어 이 부분을 시안에 더했다. 견준 안 → 시안 M23의 MD2. 지금의 규칙 → 6. 실행 취소
MD3. Case 갈래의 최소 수
정함 (2026-10-18): 1. default가 아닌 갈래는 하나까지. 하나만 남으면 If로 바꿀지 묻고, If에서 +를 누르면 Case로 바꿀지 묻는다(2026-11-01부터 갈래 이름을 선택하고 넣기 → Q10). 뒤의 둘은 메인테이너가 더했다: “if처럼 보이게 될 것이라면 if블록으로 변환할지 물어보게 해주세요. 또, if블록에서 +를 누르면 case블록으로 변환할지 물어보게 해주세요.” 묻는 모양과 글자를 옮기는 법은 정하지 않았다. 견준 안 → 시안 M23의 MD3. 지금의 규칙 → Case 블록
- 모델은 넓게, 편집 명령은 좁게 (2026-10-18). 메인테이너: “코드 리버스엔지니어링 할 때, default만 있는 코드는 문제가 되지 않을까요?” 그래서 모델은 default가 없거나 default만 있는 Case도 담고, 편집 명령만 위 규칙을 지킨다 → 1.4 블록
E1. 빈 갈래의 기호
정함 (2026-10-18): 1. ∅. NS 차트 도구들이 빈 칸에 쓰는 기호이고, 말이 아니라서 화면 언어와 상관없다. 메인테이너(inbox): “if나 case 블록의 브랜치 내부에 아무 블록도 없으면 아무것 도 없다는 의미기 기호를 넣어주세요.” 견준 안 → 시안 M24의 E1. 지금의 모습 → 원칙 2. 뜻은 모양이 나르고, 색은 거들기만 한다
H1. 머리 모양 제목처럼
정함 (2026-10-18): 1. 이름 + 작은 딱지(Event · Method). 머리 모양을 문서마다 고르게 한 것은 메인테이너의 결정이다(inbox: “우리가 도입한 블록모양을 그대로 쓴다 … 레이블만 보여서 다이어그램의 제목처럼 보이게 한다”). 물음은 “제목처럼”에서 Event와 Method를 가르는 법이었다. 이름만 두면 괄호 없는 Method가 Event와 똑같이 보인다. 견준 안 → 시안 M24의 H1. 지금의 모습 → 원칙 2. 뜻은 모양이 나르고, 색은 거들기만 한다
K1. 두 키 조합의 안내
2026-11-02에 K3으로 바뀌었다(선택 바로 아래).
정함 (2026-10-18): 1. 0.4초 안에 둘째 키를 누르지 않으면 화면 아래에 안내 상자. 다이어그램을 가리지 않고 키가 많아도 다 들어간다. 메인테이너(inbox): “첫번째 키가 입력되면 두번째 키에대한 안내(선택)도 사용자에게 제시해주세요. … 일단 떠오르는 것은 팝업이네요.” 팝업(고른 블록 옆)은 2번으로 견주었다. 견준 안 → 시안 M24의 K1. 지금의 규칙 → 03-keymap
8. 2026-10-25의 결정
K2. 목록 안에서 옮기는 키
정함 (2026-10-25): j / k로 옮긴다. 메인테이너: “a, c 하면 호출 메소드 메뉴가 나오는데 j/k 로 선택을 옮기는 것으로 합시다”. 블록 사이를 j k로 옮기는 손이 목록에서도 그대로 쓰이게 하려는 것이다. ↓ ↑, 숫자 키, Enter, Esc는 그대로다. Claude가 같은 규칙을 오른쪽 클릭 메뉴에도 넓혔다(프로토타입에서 두 목록의 키 처리가 한 곳이라). 61번째 판에 넣음. 지금의 규칙 → 03-keymap
FB1. For 블록의 모양
정함 (2026-10-25): 2. While과 같은 모양, 머리의 글자로만 가른다. NS 차트 표준(DIN 66261)의 그림 그대로다. Claude의 추천은 1번(왼쪽 띠에 자의 눈금)이었다. 시각 디자인의 원칙 2(“모양만으로 가려진다”)에 For와 While의 예외를 두었다. 머리를 칸 넷(변수 · 시작 · 끝 · 간격)으로 나누는 3번은 모델이 바뀌고 C의 for (p = head; p; p = p->next)를 그릴 수 없어 견주기만 했다. 견준 안 → 시안 M33의 F1 https://claude.ai/artifact/TCXa7uViaEfsfVMAQJ8BkB (사본 journal/assets/2026-10-25-for-block-study.html). 지금의 규칙 → For 블록, 원칙 2. 뜻은 모양이 나르고, 색은 거들기만 한다
FB2. For를 넣는 키
정함 (2026-10-25): 1. f. 넣기 a / A + f, 감싸기 s + f. f만 누르면 지금처럼 접기 · 펴기다(둘째 키로만 종류 글자로 읽음). 견준 안 → 시안 M33의 F2. 지금의 규칙 → 03-keymap
BH1. If · Case 머리의 폭과 높이
정함 (2026-10-25): 머리의 폭과 높이는 지금 프로토타입 그대로(폭은 글자 + If 70px · Case 90px, 높이는 늘리지 않음). 긴 조건이 빗금에 닿는 곳은 글자 뒤에 머리 바탕색의 테두리를 깔아 가린다. 처음 물음(M34의 B1)은 겹치지 않게 넓힐지(약 2.1배 · 1.5배) 높일지(1.25배)였다. 메인테이너가 1번(높이는 같게, 넓힘)을 골랐다가 되돌렸다: “지금 프로토타입이 좋습니다. 1번은 너무 넓네요. 2번, 3번은 단연코 반대입니다.” 이어 B2에서 겹치는 곳의 모습을 견주었고(1. 글자 뒤 바탕, 2. 겹쳐도 그대로, 3. 두 줄로는 프로토타입 폭에서 안 풀림), 메인테이너: “지금의 1번 좋습니다”. 시각 디자인 명세의 “글자는 빗금과 겹치지 않아야 한다 · 머리의 높이를 늘린다”(2026-10-16, Claude)를 이것으로 바꾸었다. 테두리의 두께 토큰 size.text-halo 3px은 Claude가 붙였다(시안의 값). 견준 안 → 시안 M34 https://claude.ai/artifact/XJkiq8syCEPfyL99Kbbk98 (사본 journal/assets/2026-10-25-branch-head-study.html). 지금의 규칙 → 1.4 블록, 5. 기하와 해부도
LT1. 긴 글자
정함 (2026-10-25): 1. 폭을 늘린다(사용자가 적은 줄 그대로). 블록 글자는 저절로 줄을 바꾸지도, 잘라 말줄임표를 붙이지도 않는다. 줄은 사용자가 글자를 고치는 중에 Shift+Enter로 바꾼다(프로토타입에 있던 키인데 키 표에 없어 이때 적었다). 블록 글자가 코드에 가까워 줄을 어디서 나눌지는 쓰는 사람이 정하는 편이 맞고, 코드에서 가져온 글자도 원래 줄 그대로 보인다. 견준 안 → 시안 M35의 L1 https://claude.ai/artifact/Rxe7qDL9N4oeCD8cruYe74 (사본 journal/assets/2026-10-25-long-text-study.html). 지금의 규칙 → 1.2 텍스트의 크기, 03-keymap
SB1. 짧은 갈래
정함 (2026-10-25): 3. 짧은 갈래의 블록들을 고르게 늘린다. If · Case의 한 갈래가 짧아 남는 높이를 그 갈래의 블록 수로 똑같이 나눠 더한다. 한 블록만 커 보여 일이 많은 것처럼 읽히지 않게 하려는 것이다. Claude의 추천은 1번(마지막 블록을 늘림, 지금 프로토타입)이었다. 아래에 빈 칸을 두는 2번은 빈 칸이 빈 블록과 같아 보여 견주기만 했다. 나머지의 몫과 제어 블록 안으로 나누는 세부는 Claude가 정했다. 견준 안 → 시안 M36의 S1 https://claude.ai/artifact/JN9SCyvkJfRaXJ9CyaaDq6 (사본 journal/assets/2026-10-25-short-branch-study.html). 지금의 규칙 → [[02-layout#13-줄-seq|1.3 줄 (Seq)]]
CD1. default가 없는 Case
정함 (2026-10-25): 2. 빈 default 칸(∅)을 그려 둔다. 코드에서 가져온 switch에 default가 없으면, 모델에는 갈래가 없지만(otherwise: null) 그림에는 빈 default 칸을 그려 보통 Case와 같은 모양으로 둔다. 코드의 뜻도 같다(default가 없으면 아무 일도 하지 않음). Claude의 추천은 1번(긴 빗금이 오른쪽 끝까지, NS 차트 표준)이었다. 그 칸을 고르고 적으면 default가 생기는 동작은 Claude가 정했다. 견준 안 → 시안 M37의 C1 https://claude.ai/artifact/NhjkFEJhd1cf6DLvxjh6Dt (사본 journal/assets/2026-10-25-case-default-study.html). 지금의 규칙 → Case 블록, 1.4 블록
CD2. default만 있는 Case
정함 (2026-10-25): 1. 짧은 빗금 하나. 보통 Case의 규칙(긴 빗금은 default 칸의 왼쪽 아래로)에서 default 칸이 블록 전체이니 짧은 빗금만 남는다. 견준 안 → 시안 M37의 C2. 지금의 규칙 → 1.4 블록
DA1. Event 무리와 Method 무리 사이
정함 (2026-10-25): 1. 두 배(88px, space.kind-gap). 다이어그램 사이(44px)와 한눈에 갈리면서 그림이 많이 넓어지지 않는다. 시안의 그림은 Claude가 정한 줄 높이 셈(4px씩 올리며 16 : 10에 가장 가까운 것, 같으면 낮은 것, 두 무리가 같은 줄 높이)으로 그렸고 메인테이너가 그 그림을 보고 골랐다. 견준 안 → 시안 M38 https://claude.ai/artifact/NyrNMU8fdW9CMekCXX3fpt (사본 journal/assets/2026-10-25-diagram-arrange-study.html). 지금의 규칙 → 1.7 여러 다이어그램의 배치
9. 2026-10-31의 결정
메인테이너가 프로토타입을 써 보고 inbox에 적은 것이다. 시안 없이 정했다.
HS1. 머리 모양을 기억하고 기본은 제목처럼
정함 (2026-10-31): 마지막으로 고른 머리 모양을 기억해 새 문서에 쓰고, 고른 적이 없으면 “제목처럼”. 메인테이너(inbox): “머리모양 선택을 기억하게 해주세요”, “머리모양 디폴트를 “제목처럼”으로”. 머리 모양은 그대로 문서 설정이다(파일에 저장, R-LAY-10). 기억하는 것은 사용자 설정이고 새 문서의 처음 값으로만 쓴다. 파일을 열면 파일의 값을 따르고, 연다고 기억한 값이 바뀌지 않는 것은 Claude가 정했다. 머리 모양이 적히지 않은 예전 파일은 지금처럼 “모자 · 아치”로 읽는다(Claude). 지금의 규칙 → 헤더 모양
OP1. 열면 고른 것이 없다
정함 (2026-10-31): 화면이 처음 열리거나 파일을 열면 아무 블록도 골라져 있지 않다. 메인테이너(inbox): “화면이 열리면 선택된 블록 없을 것”. 처음 보는 그림이 고른 테두리 없이 보이게 한다. 이동 키를 누르면 첫 블록을 고르는 규칙은 그대로다. “새로”(빈 문서)는 바로 적을 수 있게 빈 블록을 고른 채로 둔다(Claude). 명령 뒤에 무엇이 골라지는가(Q19의 남은 물음)는 그대로 열려 있다(Q19는 2026-11-01에 정함). 지금의 규칙 → 키보드로 이동하고 삽입하기
MB1. 좁은 화면
정함 (2026-10-31): 좁은 화면에서는 도구 모음 · 설정 · 안내를 접어 두고 다이어그램에 화면을 준다. 메인테이너(inbox): “모바일에서 메뉴랑 옵션 선택 부분이 고정되어있어서 다이어그램을 보여줄 공간이 없음”. 원칙만 정했다(→ 2. UX 원칙). 펴는 단추의 자리와 모양은 편집기 설계(1. 화면 구성)에서 정한다 (그 뒤 화면 배치의 “좁은 화면”에서 정함, 2026-11-01). 프로토타입 64번째 판은 폭 860px 이하에서 머리 줄의 “메뉴” · “안내” 단추로 편다(Claude).
MB2. 좁은 화면의 툴바
정함 (2026-11-01): 좁은 화면에 아래 줄을 두지 않는다. 되돌리기 · 다시 · 감싸기 · 도움말도 툴바에 둔다. 처음엔 툴바를 두 줄로 지키려고 이 넷을 화면 아래 줄에 내렸다(Claude, 화면 배치). 메인테이너(S26에서 써 보고): “감싸기가 화면 아래에 있어요. 이럴 필요가 있나요?” MVP를 폰 크기로 띄워 셋을 견줌(그림 journal/assets/2026-11-01-narrow-wrap-options.png): 1 지금(아래 줄), 2 감싸기만 툴바로, 3 아래 줄 없앰. 3을 고름(Claude의 추천). 툴바가 한 줄 늘어도 아래 줄이 없어져 다이어그램의 자리는 1과 같고, 버튼이 노트북과 같은 자리에 모인다. 2는 툴바도 늘고 아래 줄도 남아 가장 좁다
10. 2026-11-01의 결정
MVP에 드는 조작의 미결정을 한 번에 정했다(메인테이너: “mvp 전에 결정해야할 것들을 결정합시다”). 2026-10-11의 M09에서 물었던 것을 프로토타입 64번째 판의 그림으로 다시 그려 시안 M43 https://claude.ai/artifact/N7GhRyH47c5qs98V1N9uqH (사본 journal/assets/2026-10-31-mvp-ux-questions-study.html)에서 하나씩 물었다. 모두 Claude의 추천대로다. 접기 · 펴기가 듣는 곳(Q20)과 If ↔ Case로 바꾸는 모양은 MVP 뒤로 남겼다.
Q1 · Q2. 고치기를 시작하는 방법과 더블클릭
정함: Q1 1번 어디서나 같은 명령, Q2 1번 더블클릭은 어디서나 글자 고치기. 키(i · cc · Enter · F2)는 64번째 판에서 이미 하나였고(Q1은 확인), 남은 것은 접힌 칸과 이름 띠의 더블클릭(펴기 · 접기)이었다. 메인테이너가 “1번이면 접고 펴는 것은 어떻게 하나요?”라고 물었고, Claude가 답했다: 접힌 칸과 이름 띠 앞에 이미 그려진 세모(▸ ▾)를 단추로 쓰고, 키(za f zo zc)와 오른쪽 클릭 메뉴는 그대로다. 고칠 글자가 없는 접힌 줄(”⋯ 블록 n개”)의 더블클릭은 펼치기로 남긴 것은 Claude가 정했다. 세모를 저장되는 그림에 넣지 않는 것도 Claude가 정했다(처음 M09의 추천 그대로). 지금의 규칙 → 텍스트 편집, 접기 · 펼치기
Q4. 비울 수 없는 칸 (R2)
정함: 1번 머리의 이름을 비우면 고치기 전의 이름으로 돌아가고 칸이 닫힌다. 비울 수 없는 칸은 어디서나 기본 글자로 돌아간다. 칸을 다시 여는 것은 이름이 겹칠 때뿐이다. 지금의 규칙 → 텍스트 편집
Q6. 옮기기 명령 하나
정함: 1번 “옮기기” 하나, Alt+방향키(Alt+h j k l도). 블록은 위 · 아래, 갈래는 왼쪽 · 오른쪽, 머리를 골랐으면 다이어그램의 순서. 키는 VS Code의 줄 옮기기를 본떴다(Claude). If의 참 · 거짓을 맞바꿀 때 조건 글자를 뒤집지 않고 알리기만 하는 것, 줄 끝에서 제어 블록 밖으로 나오고 안으로는 들어가지 않는 것은 Claude가 정했다(M43에 적어 보인 대로). 지금의 규칙 → 이동
Q10의 세부와 Q5. 갈래 이름 고르기, 갈래 넣기와 지우기
정함: a 1번 If의 “참” · “거짓”도 고를 수 있다. b 1번 갈래의 첫 블록에서 k(↑)로 갈래 이름에 간다(내려갈 때는 멈추지 않음). c 1번 갈래 이름을 고르고 블록과 같은 키 o · O · x로 갈래를 넣고 지운다. + -는 없앤다. c가 Q5(갈래를 앞에 넣는 방법)의 답이다. 메인테이너가 c에서 “갈래 안의 블록을 선택하고 oOx하면 어떻게 되나요?”라고 물었고, Claude가 답했다: 고른 것이 블록이면 블록에, 갈래 이름이면 갈래에 듣는다. 갈래 이름에서 h l은 옆 갈래 이름, j는 그 갈래의 첫 블록으로 가는 것, 다른 블록 넣기(a + 종류)는 갈래 이름에서 듣지 않는 것, Shift+L을 갈래 안 블록에서 바로 이름을 고치는 지름길로 남기는 것은 Claude가 정했다. 지금의 규칙 → 분기 라벨 선택, Case 블록
Q8. 고른 것을 담은 것에 듣는 명령
정함: 1번 지금대로. 풀기(ds) · 접기 영역 풀기(zd) · 접기 · 펴기(za)는 고른 것, 아니면 그것을 담은 가장 가까운 것에 듣고, 무엇에 들었는지 알린다. 처음(2026-10-11)의 추천은 “내용을 바꾸는 명령은 고른 것에만”이었으나, 45번째 판에서 Vim의 ds(에 맞춰 ds가 안쪽에서도 듣게 바꾼 뒤라 추천을 바꿨다. 지금의 규칙 → 감싸기 · 풀기
Q11. 좌우 이동의 겹
정함: 2번 세 겹 그대로(Ctrl+← →를 남김). 처음 추천은 1번(없앰)이었다. 이미 들어 있고 시험도 있어 MVP의 일이 늘지 않으므로 추천을 2번으로 바꿨다. 지금의 규칙 → 키보드로 이동하고 삽입하기
Q12. “빼기”라는 말
정함: 1번 “갈래 빼기”를 “갈래 지우기”로. “빼기”는 Method로 빼기에만 쓴다. “머리 떼기”는 그대로다.
Q19. 명령 뒤에 고르는 것
정함: 1번 만들거나 바뀐 것을 고르고, 지운 뒤에는 다음 블록(없으면 앞, 둘 다 없으면 담고 있던 블록). 64번째 판이 이미 이렇게 움직인다. 지금의 규칙 → 키보드로 이동하고 삽입하기
11. 웹 화면 (2026-11-01)
웹 버전(MVP)의 화면을 시안 M44 https://claude.ai/artifact/VpocjhpW3vtPJ8UHvoyFgX (사본 journal/assets/2026-11-01-web-screen-study.html)에서 하나씩 물어 W1 ~ W6을 모두 정했다(2026-11-01).
W1. 웹 화면의 배치
정함 (2026-11-01): 메뉴 막대 + 블록 아이콘의 도구 모음 (Structorizer처럼). 첫 판은 SequenceDiagram.org를 본보기로 왼쪽 아이콘 막대를 추천했다. 메인테이너가 되물었다: “structorizer를 참고하고 싶습니다. 물론 웹버전은 아니지만 우리의 웹버전은 데스크톱버전과 거의 유사하니까요. structorizer의 아이콘바에 블록들이 있는 것이 편해보입니다.” 둘째 판에서 모든 안의 도구 모음에 블록 모양 아이콘을 넣고 Structorizer식을 1번(추천)으로 두었고, 메인테이너가 1번을 골랐다. 견준 것: 도구 모음 한 줄과 ☰, 왼쪽 세로 막대, 리본. Structorizer와 SequenceDiagram.org의 화면은 Claude의 기억이고 안내서에서 확인하지 못했다. 지금의 규칙 → 화면 배치
W2. 블록 아이콘을 쓰는 법
정함 (2026-11-01): 누르기는 언제나 넣기(뒤에, Shift는 앞에), 감싸기는 Ctrl+클릭 · 블록 위에 끌어 놓기 · s + 종류. 메인테이너가 놓는 자리의 규칙을 제안했다: “끌어 놓을 때는 마우스 위치가 블록 위일 때는, 다른 블록을 포함할 수 있는 블록유형(루프라든지)이라면 그 불록을 포함. if블록이라면 참으로 포함, case라면 첫번째 브랜치로 포함. 포함할 수 없는 블록이라면 뒤에 추가. 블록 사이일 때는 그 위치에 추가.” 누르기는 “현재 선택한 블록이 한개라면 뒤에 추가, 여러 블록을 영역으로 선택한 상태이면 블록 위일 때처럼”이었다. Claude는 끌어 놓기 규칙은 파일 탐색기의 관례와 같고 감싸기 규칙과도 맞아 일관된다고 보았고, 누르기는 고른 수에 따라 뜻이 바뀌어 블록 하나를 아이콘으로 감쌀 수 없고 같은 대상에 누르기와 끌기가 달리 움직인다고 짚어 “누르기는 언제나 넣기, Ctrl+클릭은 감싸기”를 추천했다. 메인테이너: “추천을 수용합니다”. 세부는 Claude가 정했다: 빈 블록 위에 놓으면 그 빈 블록을 바꿈, 고른 블록 가운데 하나 위에 놓으면 고른 것 전체를 감쌈, 이미 있는 블록을 옮길 때는 블록 위에 놓아도 가까운 사이로, 고른 것이 없을 때 누르면 다이어그램의 맨 끝에. 지금의 규칙 → 블록 아이콘으로 삽입 · 감싸기, 7. 드래그 앤 드롭
W3. 파일 이름과 저장 상태
정함 (2026-11-01): 파일이 하나면 탭 줄을 숨기고 메뉴 막대 오른쪽에 이름과 ●, 둘 이상이면 탭 줄이 나타나 탭으로 옮김. M44 넷째 판의 추천은 VS Code · IntelliJ처럼 “편집기 탭”이었다. 메인테이너: “w3도 다른 ide를 참고해서 의견 주세요”. Claude가 VS Code · Sublime · IntelliJ · Eclipse · Visual Studio · Xcode · draw.io · Google Docs의 모습을 표로 견주었다(Claude의 지식, 이번에 확인하지 않음): IDE는 편집기 탭에 이름과 표시(● 또는 *), 웹 도구는 왼쪽 위 제목과 “저장됨” 글. 메인테이너: “탭이 하나 뿐일 때는 탭을 안보이게 하는 UI도 쓰이는 사례가 있나요?” macOS의 탭 창(Finder · TextEdit · 터미널), 예전 Safari, Windows Terminal의 설정이 그렇고 그때는 창 제목이 그 일을 맡는다고 답했다. 웹 MVP는 늘 문서 하나라 탭이 자리만 차지하므로 섞은 안을 추천했고 메인테이너가 골랐다. 표시는 ●, 브라우저 탭 제목에도, 닫을 때 묻기는 Claude가 정했다. 지금의 규칙 → 화면 배치
W3-b. 임시 보관과 자동 저장
정함 (2026-11-01): 1번 임시 보관은 늘, 원래 파일에 자동 저장도 기본으로 켬(IntelliJ처럼). 견준 것: 기본 끔(VS Code의 files.autoSave: off). 고치고 2초 뒤에 저장하는 것, 쓰기 권한을 받은 파일만, Firefox · Safari는 자동 저장 없음은 Claude가 정했다(그 브라우저들은 원래 파일에 쓸 수 없음). 지금의 규칙 → 2. 로컬 백업과 자동 저장
W4. 도움말
정함 (2026-11-01): 1번 사용법은 새 탭의 한 페이지, 단축키는 ? 키의 겹창. 견준 것: 오른쪽 접는 패널(지금 프로토타입). ?가 Vim의 뒤로 찾기와 다른 것은 Claude가 키 표의 “Vim과 다르게 만든 곳”에 적었다. 도움말 메뉴의 “문제 알리기”는 그 기능(R-REP-01, P3)이 들어올 때 더한다. 지금의 규칙 → 화면 배치
- 2026-11-21에 바뀜: “AriadneNSD에 대하여”의 링크 둘은 이름(“문서” · “GitHub 저장소”) 아래에 전체 주소를 링크 글자로 보인다. 메인테이너: 아키텍처와 설계를 관심 있는 개발자와 공유하려고 주소가 보이게.
W5. 설정
정함 (2026-11-01): 2번 문서 설정(다이어그램 메뉴)과 환경 설정(파일 메뉴)을 창 둘로 나눔. Claude의 추천은 1번(VS Code · IntelliJ처럼 창 하나에 “사용자 · 이 문서” 탭)이었다. 메인테이너는 값이 어디에 저장되는지가 창으로 갈리는 2번을 골랐다. 환경 설정의 키 Ctrl+,(VS Code와 같음)는 Claude가 붙였다. 지금의 규칙 → 화면 배치
W6. 명령 찾기
정함 (2026-11-01): 둔다, MVP에 넣음. 메인테이너가 “VSCode나 IntelliJ 같은 IDE를 참고해봅시다”라고 해 Claude가 IDE의 Command Palette · Find Action을 새 물음으로 더했다. 요구사항에 없어 R-EDIT-24를 P0으로 더했다 → DR-0015의 이후 변경. 키 Ctrl+Shift+P · F1(VS Code와 같음), 고른 것에 듣지 않는 명령은 흐리게, 최근 명령이 위, Obsidian은 Obsidian의 명령 팔레트로는 Claude가 정했다. 지금의 규칙 → 커맨드 팔레트
12. 예제 (2026-11-01)
메인테이너가 inbox에 적었다: “프로토타입에 있었던 예제들 삽입하는 기능을 가져옵시다.” 시안 M46 https://claude.ai/artifact/UCv5JocwUAvNxL5KjKf9ri (사본 journal/assets/2026-11-01-example-picker-study.html)에서 정했다. 과정 → 2026-11-01-02-docs-current-examples. 지금의 규칙 → 05-screen-layout
EX1. 예제의 목록과 순서
정함 (2026-11-01): 프로토타입의 열둘 가운데 겹치는 둘을 뺀 열, 쉬운 것에서 어려운 것으로. 뺀 것은 “문장식”(“코드식”과 같은 로직)과 “이진 탐색(한 장)”(“이진 탐색”과 같은 알고리즘)이다(메인테이너: “겹치는 것 빼고 10개 (추천)”). 순서는 메인테이너가 맡겼다(“예제의 순서도 신경써주세요. 알아서 잘 해주세요.“): 새 블록과 새 개념이 하나씩 늘게 놓고, README의 그림 둘을 앞에 두었다. 예제 여섯이 Event · Method 헤더와 여러 다이어그램을 써서, 그 기능도 MVP에 넣었다 → DR-0015의 이후 변경
EX2. 첫 방문 모달
정함 (2026-11-01): 1번 4 × 3 격자, 남는 두 칸은 “빈 문서로 시작” · “파일 열기…” 카드. 처음엔 모달 안의 드롭다운을 추천했으나 메인테이너: “드롭다운 말고 예제 목록을 한번에 다 보여주세요. 34나 43이면 한번에 다 보여줄 수 있겠네요.” 견준 것: 5 × 2 격자와 아래 단추
EX3. 도움말 › 예제…와 툴바
정함 (2026-11-01): 도움말 › 예제…는 같은 모달을 연다(제목 “예제 열기”), 툴바는 “예제 ▾” 드롭다운. 처음엔 도움말 › 예제 ▸ 하위 메뉴(모두 같은 레벨)였다. 메인테이너: “도움말>예제를 클릭해도 이 모달이 뜨면 좋겠네요. 그 때는 맨 위 문구를 어떻게 해야할까요?” 환영 인사는 처음 한 번만 하고, 메뉴에서 열면 새 문서로 열린다는 것과 지금 문서가 어떻게 되는지를 적는다(Claude의 추천을 고름). 견준 것: 언제나 같은 환영 문구, 제목 “예제”만. 툴바의 드롭다운은 EX4로 바뀜
EX4. 툴바의 예제는 모달로
정함 (2026-11-01): 툴바의 “예제”는 드롭다운 대신 도움말 › 예제…와 같은 예제 모달을 연다. 메인테이너(inbox): “툴바의 예제를 클릭하면 드롭다운이었던 것을 예제 선택 모달창으로 바꿔주세요”. 버튼에는 ▾를 붙이지 않는다. 모달 맨 아래의 “툴바에서도 고를 수 있습니다”는 툴바에서 연 모달에 맞지 않아 지우고, 환영 모달에만 “툴바의 “예제”와 도움말 › 예제…로 다시 열 수 있습니다”를 둔다(Claude가 정함). 예제 하나를 바로 여는 명령(example.<id>)은 커맨드 팔레트에 그대로 있다
13. 그 밖의 작은 결정 (2026-11-01)
ND1. 맨 아래에서 아래로
정함 (2026-11-01): ↓로 더 내려갈 곳이 없으면 담은 블록을 선택한다. 메인테이너: “포커스를 마지막 아래로 이동하려고 하면 부모블록을 포커스하도록 해주세요.” 그 전에는 움직이지 않았다. 만든 뒤 메인테이너가 확인했다: “맨 아래의 While 안 마지막 블록에서 ↓를 누르면 While이 선택 ← 이게 좋습니다.” 맨 바깥 줄의 마지막 블록에서는 그대로이고, 담은 블록에서 ↓는 다시 안으로 들어가므로 맨 아래에서는 둘을 오간다(Claude가 정함, 확인 전) → 키보드로 이동하고 삽입하기
14. 2026-11-02의 결정
K3. 두 키 조합의 안내 자리 (다시)
2026-11-19에 KA1로 가로 위치가 바뀌었다(선택의 왼쪽 끝에서 최대 24px 안쪽).
정함 (2026-11-02): 1. 선택 바로 아래에 세로 목록. 메인테이너가 MVP를 써 보니 화면 아래의 안내(K1)는 “시선을 위아래로 크게 움직이는 부분이 불편”했다. 이어서: “a처럼 복합키는 모두 이런 식으로 해주세요.” 키보드로 연 컨텍스트 메뉴와 같은 자리(선택의 왼쪽 아래 모서리)에 띄우고, 아래에 자리가 모자라면 선택의 위로 뒤집으며, 창 밖으로 나가지 않게 밀어 넣는다. 선택한 것이 없으면 캔버스의 왼쪽 위다. 0.4초 기다림과 끄는 설정은 그대로다. 견준 안(가로 한 줄, 오른쪽 옆, 지금처럼 화면 아래) → 시안 M52(https://claude.ai/artifact/QUoafRaWBjmuKg6vhp2jZA, journal/assets/2026-11-02-key-hint-study.html). 지금의 규칙 → 03-keymap
15. 2026-11-03의 결정
TB1. 툴바에 For를 두지 않는다
정함 (2026-11-03): For의 툴바 아이콘을 뺀다. 메인테이너: “툴바에서 While과 For가 혼란스럽네요. 우리가 검토했던 것은 흐릿하게 기억이 나기는 하는데 나도 혼란스러우면 사용자는 많이 혼란스러울 것 같아요. For가 꼭 필요하다면 툴바에서라도 뺍시다.” For는 While과 모양이 같고 헤더의 글로만 구분하므로(FB1) 아이콘도 같았다. For 블록 자체는 MVP의 블록(R-BLK-06)이라 남기고, 넣기와 감싸기는 키(a f, s f), 다이어그램 › 삽입, 컨텍스트 메뉴, 커맨드 팔레트, 툴바의 “감싸기 ▾“로 한다.
KP1. 처리 블록도 a + 종류 글자로
정함 (2026-11-03): a p를 o와 같은 키로 더한다. 메인테이너: “ap를 단축키에 추가해주세요. o와 동일하게 처리블록이 추가됩니다.” 다른 블록을 a + 종류 글자로 넣으므로 처리 블록도 같은 방식으로 넣을 수 있게 했다. 같은 날 메인테이너: “a에는 p가 있는데 A에는 없습니다.” 그래서 A p(= O)도 더했다. 감싸기의 s p는 두지 않는다(처리 블록은 다른 블록을 담지 않는다). 지금의 키 → 03-keymap
KP2. 빈 블록에서도 o · O는 삽입
정함 (2026-11-03): 빈 블록을 선택하고 o · O(a p · A p)를 누르면, 빈 블록에 적지 않고 다른 블록처럼 뒤 · 앞에 새 처리 블록을 넣는다. 메인테이너: “빈 처리블록에서 O하면 앞에 블록이 삽입되지 않고 포커스 블록 편집이 됩니다.” 2026-10-10에 넣을 위치 모드(뒤 · 앞 · 안쪽)를 없애며 “빈 블록은 그 자리”로 정했는데(2026-10-10-04-prototype-feedback), 왜 그렇게 했는지 묻고 나서 메인테이너: “oO는 편집이 아니라 삽입으로 해주세요.” 제어 블록(a i 등)과 끌어 놓기는 그대로 빈 블록을 그 블록으로 바꾼다. Case의 빈 default 칸(∅, 아직 블록이 없는 자리)에서는 default 분기를 만들고 그 안에 블록 하나만 생긴다. 빈 갈래(∅)에 적으려면 Enter · i나 더블클릭으로 편집한다. 툴바의 처리 블록 아이콘을 누르는 것도 같은 명령이라 같다. 지금의 규칙 → 키보드로 이동하고 삽입하기
CF1. 캔버스에는 포커스 테두리를 그리지 않는다
정함 (2026-11-03): 선택한 것이 없을 때 캔버스 안쪽에 그리던 2px 포커스 테두리(ui.accent)를 없앤다. 메인테이너: “포커스가 사라지면 전체 캔버스가 굵게 셀렉트되는데, 내 기억이 이렇게 캔버스가 셀렉트 되지 않게 하기로 한 것 같아요.” 2026-10-10에 “캔버스에 들어오면 첫 블록을 고른다(캔버스 포커스 선 대신)“로 정했으나, 2026-10-16 시각 디자인에서 WCAG 2.4.7(포커스가 보여야 함)을 따라 다시 들어왔고(2026-10-16-01-visual-design), “열면 고른 것이 없다”(OP1) 뒤로 자주 보였다. Claude는 1px로 줄이기를 추천했고 메인테이너는 없애기를 골랐다. 선택한 것이 없는 동안에는 키가 캔버스로 가는지 화면으로 알 수 없다(WCAG 2.4.7에 모자람). 이동 키를 누르면 첫 블록이 선택되어 그 테두리가 보인다. 같은 날 CF2로 바꿨다.
CF2. 캔버스의 포커스는 잠깐 보인다
정함 (2026-11-03): 선택한 것이 없을 때 캔버스의 포커스 테두리를 1초만 보인다. 캔버스에 포커스가 올 때, 캔버스의 빈 곳을 클릭할 때, 아무 일도 하지 않은 키를 누를 때다. 환경 설정 “캔버스 포커스 테두리 늘 보이기”(기본은 꺼짐)를 켜면 늘 보인다. CF1로 테두리를 없앤 뒤, Claude가 “선택한 것이 없는 동안에는 키가 어디로 가는지 알 수 없다”고 알렸고 메인테이너: “대안을 제안해주세요. 나는 사용자가 다이어그램을 검토하면서 다이어그램 자체에 집중할 수 있게 하고 싶었습니다.” Claude가 시안 M53(https://claude.ai/artifact/BrHSHnwUmVXn9MuG4hYSni, 사본 journal/assets/2026-11-03-canvas-focus-study.html)에 다섯 안을 그렸고 1번(키보드로 들어오면 첫 블록 선택)을 추천했다. 메인테이너: “4번 1초 뒤 사라짐으로 하고, 캔버스에 포커스 있는 동안 의미 없는 키보드 입력이 있을 때마다 1초간 테두리 하면 어떨까요?” 이어서 “아 마우스 클릭도요”. 잠깐만 보이는 표시는 WCAG 2.4.7을 채우지 못한다고 Claude가 짚고 늘 보이기 설정을 추천해 메인테이너가 골랐다. “아무 일도 하지 않은 키”는 누른 뒤에도 선택한 것이 없고 편집도 두 키 대기도 아닌 키다(Claude). 지금의 규칙 → 키보드로 이동하고 삽입하기, 7.1 상태 표
K4. 클릭하면 기다리던 키를 버린다
정함 (2026-11-03): a · s 같은 첫 키를 누르고 기다리는 동안 캔버스를 클릭하거나 캔버스 밖을 누르면, 기다리던 키와 키 힌트를 버린다. 메인테이너: “a 메뉴나왔을 때 빈 공간을 클릭하면 메뉴가 사라져야합니다”. 결함으로도 적었다 → defects의 BUG-08
CM1. 빈 캔버스의 컨텍스트 메뉴
정함 (2026-11-03): 빈 캔버스를 오른쪽 클릭하면 파일 메뉴와 도움말 메뉴의 명령을 보인다. 메인테이너: “빈 캔버스에서 마우스 우클릭하면 메뉴로 파일 메뉴와 도움말 메뉴를 보여주세요.” 전에는 선택만 풀고 메뉴를 열지 않았다. 하위 메뉴로 묶지 않고 메뉴 바와 같은 차례로 한 목록에 두며, 두 메뉴 사이는 구분선이다(Claude). 키보드(Shift+F10)로는 선택한 것이 없을 때 지금처럼 열리지 않는다. 지금의 규칙 → 컨텍스트 메뉴
US1. 저장하지 않은 새 문서를 두고 다른 문서를 열 때
정함 (2026-11-03): 한 번도 저장하지 않은 새 문서가 저장 안 된 채로 있을 때, 예제 · 새 문서 · 다른 파일을 열기 전에 묻는다(저장 · 버리고 열기 · 취소). 파일로 연 문서는 지금처럼 묻지 않는다. 웹은 임시 보관이 있어 묻지 않기로 했으나, 임시 보관은 문서마다 남고 페이지를 다시 열 때는 가장 최근의 것 하나만 복원을 묻는다. 파일로 연 문서는 그 파일을 다시 열면 복원을 묻지만, 저장하지 않은 새 문서는 다른 문서를 열어 고친 뒤에는 다시 꺼낼 길이 없다(Claude가 코드에서 확인). 고르는 창의 세 안(새 문서일 때만 묻기, 언제나 묻기, 묻지 않고 최근 파일에 남기기) 가운데 메인테이너가 추천안을 골랐다. 예제 모달의 문구도 “파일로 연 문서는 그 파일을 다시 열면 복원할 수 있습니다”로 바꾼다.
XM1. 새 Method의 자리
정함 (2026-11-03): 새 Method로 빼기(R-EDIT-19)로 만든 Method는 뺀 블록이 있던 Method 바로 뒤에 둔다. Event나 헤더 없는 다이어그램에서 뺐으면 Method 무리의 맨 뒤다. “새 다이어그램은 그 종류의 맨 뒤”의 예외다. 견준 것: 언제나 Method 무리의 맨 뒤(지금까지), 뺀 다이어그램 바로 뒤. 이것으로 6절의 “새 Method가 맨 뒤에 생기고 화면이 그리로 가는 것”에 답했다(XM2와 함께). → 시안 M54(https://claude.ai/artifact/J11wWw9DVKUZkUP2ubT94n, 사본 journal/assets/2026-11-03-extract-method-study.html, 만드는 스크립트 …-build.py · …-figs.test.ts)
XM2. 빼고 난 뒤의 선택과 화면
정함 (2026-11-03): 새 Method의 이름을 적고 Enter를 누르면, 그 자리에 남은 호출 블록이 선택되고 화면이 그리로 돌아온다. 견준 것: 새 Method의 헤더를 선택한 채 그 자리에 머묾, 새 Method의 첫 블록 선택. → 시안 M54(https://claude.ai/artifact/J11wWw9DVKUZkUP2ubT94n, 사본 journal/assets/2026-11-03-extract-method-study.html, 만드는 스크립트 …-build.py · …-figs.test.ts)
XM3. 헤더 없는 다이어그램에서 블록에 m은 고르는 목록
정함 (2026-11-03): 헤더 없는 다이어그램에서 블록을 선택하고 m을 누르면 키 힌트 자리(선택 바로 아래, K3)에 작은 목록 “1 새 Method로 빼기 · 2 Method 헤더 달기”를 띄운다. Enter나 1은 빼기, 2는 Method 헤더 달기, Esc는 그만두기. 헤더가 있는 다이어그램에서는 m이 바로 빼기다. e는 그대로 Event 헤더 달기다. Method 헤더 달기는 메뉴 · 컨텍스트 메뉴 · 커맨드 팔레트에도 둔다. 시안 M54 EX3의 3번(둘 가운데 고르게 묻는다). 같은 날 처음에는 1번(어디서나 빼기)으로 정했다가 메인테이너가 3번으로 바꿈. 견준 것: 블록에서 m은 어디서나 빼기(1번, Claude의 추천), 헤더 없는 다이어그램에서는 m이 Method 헤더 달기(지금대로, 2번)이고 빼기는 메뉴로만. → 시안 M54(https://claude.ai/artifact/J11wWw9DVKUZkUP2ubT94n, 사본 journal/assets/2026-11-03-extract-method-study.html, 만드는 스크립트 …-build.py · …-figs.test.ts)
- 만들며 에이전트가 정한 것(커밋
5f543b4, 메인테이너의 확인을 받지 않음): 빼기는 따로의 명령diagram.extractMethod이고m은 선택에 따라(헤더면 Method로 바꾸기, 그 밖엔 빼기). 헤더가 있는 다이어그램의 블록에서 “Method 헤더 달기”는 흐리게(“이 다이어그램에는 이미 헤더가 있습니다…”). 접기 영역 경계 알림은 첫 알림에만. 접기 영역 이름은 다듬고 줄바꿈은 공백(비거나 겹치면Method n). 선택이 접기 영역과 꼭 같으면 그 영역은 호출 블록을 감싼 채 남음(영역 자체를 선택했을 때만 없어짐). 빈 이름을 적으면 빈 이름 거절 · 기본 이름 · 호출 블록 선택. 목록에서 2(Method 헤더 달기 후 이름)는 실행 취소 두 단계. 목록의 제목은 “Method”.
BS1. 브라우저 안의 문서는 열기 · 저장 창 안에서 고른다
정함 (2026-11-03): 브라우저 안의 문서(R-WEB-09)는 따로 된 메뉴 항목을 두지 않는다. 열기… 와 다른 이름으로 저장… 이 먼저 앱의 창을 띄우고, 거기서 “이 컴퓨터의 파일 / 이 브라우저”를 고른다(SequenceDiagram.org · draw.io의 방식). 창은 그 브라우저에서 마지막에 고른 쪽으로 열린다(처음에는 이 컴퓨터의 파일). 이 컴퓨터의 파일에서는 한 번 더 누르면 운영체제의 창이 열린다. 메인테이너가 Claude의 추천(파일 메뉴에 “브라우저에 저장…” · “브라우저의 문서…” 두 항목)이 아닌 2번을 골랐다. 시안이 적은 2번의 좋은 점: 저장소가 늘어도(Google Drive) 메뉴는 그대로다. 견준 것: 파일 메뉴에 두 항목(추천), 최근 파일에 섞기. 메뉴 이름과 US1 모달의 버튼은 구현 때 이에 맞춘다. → 시안 M55(https://claude.ai/artifact/CLz2Y1yXLYJfdn6q27Y1PV, 사본 journal/assets/2026-11-03-browser-storage-study.html)
BS2. 브라우저가 그 문서의 자리
정함 (2026-11-03): 브라우저에 둔 문서는 “원래 파일”의 한 종류다. Ctrl+S와 자동 저장은 그 브라우저 문서에 쓰고(쓰기 권한이 필요 없어 모든 브라우저에서), 이름 옆에 “브라우저” 딱지를 단다. 다른 이름으로 저장… 으로 파일로 옮길 수 있다. Claude의 추천안. 견준 것: 그때의 사본만 남기기(Ctrl+S는 언제나 파일), 1번에 더해 새 문서의 기본 저장소 설정. → 시안 M55(https://claude.ai/artifact/CLz2Y1yXLYJfdn6q27Y1PV, 사본 journal/assets/2026-11-03-browser-storage-study.html)
BS3. 브라우저의 문서 목록
정함 (2026-11-03): 목록은 표(이름 · 고친 때 · 크기)이고 고친 때 최신순이다. 버튼은 열기 · 이름 바꾸기 · 파일로 내보내기 · 삭제. 버튼 이름은 용어집대로 “삭제”다(시안의 “지우기”가 아님). Claude의 추천안. 견준 것: 카드와 썸네일, 1번에 더해 체크박스로 여러 개. → 시안 M55(https://claude.ai/artifact/CLz2Y1yXLYJfdn6q27Y1PV, 사본 journal/assets/2026-11-03-browser-storage-study.html)
BS4. 함께 지워진다는 경고와 백업
정함 (2026-11-03): 저장 창과 목록에 “브라우저의 사이트 데이터를 지우면 함께 지워진다”는 경고 한 줄을 늘 둔다. 목록에는 모두 파일로 내보내기(.zip)와 파일에서 가져오기… 를 둔다. Claude의 추천안. 견준 것: 처음 저장할 때 한 번 알리고 한 문서씩 내보내기, 1번에 더해 30일 동안 내보내지 않으면 다시 알림. → 시안 M55(https://claude.ai/artifact/CLz2Y1yXLYJfdn6q27Y1PV, 사본 journal/assets/2026-11-03-browser-storage-study.html)
2026-11-03 블록 텍스트의 언어 · 구문 강조 (밤사이 에이전트가 만듦, 메인테이너가 추천안을 받아들임)
메인테이너가 2026-11-03에 “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다.”라고 했다. 아래는 Claude가 추천안대로 구현한 것이다. 시안으로 묻지 않았다.
TK1. 처음의 언어 목록
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 일반 텍스트 · C · C++ · Java · JavaScript · TypeScript · Python · Bash의 일곱이다(JavaScript와 TypeScript는 한 항목). 이 차례로 보이고, 일반 텍스트가 맨 앞이자 기본이다. 요구사항의 예(C · Java · Python · Bash)에 설계 문서에서 흔히 쓰는 C++와 JavaScript · TypeScript를 더했다. 견준 것: 요구사항의 예 넷만, 더 많은 언어(C# · Go · Rust · Kotlin · SQL). 언어 하나는 렉서의 표 한 줄이라 뒤에 더하기 쉽고, 더해도 파일 형식의 버전은 그대로다 → 3.1 구문 강조, 3.3 노드별 필드
TK2. 문서 설정의 자리와 이름
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 문서 설정의 맨 위, 그림 문구의 언어 바로 앞에 “블록 텍스트의 언어”(영어 화면 “Block text language”)를 두고, 그 아래 흐린 한 줄로 “구문 강조”(“Syntax highlighting”)라고 적는다. 바꾸면 실행 취소의 대상이다. 새 문서는 언제나 일반 텍스트로 시작한다. 흐린 한 줄은 그림 문구의 언어(ADR-0041)의 모습을 따랐다. 헤더 모양(HS1)과 달리 마지막에 고른 언어를 기억하지 않는다. 예제 · 다른 사람의 파일처럼 언어가 정해진 문서와 섞여, 새 문서가 어느 언어로 시작할지 예측하기 어려워서다. 견준 것: 마지막에 고른 언어를 기억, 환경 설정에 “새 문서의 언어” → 05-screen-layout
TK3. 언어를 바꿔도 글꼴과 자리는 그대로
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 일반 텍스트를 포함한 모든 언어를 기본 블록 글꼴(D2Coding)로 그린다. 언어를 바꾸면 그림의 색만 바뀌고 블록은 한 픽셀도 움직이지 않는다. 시각 디자인 명세의 지난 판은 “일반 텍스트면 비례폭”이었으나, 그러면 MVP로 저장한 파일(모두 일반 텍스트)이 다시 배치되고, 한글을 갖춘 비례폭 글꼴을 골라 번들해야 한다. 견준 것: 일반 텍스트는 비례폭, 비례폭을 새 값으로 따로 → ADR-0042
SY1. 칠하는 텍스트
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 처리 블록의 텍스트와 반복 · If · Case의 조건 칸만 칠한다. 헤더의 이름(Event · Method), 분기 라벨, 호출 블록(Method 이름 · 인자 · 결과)은 칠하지 않는다. 헤더와 호출은 이름이고 “제목처럼” 머리 · 호출 블록은 이미 굵기로 이름을 보이므로, 색을 더하면 두 표시가 겹친다. 분기 라벨은 시각 디자인 3.3의 규칙대로 구조의 텍스트라 칠하지 않는다. 펴 보인 블록의 텍스트는 다른 블록과 같게 칠한다(2026-11-18에 바뀜 → Q15-a). 견준 것: 호출 블록의 인자와 결과도 칠함 → 3.1 구문 강조
SY2. 조각에서의 규칙
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 블록 하나의 텍스트가 강조의 단위다. 블록 주석은 그 블록 안에서 여러 줄에 걸치지만 다음 블록으로 이어지지 않는다. 닫지 않은 문자열은 그 줄의 끝까지, 닫지 않은 블록 주석은 그 블록의 끝까지 칠한다. 블록의 텍스트는 코드 한 조각이라 앞뒤 블록과 이어 읽으면, 한 블록의 실수(닫지 않은 따옴표)가 다이어그램 전체의 색을 바꾼다. Python의 //(나눗셈)와 Bash의 ${#a}는 주석이 아니다(프로토타입이 //를 Python에서도 C의 주석으로 칠했던 것을 바로잡음) → 3.1 구문 강조
2026-11-03 공유 URL · 보기 모드 (밤사이 에이전트가 만듦, 메인테이너가 추천안을 받아들임)
메인테이너(2026-11-03): “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다.” 아래는 공유 URL(R-WEB-05)과 보기 모드(R-WEB-06)를 만들며 Claude가 고른 안이다. 지금의 규칙 → 3. 공유 URL과 보기 모드, 보기 모드, 공유 링크
SH1. 링크의 자리와 담는 것
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 링크는 URL의 fragment(#ns1.d.…)에 문서의 이름과 모델 JSON 전체(뷰 상태 포함)를 deflate-raw로 압축해 base64url로 담는다. 그림과 글꼴은 담지 않는다. fragment는 서버로 가지 않아 정적 사이트에서 로그 · 리퍼러로 새지 않는다. 압축은 브라우저 내장(CompressionStream)이라 번들이 커지지 않는다. 견준 것: query(?doc=), LZ-string · fflate, 압축 없음. 구조의 결정 → ADR-0043
SH2. 긴 링크
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 8 KB까지는 조용히 복사하고, 8 KB를 넘으면 복사하되 “긴 링크를 자르는 앱이 있어 파일로 공유하는 것을 추천합니다”를 warn으로 알리고, 1 MB를 넘으면 복사하지 않고 파일로 공유하라고 알린다. 클립보드가 거절하면 링크를 모달에 넣어 손으로 복사하게 한다. 8 KB는 메신저 · 메일 · 이슈 트래커가 링크를 자르기 시작하는 길이보다 넉넉히 짧고, 블록 150개쯤의 다이어그램이 든다. 막지 않고 알린다(01-ux-overview의 원칙). 견준 것: 2 KB(옛 IE의 한도, 너무 일찍 경고), 경고 없이 늘 복사.
SH3. 보기 모드의 모습
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 메뉴 바 · 툴바 · 상태 표시줄 대신 한 줄의 막대(제품 이름 · 문서 이름 · 알림 · “보기 모드” · 파란 “편집하기” 버튼)만 둔다. 확대 · 스크롤 · 선택 이동 · 접기 · 펴기는 되고, 편집 키는 이유를 알리며, 컨텍스트 메뉴는 열지 않는다. SequenceDiagram.org의 보기 모드처럼 그림이 화면을 다 쓰되, 알림이 보일 자리와 “이것이 무엇인지”(제품 이름)를 남긴다. 견준 것: 막대 없이 떠 있는 버튼 하나(알림을 보일 곳이 없음), 툴바만 숨기기(편집 화면과 다르지 않음).
SH4. 편집하기
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): “편집하기”는 같은 문서를 다시 열지 않고 읽기 전용만 푼다. 그 문서는 한 번도 저장하지 않은 새 문서(이름은 링크의 이름)라 US1을 따른다. 보기 모드가 끝나면 주소창의 링크를 지워, 새로 고치면 링크가 아니라 로컬 백업을 복원한다. 견준 것: 링크를 주소창에 남김(새로 고치면 편집한 것이 링크의 원본으로 되돌아간 듯 보임), 편집하기를 누르면 바로 저장 창.
SH5. 링크를 열 때
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 공유 링크로 연 페이지는 처음 온 사람의 예제 모달을 띄우지 않고, 로컬 백업의 “복원할까요?”도 묻지 않는다(백업은 남겨 다음에 묻는다). 열 수 없는 링크는 까닭(손상 · 너무 큼 · 더 새 버전 · 이 브라우저가 풀 수 없음)을 알리고 평소처럼 시작한다. 열린 탭에 붙여 넣은 링크도 열되, 저장하지 않은 새 문서는 US1대로 먼저 묻는다. 링크를 누른 사람은 그 그림을 보러 왔다.
SH6. 메뉴의 자리
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 파일 메뉴의 내보내기 바로 아래 “공유 링크 복사”(영어 “Copy Share Link”) 하나만 두고, 키와 툴바 버튼은 두지 않는다. 자주 쓰는 명령이 아니고, 커맨드 팔레트로도 찾는다. 견준 것: 툴바 버튼, 내보내기 ▸ 안의 항목(내보내기는 파일을 만드는 것이라 다름).
2026-11-03 테마 · 고대비 (밤사이 에이전트가 만듦, 메인테이너가 추천안을 받아들임)
메인테이너(2026-11-03): “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다.” 아래는 테마(R-LAY-08)와 고대비 화면(R-NFR-07)을 구현하며 Claude가 추천안으로 정한 것이다. 시안 없이 구현으로 바로 갔으므로, 써 보고 바꿀 수 있다.
TM1. 테마는 넷 (밝은 · 어두운 · 고대비 · 흑백 인쇄)
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 테마는 밝은 테마(default) · 어두운 테마(dark) · 고대비(high-contrast) · 흑백 인쇄(print)의 넷이고, 문서 설정에 이 차례로 나온다. 영어 화면의 이름은 Light · Dark · High contrast · Black and white print. 어두운 테마는 M17 테마 시안의 초안을 바탕으로 밝은 테마와 같은 색상을 어두운 종이에 옮기고, 텍스트 4.5:1 · 선 3:1을 맞췄다. 고대비는 검은 종이에 흰 선과 흰 글자이고 텍스트와 선이 모두 7:1이다. 고대비를 어두운 쪽으로 한 것은 Windows 대비 테마의 관례(검은 바탕)를 따르고, 흰 종이에 검정은 흑백 인쇄(21:1)가 이미 맡기 때문이다. 밝은 테마의 파일 이름은 이미 저장된 파일과 맞도록 default 그대로 둔다. 견준 것: 밝은 · 어두운 둘만(고대비와 흑백 인쇄는 뒤로), 흰 종이의 고대비(흑백 인쇄와 거의 같아짐). 값 → 8. 테마
TM2. 테마는 문서 설정의 한 줄
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 테마는 다이어그램 › 문서 설정… 모달의 마지막 줄 “테마”(Theme)에서 고른다. 고르는 칸은 다른 줄과 같은 드롭다운이고, 이름 아래에 흐린 한 줄 “그림의 색. 저장되는 그림도 이 색”(The colors of the drawing, saved with it)을 둔다. 고르면 모달을 닫지 않아도 그림이 바로 바뀐다. 시각 디자인의 미결정 “테마를 선택하는 자리”의 답. 견준 것: 보기 메뉴의 하위 메뉴(파일에 저장되는 것이 보기 메뉴에 섞임), 툴바의 테마 버튼(자주 바꾸지 않는 것에 자리를 씀), 미리 보기 그림이 있는 카드(넷뿐이라 드롭다운으로 충분). → 05-screen-layout
TM3. 테마를 바꾸는 것은 실행 취소의 대상
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 테마는 문서 설정이라 바꾸면 실행 취소의 대상이고 저장하지 않은 표시가 붙는다. 저장되는 그림, PNG, 인쇄는 고른 테마의 색 그대로다. 다른 문서 설정(헤더 모양 · 그림 문구의 언어)과 같다(Q9). 읽기 전용에서는 바꿀 수 없다.
TM4. 편집 레이어는 종이의 종류를 따른다
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 선택 · 호버 · 드롭 위치 · 오류 표시와 인라인 에디터의 색은 화면 색이 아니라 테마의 종류(종이가 밝은가 어두운가)를 따른다. 어두운 종이(어두운 테마 · 고대비)에는 더 밝은 주황 #f08a4b과 빨강 #ff7b72, 인라인 에디터는 그 테마의 종이 색 바탕에 text.primary 글자다. 편집 레이어는 종이 위에 그려지므로, 화면 색을 따르면 밝은 화면의 어두운 종이에서 선택이 묻힌다. 네 테마 모두에서 편집 레이어의 표시가 3:1을 넘는다. 견준 것: 테마마다 편집 레이어 색을 따로(넷뿐이라 둘로 충분), 늘 같은 주황(어두운 종이 위 대비는 넘지만 인라인 에디터가 흰 칸으로 튐). → 3.4 화면 색
TM5. 고대비는 화면 색과 테마로 나눈다
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 운영체제가 더 높은 대비를 요청하면(prefers-contrast: more) 편집 화면은 고대비 화면 색(텍스트 7:1)으로 바뀐다. 그림은 문서의 테마로 고대비를 고르고, 운영체제의 설정이 문서의 테마를 바꾸지는 않는다. 화면에서만 그림을 고대비로 보는 “보기 전용” 선택은 지금 두지 않는다. 전에 시각 디자인 8장은 “그림은 흑백 인쇄 팔레트를 화면에서도 선택할 수 있게 하고, 화면에서만 바꾸는 보기 전용 선택을 따로 둔다”고 적었다. 보기 전용 선택은 화면의 그림과 저장되는 그림을 다르게 그려야 해서 화면 그대로 저장(ADR-0018)과 한 렌더러(ADR-0030)에 예외를 만든다. 그래서 먼저 문서의 테마로 고대비를 두고, 보기 전용은 필요가 보이면 정하도록 미결정으로 남겼다(12. 미결정 사항). 편집 화면의 밝은 · 어두운 화면 색은 이미 기기의 밝기(prefers-color-scheme)를 따르므로 바꾸지 않았다. 견준 것: 운영체제가 고대비를 요청하면 그림도 화면에서 고대비로(보기 전용), 고대비 화면 색만 두고 그림의 고대비는 흑백 인쇄로.
2026-11-03 내보내기 · 파일 검사 (밤사이 에이전트가 만듦, 메인테이너가 추천안을 받아들임)
메인테이너: “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다.” 아래는 Claude가 추천안으로 정하고 구현한 것이다. 시안 없이 정했으므로 써 보고 바꿀 수 있다. 구조의 선택(PDF 작성기, 외곽선, 그림 지문)은 ADR-0045에 있다.
XS1. 순수 SVG는 저장 파일에서 모델만 뺀 것
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 파일 › 내보내기 ▸ “SVG로 내보내기(그림만)…”는 저장 파일에서 <metadata>(모델)만 뺀 SVG를 이름.svg로 저장한다. 그림 · 서브셋 글꼴 · 종이 · 클래스 이름은 그대로 둔다. 견준 것: 글꼴도 빼고 대체 글꼴에 맡기기(어디서나 같게 보이지 않음), 늘 외곽선으로(파일이 커지고, 외곽선은 문서 설정 OL1이 이미 맡음). 문서가 외곽선 설정을 켰으면 순수 SVG도 외곽선이다. 이름에 “(그림만)“을 붙여 저장 파일(.ns.svg도 SVG)과 헷갈리지 않게 했다. 지금의 규칙 → 1.4 SVG 내보내기 (그림만), 4.2 순수 SVG
PD1. PDF는 앱이 바로 만든다
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 파일 › 내보내기 ▸ “PDF로 내보내기…”는 앱 안에서 벡터 PDF를 만들어 이름.pdf로 저장한다(인쇄 창을 거치지 않음). 텍스트는 번들 글꼴의 외곽선이라 선택 · 검색은 되지 않고, 번들 글꼴에 없는 문자는 빈 상자다. 견준 것: 브라우저의 “PDF로 저장”에 맡기기(명령이 아니라 인쇄 창의 한 선택이 되고 브라우저마다 다름), PDF 라이브러리(번들에 수백 KB). 한자 · 이모지가 든 문서는 인쇄(PT1)에서 “PDF로 저장”을 쓰면 대체 글꼴로 나온다(사용법에 적음). 지금의 규칙 → 1.5 PDF 내보내기
PD2. 종이와 방향은 묻지 않는다
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): PDF와 인쇄의 종이는 브라우저 언어의 지역으로 고른다: Letter를 쓰는 지역(미국 · 캐나다 · 멕시코 등, CLDR)은 Letter, 그 밖은 A4. 방향은 세로와 가로 가운데 페이지가 적게 나오는 쪽(같으면 세로). 여백은 네 쪽 36pt(12.7mm). 정하는 창은 두지 않는다. 견준 것: 내보낼 때마다 묻는 창(한 번 더 누름), 환경 설정에 종이 크기(써 보고 필요하면 더함). 지금의 규칙 → 5. 인쇄와 PDF의 페이지
PD3. 줄이지 않고 블록 사이에서 자른다
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 그림을 줄이지 않고(1px = 0.75pt) 여러 페이지로 나눈다. 텍스트가 든 칸(처리 · 호출 블록, 제어 블록의 헤더, 다이어그램의 헤더)을 가로지르지 않는 가장 먼 경계에서 자르고, 그런 경계가 없으면 페이지 끝에서 자른다. 폭이 넘치면 열로 나누고 아래로 먼저 읽는다. 종이만 있는 페이지는 뺀다. 페이지가 둘 이상이면 아래 가운데에 “n / N”을 적는다. 견준 것: 페이지 폭에 맞춰 줄이기(가장 작은 글자 9pt · 가장 가는 선 0.75pt를 지키지 못함 → 9.2 배율과 출력), 쪽 번호를 늘 적기(한 장짜리에는 군더더기). 지금의 규칙 → 5. 인쇄와 PDF의 페이지
PT1. 인쇄는 인쇄 전용 보기로
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 파일 › 인쇄…와 Ctrl+P는 PDF와 같은 페이지를 인쇄 전용 보기에 넣고 브라우저의 인쇄 창을 연다. 브라우저의 메뉴로 인쇄해도 같은 보기가 인쇄된다(편집 화면이 인쇄되지 않음). 브라우저가 Ctrl+P를 이미 인쇄로 쓰므로 같은 키를 둔다. 지금의 규칙 → 1.6 인쇄, 03-keymap
DC1. 다른 도구로 고친 그림은 열 때 상태 표시줄에 경고
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 그림 부분이 앱이 저장한 것과 다르면(그림 지문이 다름), 파일을 열고 상태 표시줄에 경고한다: ”“{이름}”의 그림이 다른 도구로 고쳐져 모델과 다를 수 있습니다. 편집기는 모델을 보여 줍니다. 저장하면 그림을 모델로 다시 그리므로, 그림에서만 고친 것은 사라집니다.” 파일은 열고, 문서는 저장 안 됨이 되지 않는다. 견준 것: 여는 것을 묻는 모달(열지 않을 까닭이 없음: 원본은 저장해야 바뀜), 열 때 모델로 다시 그려 비교(렌더러가 바뀐 판에서 옛 파일을 모두 “고쳐짐”이라 함 → ADR-0045). 지문이 없는 파일(이 기능 전에 저장)은 확인하지 않는다. 지금의 규칙 → 4.1 그림 지문, 6. 셸과의 연결
OL1. 텍스트 외곽선은 문서 설정
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 다이어그램 › 문서 설정에 “텍스트를 외곽선으로 저장”(기본은 끔)을 둔다. 켜면 저장 파일과 순수 SVG의 텍스트가 번들 글꼴의 외곽선이 되고, 화면은 그대로 텍스트로 그린다. 번들 글꼴에 없는 문자가 든 줄은 텍스트로 남는다. 견준 것: 환경 설정(사람마다 파일이 달라짐 → ADR-0041과 같은 까닭), 내보내기에만 두기(R-FMT-10은 저장의 옵션). 문서 설정이라 파일과 함께 가고 undo 대상이다. 굵은 글자는 화면의 합성 굵게와 같은 두께로 그린다. 지금의 규칙 → 4.3 텍스트 외곽선, 3. SVG 렌더링
2026-11-03 접기 · 호출 블록 (밤사이 에이전트가 만듦, 메인테이너가 추천안을 받아들임)
접기(R-EDIT-13, R-EDIT-14, R-EDIT-23, R-FMT-11)와 호출 블록(R-EDIT-15, R-EDIT-16, R-EDIT-08, R-BLK-08)을 만들면서 Claude가 정한 것이다. FD는 접기, CB3부터는 호출 블록이다(CB1 · CB2는 4.3). 메인테이너(2026-11-03): “모두 지금 개발해주세요. 나의 선택이 필요한 부분은 일단 달님의 추천안을 수용하겠습니다.” 그래서 시안 없이 지금의 규칙 · UX 결정 · 흔한 편집기의 관례에 가장 맞는 안을 골랐고, 메인테이너가 써 보고 다시 정한다.
FD1. 접기 · 펴기가 적용되는 곳 (Q20)
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 선택한 것이 접을 수 있는 것이면 그것에, 아니면 그것을 담는 가장 가까운 접을 수 있는 것에 적용된다. 2026-10-11 M09의 Q20 추천 1이다. 제어 블록의 안쪽은 이름 없는 접기 영역처럼 보고, “블록이 하나뿐이면 접지 않는다”는 처리 블록이나 호출 블록 하나일 때만 남긴다(제어 블록 하나뿐인 분기는 접는다). 그 전의 규칙(“선택한 것을 온전히 담는 가장 작은 접기 영역”)은 깊은 곳의 블록을 선택하고 접으면 먼 바깥의 접기 영역이 접혔고, 큰 If 하나만 든 반복문은 접을 수 없었다. 지금의 규칙 → 접기 · 펼치기
FD2. 기본 이름을 고른 접기 영역
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 만들 때 아무것도 적지 않으면 그 접기 영역은 이름 없이 저장하고, 다시 묻지 않는다. 기본 이름(“첫 블록의 텍스트 외 n개”)은 블록을 따라 바뀐다. 이름은 만들 때만 묻기로 했으므로(2026-10-13) 프로토타입처럼 “이미 물어봤음”을 따로 저장하지 않아도 된다. 2026-10-10 프로토타입 세션의 질문 2에 답한 것이다 → 만들며 생긴 질문 (메인테이너의 답을 기다림)
FD3. 펼친 뒤에도 보이는 접기 영역
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 펼친 접기 영역은 이름 띠를 켜 둔 동안 늘 테두리와 이름 띠로 보인다. 새 문서는 이름 띠가 켜져 있고, 보기 › 접기 영역 보기로 끈다. 2026-10-13의 Q15와 Q15-c로 이미 그렇게 정해 둔 것을 2026-10-10 프로토타입 세션의 질문 1(“평소에도 보여야 하나?“)의 답으로 확인한 것이다.
FD4. 만들 때 적은 이름은 만들기와 한 단계
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 접기 영역을 만들자마자 접힌 칸에서 적은 이름은 만들기와 실행 취소 한 단계다. 새 Method로 빼기와 바로 이어 적은 이름(XM2)과 같은 방식이다. 나중에 이름을 바꾸는 것은 따로 한 단계다.
FD5. 키보드로 지나가는 접힌 것과 이름 띠
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 접힌 줄과 접힌 칸은 방향키에서 블록 하나다. 펴진 접기 영역의 이름 띠는 분기 라벨(Q10)처럼 한 칸이라, 영역의 첫 블록에서 ↑가 이름 띠에 선다. 이름 띠를 끄면 서지 않는다. 이름 띠에 서야 키보드만으로 접기 영역을 선택해 이름을 바꾸거나 풀 수 있다. 견준 것: 이름 띠에는 서지 않고 마우스로만 선택.
FD6. 분기 라벨에서 접기
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 분기 라벨을 선택하고 접기 · 펴기를 쓰면 그 분기를 접고 편다. FD1의 “선택한 것이 접을 수 있는 것이면 그것에”를 분기 라벨에 적용한 것이다. 미결정이던 “분기 라벨을 선택했을 때의 복사 · 감싸기 · 접기” 가운데 접기만 정했다 → 분기 라벨을 선택했을 때의 복사 · 감싸기
FD7. 접고 편 뒤의 선택
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 접으면 그 자리에 보이는 접힌 줄이나 접힌 칸이 선택된다. 제어 블록을 선택하고 그 안쪽을 접으면 제어 블록이 그대로 선택된다. 펴면 선택한 것이 그대로 남고, 이름 띠를 끈 채 접기 영역을 펴면 그 블록들이 선택된다. 접혀서 보이지 않게 된 블록이 선택된 채로 남지 않게 하려는 것이다(Q19의 “바뀐 것을 선택한다”).
FD8. 이름 띠의 텍스트 자리
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 이름 띠와 펴 보기의 띠에서 텍스트는 왼쪽 끝에서 20px(접힌 칸과 같은 자리)에서 시작한다. 그 앞의 10px(size.band-icon-room)은 편집할 때만 보이는 펼침 삼각형(▾)의 자리다. 접힌 칸의 size.fold-icon-room(20px)과 같은 방식이고, 화면과 파일의 기하가 같으므로 저장되는 그림에도 그 자리가 남는다(ADR-0018). 견준 것: 삼각형을 size.band-text-x(10px) 안에 넣음(텍스트와 1px밖에 떨어지지 않음). → 5. 기하와 해부도
FD9. 접기만 · 펴기만
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): zc(접기만)와 zo(펴기만)는 FD1의 차례에서 펴진 것 · 접힌 것 가운데 가장 가까운 것에 적용되고, 없으면 알린다. Vim에서 zo는 커서를 담은 닫힌 접기를, zc는 열린 접기를 찾는다.
FD10. 접기 영역 풀기 뒤의 선택
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 접기 영역(이름 띠, 접힌 칸)을 선택하고 풀면 그 블록들이 선택되고, 안의 블록을 선택하고 풀면 선택한 것이 그대로 남는다. 상태 표시줄에 푼 접기 영역의 이름을 알린다. 제어 블록 풀기의 선택(Q19: 남은 안의 블록들, 안쪽에서 풀었으면 그대로)과 같은 방식이다.
FD11. 접힌 칸의 펼침 삼각형 자리
정함 (2026-11-19, 메인테이너): 접힌 칸의 펼침 삼각형(▸)은 이름 첫 줄의 가운데(칸 위에서 space.pad-y + space.line / 2 = 16px)에 둔다. 이름이 여러 줄이어도 첫 줄과 나란하다. 이름 띠와 펴 보기 띠의 ▾는 띠의 가운데(9px) 그대로다. 삼각형은 편집 레이어에만 그리므로 저장되는 그림은 바뀌지 않는다. 이름 띠의 식을 접힌 칸에도 써서 삼각형이 이름보다 7px 위에 붙었던 결함을 고치며 정했다 → BUG-17, 5. 기하와 해부도
CB3. 펴 보인 블록의 화면 id
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 펴 보인 호출 블록 안에 그린 것의 화면 id는 호출 블록의 경로를 /로 이은 뒤에 모델의 id를 붙인 문자열이다(b4/b17). 선택에는 화면 id 대신 경로와 모델의 id를 따로 적는다. 레이아웃의 상자와 클릭 영역은 문자열 하나로 찾는 것이 쉽고, 모델의 id에는 /가 없어 섞이지 않는다. 선택을 경로와 id로 두면 복사 · gd가 Method의 블록을 바로 찾는다. 미결정 사항에 있던 물음(“문자열로 이을지, 배열로 둘지”)에 답한 것이다 → 2. 상태와 선택
CB4. 호출 블록의 접기 · 펴기는 펴 보기
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 호출 블록 하나를 선택하고 접기 · 펴기(f za)를 쓰면 그 호출 블록을 펴 보고, 펴 보인 것을 선택하고 다시 쓰면 접는다. 펴 보기를 접기 · 펴기 명령으로 한다는 규칙(R6, 4.1)과 FD1의 “선택한 것이 접을 수 있는 것이면 그것에”를 호출 블록에 적용한 것이다. 같은 문서의 Method를 부르는 호출 블록만 펴진다. 펴 보인 안쪽에서 쓰면 그 자리의 접기 영역, 없으면 담은 펴 보인 호출 블록이 접힌다(2026-10-13).
CB5. 펴 보인 호출 블록 안을 지나가는 키
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 펴 보인 호출 블록은 방향키에서 반복 블록처럼 다룬다. 띠가 한 칸(호출 블록)이고, ↓로 안의 첫 블록에 들어가고 안의 첫 블록에서 ↑로 띠에 돌아온다. 펴진 접기 영역의 이름 띠(FD5)와 같은 방식이라 익힐 것이 없다. 견준 것: 펴 보인 블록은 마우스로만 선택.
CB6. 이름을 적어 호출하기
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 호출할 Method를 고르는 목록의 맨 끝, “새 Method를 만들고 호출” 다음에 “이름을 적어 호출하기”를 둔다. 고르면 이름을 적는 호출 블록을 넣고 바로 이름 칸을 연다. 호출할 Method 바꾸기에서 고르면 지금 보이는 이름이 칸에 든 채로 열린다. 칸 이동(Tab)은 인자 → 결과 → 이름 → 인자로 돈다. 편집은 언제나 인자 칸에서 시작한다는 규칙(호출 블록)을 지키고, 이름은 넣을 때와 바꿀 때만 먼저 연다. 견준 것: 모달로 이름을 묻기(입력을 막는 자리를 늘림, Q14-a와 같은 까닭으로 고르지 않음).
CB7. 이름을 적는 호출 블록의 빈 이름
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 한 번 적은 이름은 비울 수 없다(비우면 편집 전 이름으로 돌아가고 알린다, Q4). 새로 넣고 아무것도 적지 않고 닫으면 이름 없이 남고 “(이름 없음)“이 보인다. 넣자마자 모달 없이 칸을 열기 때문에, 빈 채로 닫는 것을 막지는 않는다. 나중에 이름을 적으면 된다.
CB8. 호출 블록 풀기 뒤의 모습
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 호출 블록을 풀면 들어온 블록들이 선택되고, 펴 보였을 때의 모습 그대로 들어온다: Method에서 접혀 있던 접기 영역 · 분기는 접힌 채로, 이 자리의 접기 영역은 보통 접기 영역이 되어 접힘도 그대로, 안쪽에서 펴 보인 호출 블록은 펴 보인 채로. (2026-11-19부터 “접혀 있던”의 기준은 Method가 아니라 그 호출 블록 자리의 접힘이다 → CB13) 풀기의 선택(Q19: 남은 안의 블록들)과 같고, 보던 모습이 풀기로 바뀌지 않게 하려는 것이다. Method의 접기 영역과 걸치거나 같은 범위인 이 자리의 접기 영역은 펴 보인 곳에서도 그려지지 않던 것이라 버린다.
CB9. 호출하는 Method로 가기
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): gd는 호출 블록에서는 그 Method의 헤더로, 펴 보인 블록에서는 Method의 원래 블록으로, 펴 보인 곳에서 본 Method의 접기 영역에서는 Method의 그 접기 영역으로 간다. 이름을 적는 호출 블록, 참조 대상이 없는 호출 블록에서는 가지 않고 알린다. 다이어그램 메뉴와 컨텍스트 메뉴에도 둔다. Vim의 gd(정의로 가기)와 같은 뜻이다. 다른 문서의 Method로 가기(R-BLK-09, P2)는 그때 정한다.
- 2026-11-21에 바뀜: 이름을 적는 호출 블록(Method를 잃은 호출 블록도 이제 이것)에서
gd는 알리지 않고 Method 만들기를 한다 → CB15
CB10. 펴 보인 곳의 접기 영역이 걸칠 때
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 펴 보인 곳에서 Method의 접기 영역이나 그 자리의 다른 접기 영역과 범위가 같거나 끝에 걸치는 접기 영역은 만들지 않고 알린다. 레이아웃은 그런 영역을 그리지 않으므로(Method가 바뀌어 그렇게 된 것은 그리지 않는다, P2), 만들어도 보이지 않기 때문이다. 보통 접기 영역의 규칙(같은 범위 · 걸침 거절)과 같다.
CB11. 다른 문서에 붙인 호출 블록
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 복사한 호출 블록은 부르던 Method의 이름을 클립에 담는다. 붙이면 그 문서에서 이름이 같은 Method를 부르고, 없으면 그 이름을 간직한 채 참조 대상 없음(점선과 ?)이 된다. 그 전에는 클립에 이름이 없어, 다른 문서에 붙이면 “(이름 없음)“이 되거나 우연히 같은 id의 다른 Method를 불렀다(backlog). 이름은 헤더를 따르므로(ADR-0022) 이름이 같은 Method가 사용자가 기대하는 것이다. 감수하는 점: 같은 문서에서 복사한 뒤 Method의 이름을 바꾸고 붙이면 그 호출 블록은 참조 대상 없음이 된다(호출할 Method 바꾸기로 다시 잇는다).
- 2026-11-21에 바뀜: 이름이 같은 Method가 없으면 참조 대상 없음이 아니라 그 이름을 적은 호출 블록(실선)이 된다 → ADR-0049
CB12. 펴 보인 곳에서 Method의 접힘을 바꾸면
대체됨
2026-11-19에 메인테이너가 다시 정했다 → CB13
정함 (2026-11-03, Claude의 추천안 — 메인테이너가 써 보고 정함): 펴 보인 곳에 보이는 Method의 접기 영역 · 분기도 접고 펼 수 있고, 그것은 Method의 접힘이라 Method 자신과 그 Method를 펴 보인 모든 곳이 함께 바뀐다. 모델은 펴 보인 블록의 접힘을 Method에 저장된 접힘으로 두었다(2. 뷰 상태). 그 자리에만 접고 싶으면 그 자리의 접기 영역을 만든다(R-EDIT-16).
CB13. 펴 보인 곳의 접힘은 그 자리의 것
정함 (2026-11-19, 메인테이너): 호출 블록을 처음 펴는 순간의 Method 접힘을 그 호출 블록으로 가져온다. 그 뒤로 호출 블록, Method, 같은 Method를 호출하는 다른 호출 블록의 접힘은 서로 영향을 주지 않는다. 겹쳐 펴 보인 안쪽 호출 블록도 경로마다 따로다. 닫았다가 다시 펴면 그 자리에서 마지막으로 본 접힘 그대로이고, 이 상태는 파일에 저장된다. 이미 저장한 문서의 펴 보인 호출 블록은 열 때 그때의 Method 접힘을 가져오므로 지금 모습 그대로 보인다. 메인테이너(2026-11-19): “함수호출을 펼치고, 그 안의 접기영역을 접었다 펼쳤다하니, 함수에서도 해당 접기영역이 같이 움직이네요. 안 그랬으면 좋겠어요.” “반대로 메소드에서 접거나 펼쳐도 호출 블록에는 영향을 주지 말아야합니다. 호출 블록은 처음 펼칠 때만 영향을 받습니다.” 구조와 저장 방식 → ADR-0046
호출 블록이 바뀔 때는 이렇게 한다(Claude가 정함, 메인테이너의 확인을 기다림). 풀면 들어온 사본이 그 자리의 접힘을 이어받고(CB8), 호출 대상을 바꾸면 새 Method를 처음 펴는 것과 같으며, 복사해 붙인 호출 블록은 새 호출 블록이라 처음 펼 때 Method의 접힘을 가져온다. 삭제한 호출 블록과 Method는 실행 취소하면 그 자리의 접힘도 돌아온다.
더함 (2026-11-19, 메인테이너): 펴 보인 곳의 분기와 반복 블록의 본문도 접기 영역처럼 그 자리에서 접고 편다. 그 자리에만 적용되고 Method와 다른 호출 블록은 바뀌지 않으며, 겹쳐 펴 보인 안쪽도 경로마다 따로다. Method에서 접힌 채 가져온 분기를 펼 방법이 없던 것을 메웠다. 무엇이 접히는지의 차례는 펴 보인 곳 밖과 같고(FD1, FD6), 맨 끝에 그것을 담은 호출 블록이 온다. Method의 접기 영역은 지금처럼 이름 띠나 접힌 칸을 선택했을 때 접히고, 분기나 본문 전체가 그 접기 영역 하나일 때는 그 분기 · 본문을 접는 명령이 그 접기 영역을 접는다(Claude가 정함, 메인테이너의 확인을 기다림).
16. 2026-11-10의 결정
2026-11-10 LLM · 에이전트 안내서 (M56, 메인테이너가 추천안을 받아들임)
메인테이너가 ChatGPT에게 “https://ariadnensd.com 으로 버블소트 알고리즘을 nsd로 그려주세요”라고 하자, ChatGPT는 첫 화면 HTML만 읽고 앱을 조작하려 하다가 “요청하신 AriadneNSD는 현재 페이지가 로딩 화면으로만 확인되어 제가 직접 다이어그램을 입력하거나 저장하지는 못했습니다.”라고 답했다. 그래서 다른 AI가 공유 링크를 만들어 주고 사용자가 준 공유 링크를 읽게 하는 안내서를 시안 M56에서 물었다(안내서 초안 v1 ~ v3, haiku · sonnet · opus로 23번 실험). 메인테이너(2026-11-10): “모두 추천을 수용합니다.” 또 “다른 에이전트에게 안내할 때, ‘공유 링크 복사’ 기능을 추천해주세요.”라고 했다. 견준 안과 실험 → 시안 M56 https://claude.ai/artifact/RruS69wvMC5iyCkoWW6Erm · 사본 journal/assets/2026-11-09-llm-guide-study.html. 지금의 규칙 → 3.1 LLM · 에이전트를 위한 안내서, 3. 공유 URL과 보기 모드, 요구사항 R-WEB-10
LG1. 안내서의 자리와 언어
정함 (2026-11-10, 4번): 영어 /llms.txt 하나를 사이트 루트에 두고, 첫 화면 index.html이 그것을 가리킨다(<link rel="alternate" type="text/markdown">, 메타 설명). 그리고 첫 화면 HTML 안에 사람에게는 보이지 않는 짧은 안내(<section id="for-ai" hidden>: 조작하지 말고 공유 링크를 주라, 링크 만드는 법의 요약, 규칙 넷, 아주 작은 예제 하나, /llms.txt를 가리킴)를 둔다. 사용법에 “AI에게 그려 달라고 하기” 한 꼭지를 둔다. ChatGPT의 사례처럼 첫 화면만 읽고 링크를 따라가지 않는 도구에게는 가리키는 것만으로 모자라다. 자세한 것은 /llms.txt 하나에만 둔다. 영어는 모든 LLM이 가장 정확히 따르는 말이고 필드 이름 · 예제가 이미 영어다. 견준 것: 1 /llms.txt와 가리키기만, 2 영어와 한국어 두 벌(맞춰 둘 것이 둘), 3 사용법 안의 HTML 페이지만(관례를 아는 도구가 찾지 못함).
LG2. LLM이 만드는 링크의 꾸림
정함 (2026-11-10, 1번): 공유 링크에 꾸림 u(#ns1.u.<encodeURIComponent(봉투 JSON)>)를 더하되 앱은 읽기만 한다. 길이 한도 · 크기 한도 · parseModel의 검증은 다른 꾸림과 같다. u는 압축이 없어 코드 없이 손으로 만들 수 있고(실험에서 18번 열림), 사람과 LLM이 그대로 읽는다. 사람에게 추천하는 길(공유 링크 복사)과 AI에게 추천하는 길(공유 링크)이 같은 “누르면 열리는 링크”가 된다. 견준 것: 2 지금의 j(base64를 손으로 하면 한 글자만 틀려도 뒤가 깨짐), 3 d만(코드 도구가 없으면 만들 수 없음), 4 파일만, 5 짧은 글 DSL(문법 · 파서를 하나 더 지켜야 함). 구조의 결정 → ADR-0043
LG3. 모델 JSON의 JSON Schema
정함 (2026-11-10, 1번): /model.schema.json을 따로 두고 안내서에서 한 줄로 가리킨다. core의 테스트가 골든 파일들을 이 스키마로 검사해 파서와 어긋나지 않게 한다. 도구 호출 · 구조화 출력을 쓰는 에이전트가 가져다 쓰고, 안내서는 가볍게 남는다. 스키마는 모양만 검사하고 불변식은 앱이 검사한다고 적는다. 견준 것: 2 안내서 안에 넣기(안내서가 두 배 가까이), 3 두지 않음.
LG4. 요구사항 ID
정함 (2026-11-10, 1번): 새 요구사항 R-WEB-10(P1)으로 둔다. u 꾸림은 R-WEB-05의 상세(웹 설계)에 적는다. 웹이 내놓는 정적 파일이고 비용이 작으며, “AI에게 그려 달라 하면 링크가 온다”는 것이 처음 온 사람에게 쉬운 입구가 될 수 있다. 견준 것: 2 R-WEB-05에 덧붙임(안내서와 링크 형식이 한 줄에 섞임), 3 R-SKILL 영역에(그것은 Claude skill, 이 안내서는 skill 없이 아무 LLM에게나 듣는 웹의 것).
LG5. 사용자가 준 링크를 LLM이 읽는 길
정함 (2026-11-10, 1번): 공유 링크 복사는 지금처럼 d 하나를 만든다(앱의 코드는 바꾸지 않음). 안내서에 “코드를 못 돌리면 d의 내용을 짐작하지 말고 저장 파일이나 모델 JSON을 청하라”를 둔다. 메인테이너의 기준(“공유 링크 복사를 추천”)과 가장 잘 맞고, 실험에서 코드 없는 모델도 지어내지 않고 파일을 청했다. 견준 것: 2 공유 링크 복사가 u나 j를 만듦(링크가 2 ~ 3배 길어져 사람끼리의 공유가 나빠짐), 3 “AI에게 줄 링크 복사” 메뉴를 하나 더(SH6과 어긋남). 써 보고 불편하면 3번을 다시 본다.
LG6. 열지 못한 링크의 까닭
정함 (2026-11-10, 1번): 공유 링크를 열지 못하면 모달에 그 까닭(파서의 detail, 영어)을 보이고 “오류 내용 복사” 버튼을 둔다. 안내서에도 사용자가 그 글을 붙이면 고쳐서 다시 주라고 적는다. LLM이 만든 링크가 깨지면 사용자는 무엇이 틀렸는지 그 LLM에게 말할 수 있어야 한다. 검증은 그대로 두고 고칠 길만 연다. 견준 것: 2 u에서 끝의 괄호만 맞춰 열기(파일과 같은 검증 QA-02에 예외가 생김, 1번을 써 본 뒤에 다시 봄), 3 지금처럼 한 줄 알림만.
LG7. 화면을 조작하는 AI에게도 안내가 보이게
정함 (2026-11-10, 메인테이너가 둘 다 고름): 첫 화면의 #root 밖(body 끝)에 보이지 않는 글(visually-hidden: 화면에는 없고 DOM과 접근성 트리에는 남음)로 짧은 영어 안내(조작하지 말고 /llms.txt를 읽어 공유 링크를 주라)를 두어 앱이 뜬 뒤에도 남긴다. 또 도움말 메뉴의 “사용법” 바로 다음에 “AI에게 그려 달라고 하기”(영어 화면은 “Ask an AI to Draw”)를 두어 사용법의 그 꼭지(#ai)를 화면 언어로 연다. Grok에게 같은 부탁을 하자 링크를 주지 않고 앱이 그린 화면의 글자(“Blank document”, “Export as PNG”)로 손으로 따라 할 순서를 주었다. 자바스크립트를 돌리는 브라우저로 열어 조작하려 한 것으로 보이며, LG1의 #for-ai는 #root 안에 있어 앱이 뜨면 사라져 보지 못했다. 메뉴는 AI가 화면을 조작하려 할 때 사용자가 할 일(AI에게 링크를 청함)을 찾게 한다. 스크린 리더도 그 글을 읽으므로 한두 문장으로 둔다. 시험 기록 → journal/assets/2026-11-10-grok-bubble/
- 만들며 Claude가 정한 것(메인테이너가 써 보고 정함): 상태 표시줄의 한 줄 대신
editor의 모달(confirm)로 보인다. 버튼이 있어야 하고, 페이지를 처음 열 때는 그 뒤의 “복원할까요?”보다 먼저 읽혀야 하기 때문이다. 모달의 제목은 시안의 그림대로 “AriadneNSD”(confirm에 제목을 줄 수 있게 더함). 버튼은 “닫기” / “오류 내용 복사”(기본. 처음 이름 “까닭 복사”는 메인테이너가 “어색합니다”라고 해 2026-11-10에 바꿈). 모든 실패(손상 · 너무 큼 · 더 새 버전 · 풀 수 없음)에 같은 모달을 쓴다. 복사하는 글은AriadneNSD could not open the share link (<reason>): <detail>과 안내서의 주소 한 줄. JSON이 읽히지 않을 때 detail 끝에 괄호 수가 맞지 않음을 덧붙인다(실험의 실패 둘이 모두 닫는 괄호 하나였다). 문구 → 3. 공유 URL과 보기 모드
17. 2026-11-19의 결정
IE1. 인라인 에디터가 열린 동안의 선택 하이라이트
정함 (2026-11-19, 1번): 인라인 에디터가 열린 동안 그 블록의 선택 하이라이트를 그리지 않는다. 편집을 끝내면(확정 · 취소) 다시 그린다. 입력 칸의 테두리가 이미 편집하는 자리를 보이므로 같은 자리에 두 테두리를 겹치지 않는다. 선택 자체는 그대로 두고 표시만 감춘다. 견준 것: 2 하이라이트를 유지. 견준 안과 그림 → 시안 M61 https://claude.ai/artifact/WkEz8gZxssBrk8Dwmoxbp1 · 사본 journal/assets/2026-11-19-inline-editor-selection-study.html. 지금의 규칙 → 7.1 상태 표
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 감추는 기준은 “선택 하이라이트의 상자가 입력 칸과 겹치는가”다. 분기 안의 블록을 선택한 채
Shift+L로 그 분기의 라벨을 편집할 때는 선택한 블록이 입력 칸과 다른 자리에 있으므로 하이라이트를 그대로 그린다.
AR1. 호출 블록의 결과 기호는 문자로
정함 (2026-11-19, 1번): 호출 블록의 결과 기호 ←는 도형이 아니라 문자로 그린다. 저장 파일의 서브셋 글꼴에 ←(U+2190)의 글리프가 포함되므로 앱이 없는 뷰어에서도 깨지지 않고, 텍스트로 선택 · 복사 · 검색할 수 있다. 견준 것: 2 도형(path)으로 그림. 견준 안과 그림 → 시안 M62 https://claude.ai/artifact/FsPsd7WoByF58CeRNpoGKL · 사본 journal/assets/2026-11-19-result-arrow-study.html. 지금의 규칙 → 2. 레이어와 출력
SL1. 외곽선과 PDF도 기울여 그린다
정함 (2026-11-19, 1번): 문서 설정 “텍스트를 외곽선으로 저장”을 켠 저장 파일 · 순수 SVG와 PDF도 화면과 같은 글자(이름 없는 접기 영역, ”⋯ 블록 n개”)를 기울여 그린다. 번들 글꼴에 기울임체가 없으므로 글리프 외곽선을 기준선 기준으로 기울인다. 글자 폭과 레이아웃은 바뀌지 않는다. 견준 것: 2 기울임을 모든 출력에서 없앰. 견준 안과 그림 → 시안 M63 https://claude.ai/artifact/Ja5HHeDmG23ZE8z8VC2kQS · 사본 journal/assets/2026-11-19-slanted-outline-study.html. 지금의 규칙 → 4.2 텍스트의 역할, 4.3 텍스트 외곽선
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 기울기는 높이의 1/4(약 14도)이다. 브라우저의 합성 기울임과 같은 값이고, 이진수로 정확히 표현되어 출력이 결정적이다. PDF에서 번들 글꼴에 없는 문자를 대신하는 빈 상자도 기울임 런이면 함께 기울인다.
NT1. 상태 표시줄의 알림은 나타날 때 색을 바꾸지 않는다
정함 (2026-11-19, 1번): 상태 표시줄의 알림은 나타날 때 색을 바꾸지 않는다. 견준 것: 2 1.6초 동안 강조색(ui.accent)으로 보였다가 돌아옴. 견준 안과 그림 → 시안 M64 https://claude.ai/artifact/TUshhZRjFRG4uWKDj4qLSH · 사본 journal/assets/2026-11-19-status-notice-study.html. 지금의 규칙 → 9.4 움직임
KA1. 키 힌트와 키보드 메뉴의 가로 위치
정함 (2026-11-19, 2번): 키 힌트와 키보드로 연 컨텍스트 메뉴의 가로 위치는 선택의 왼쪽 끝에서 최대 24px 안쪽이다(선택의 폭이 24px보다 좁으면 선택의 오른쪽 끝). 지금 앱의 동작을 규칙으로 삼았다. 세로 위치, 위로 뒤집기, 창 안으로 밀어 넣기는 K3 그대로다. 견준 것: 1 선택의 왼쪽 끝에 맞춤. 견준 안과 그림 → 시안 M65 https://claude.ai/artifact/Ejqi2kDF2ZzZ27mADjVNrc · 사본 journal/assets/2026-11-19-key-hint-anchor-study.html. 지금의 규칙 → 7.1 상태 표, 1. 화면 구성
EX1. 다른 문서를 찾을 수 없어도 저장되는 그림은 실선
정함 (2026-11-19, 1번): 다른 문서를 찾을 수 없어도 저장되는 그림의 호출 블록은 항상 실선이다. 찾을 수 없다는 표시는 편집 레이어에만 그린다. 찾을 수 있는지는 그 순간의 환경에 따른 정보라서, 저장 파일에 넣으면 저장하는 환경에 따라 바이트가 달라져 QA-03을 어긴다. Method를 삭제하거나 헤더를 제거해 잃은 호출 블록은 문서 안의 사실이므로 지금처럼 이중선이 점선이다. 다른 문서의 Method 호출(R-BLK-09, P2)은 아직 없는 기능이고, 이 규칙은 그 기능을 만들 때 따른다. 편집 레이어 표시의 모양은 그때 정한다. 견준 것: 2 저장되는 그림도 점선. 견준 안과 그림 → 시안 M66 https://claude.ai/artifact/DegnVr2BHXZFhDVgCZ3FMa · 사본 journal/assets/2026-11-19-external-call-study.html. 지금의 규칙 → 7.1 상태 표, 호출 블록
- 2026-11-21에 해당하지 않게 됨: 다른 문서의 Method 호출을 철회했고(R-BLK-09), Method를 잃은 호출 블록도 이름을 적는 호출 블록이 되어 점선이 없어졌다 → ADR-0049
WC1. 경고색 글자의 대비
정함 (2026-11-19, 1번): 밝은 화면의 ui.warn을 #b35a10에서 #ad560f로 어둡게 한다. 어두운 화면과 고대비 화면의 값은 그대로다. ui.warn은 3px 줄만이 아니라 경고 알림과 삭제 버튼의 글자에도 쓰므로 기준은 텍스트의 4.5:1이다. 삭제 버튼(ui.bg 위)은 4.23:1에서 4.51:1로, 경고 알림(ui.panel 위)은 4.79:1에서 5.10:1로 올라간다. 견준 것: 2 삭제 버튼의 배경만 흰색, 3 지금대로 두고 명세에 예외를 둠. 견준 안과 그림 → 시안 M67 https://claude.ai/artifact/TEwWHzRF2nQ3SBGZfeVWca · 사본 journal/assets/2026-11-19-warn-contrast-study.html. 지금의 규칙 → 3.4 화면 색
덧붙임 (2026-11-19): 고대비 밝은 화면의 ui.warn은 #8f4508에서 #7f3c06으로 하여 7:1을 지킨다. 고대비 어두운 화면의 #f5b97a는 그대로다. 고대비 화면 색의 텍스트 기준은 7:1인데 옛 값은 이에 미달했다. ui.bg 위는 6.14:1에서 7.27:1로, ui.panel 위는 6.95:1에서 8.23:1로 올라간다.
CV1. 설계 문서 대조에서 정한 14가지
정함 (2026-11-19, 메인테이너가 추천안을 모두 받아들임): 설계 문서 전수 대조의 “상” 항목 가운데 문서와 앱이 서로 다른 동작을 말하던 18건(14가지)을 아래처럼 맞춘다. 메인테이너: 추천안을 모두 수용. 견준 안과 영향 → 설계 문서 대조에서 물어볼 것
| 차례 | 항목 | 정한 것 | 지금의 규칙 |
|---|---|---|---|
| 1 | K08 · I07 | 앱을 문서에 맞춤: 분기 라벨 · 접기 영역 · 빈 default 칸에서 풀기는 담은 제어 블록을 푼다 | 02-interaction-rules |
| 2 | I01 | 문서를 앱에 맞춤: 헤더에는 붙여넣지 않는다 | 02-interaction-rules |
| 3 | I02 | 미완성으로 밝힘: 모두 접기 · 모두 펴기 | 02-interaction-rules |
| 4 | I03 · E11 | 미완성으로 밝힘: 다른 문서의 Method 호출 | 02-interaction-rules, 06-web |
| 5 | I06 | 앱을 문서에 맞춤: 분기 라벨에서 메뉴의 삭제는 분기를 삭제한다 | 02-interaction-rules |
| 6 | I08 | 문서를 앱에 맞춤: 풀기는 툴바에 없다 | 02-interaction-rules |
| 7 | I09 | 문서를 앱에 맞춤: ← →는 바로 담은 것이 분기일 때 건넌다 | 02-interaction-rules |
| 8 | I13 | 문서를 앱에 맞춤: Case 분기 라벨을 비우면 편집 전의 라벨로 돌아간다 | 02-interaction-rules |
| 9 | I23 · I24 | 앱을 문서에 맞춤: 펴 보인 곳의 접기 영역을 복사하면 그 블록을 복사한다 | 02-interaction-rules |
| 10 | V05 | 앱을 문서에 맞춤: 문서 설정에 결과 기호를 둔다(뷰 상태) | 05-screen-layout, 03-editor |
| 11 | V06 | 문서를 앱에 맞춤: 환경 설정에 고정폭 글꼴은 없다 | 05-screen-layout |
| 12 | M06 | 문서를 앱에 맞춤: 텍스트 외곽선의 <path> 개수 | 01-file-format |
| 13 | E03 · E04 | 문서를 앱에 맞춤: extendTo와 extendBy, 명령 목록을 거치지 않는 입력 | 03-editor, 03-editor |
| 14 | E12 | 앱을 문서에 맞춤: Firefox · Safari의 첫 저장은 이름을 물은 뒤 내려받는다 | 06-web |
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 분기 라벨 · 빈 default 칸에서 풀면 라벨과 칸이 없어지므로 나온 블록들을 선택하고, 접기 영역에서 풀면 접기 영역을 선택한 채로 둔다. 풀기를 분기 라벨 · 접기 영역 · 빈 default 칸의 컨텍스트 메뉴에도 보인다. 결과 기호는 문서 설정 창에서 테마 바로 앞에 두고, 읽기 전용 문서에서는 다른 문서 설정처럼 거절한다.
NF1. 제어 블록을 거쳐 겹친 테두리
정함 (2026-11-19, 메인테이너): 테두리(펴진 접기 영역, 펴 보인 호출 블록) 안의 테두리는 제어 블록을 몇 겹 거쳐 들어가도, 그 변이 바깥 테두리의 왼쪽 · 오른쪽 · 아래 변에 닿으면 바로 안에 든 경우와 똑같이 size.nest-gap(1px)의 틈이 보이게 들어간다(4px). 닿지 않는 변은 들이지 않는다. 호출 블록과 접기 영역은 펼침 · 접힘에서 같은 UX 기준을 따른다. 메인테이너: “접힘영역 중복되었을 때, 1px 띄우는 규칙이 있지요? 호출블록 펼침이 중복되었을 때도 동일하게 적용해주세요. 호출블록과 접힘영역은 펼침, 접힘이 동일한 UX 기준을 가지는 것입니다.” 바로 안에 든 경우는 이미 네 조합이 모두 같았고, 반복 블록이나 분기를 거치면 안쪽 테두리가 바깥 테두리에 붙어 상자가 따로 보이지 않던 것을 메웠다. 지금의 규칙 → 1.6 테두리가 있는 것, 5. 기하와 해부도, 접기 · 펼치기
- 범위 밖으로 남긴 것: 옆 분기에 나란히 있는 두 테두리는 분기 사이의 선에서 만난다(사이의 틈 0px). 이 규칙은 바깥 테두리와의 틈만 정한다.
18. 2026-11-21의 결정
견준 안과 그림 → 시안 M68 https://claude.ai/artifact/JuCtRXh9hjqwPAVA635fA6 · 사본 journal/assets/2026-11-21-wrap-button-study.html
TB2. 감싸기 ▾의 아이콘
정함 (2026-11-21, WS1 2번 · 안쪽 네모는 실선): 툴바의 “감싸기 ▾” 아이콘을 블록 아이콘과 같은 크기(22 × 16)와 같은 방식으로 그린다. 바깥 테두리는 분기 색(block.branch), 안에 든 블록은 처리 색(block.process), 선은 1px line.structure다. 안쪽 네모도 실선이다. 메인테이너: “2번 색을 칠함이 좋은데 안의 박스를 점선 말고 실선으로 합시다”. 16 × 16 선 아이콘이 블록 아이콘 다섯 바로 뒤에서 작고 흐려 보였다. 견준 것: 1 22 × 16 테두리를 글자색 선으로, 3 지금 그림을 키움. 글자 “감싸기”와 ▾는 그대로이고, 좁은 화면에서는 아이콘만 보인다(MB2). 지금의 규칙 → 화면 배치, 7. 웹에서의 화면
TB3. 감쌀 것이 없을 때의 감싸기 ▾
정함 (2026-11-21, WS2 1번): 감싸기 명령 다섯이 모두 지금 적용되지 않으면 “감싸기 ▾“를 다른 툴바 버튼처럼 흐리게 보이고, 툴팁은 그 이유(“먼저 블록을 선택하세요.” 등)다. 누르면(마우스, Enter · Space) 메뉴를 열지 않고 그 이유를 상태 표시줄에 알린다. “막지 않고 알린다”(2. UX 원칙)를 툴바의 다른 흐린 버튼과 같게 따른다. 감싸기 명령이 하나라도 적용되면 지금처럼 메뉴를 연다. 견준 것: 2 흐리게 보이되 메뉴는 열림(항목이 모두 흐림), 3 반응 없음. 지금의 규칙 → 감싸기 · 풀기
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 이유는 메뉴 순서의 첫 감싸기 명령(“If로 감싸기”)의 것이다. 다섯 명령이 같은 조건이라 이유도 같다. “확대 ▾“는 바꾸지 않는다(확대 명령은 언제나 적용된다). 흐린 동안에도 접근성 이름은 “감싸기”이고, 메뉴가 열린 채 흐려지면 메뉴를 닫는다.
CB14. 펴 보인 곳의 접기 영역은 처음 펼 때 복사한다
정함 (2026-11-21, M69 SF1 2번, 메인테이너): 호출 블록을 처음 펼 때(CB13이 접힘을 가져오는 때와 같다) Method의 접기 영역을 이름과 접힘까지 그 자리의 접기 영역으로 복사한다. 그 뒤로 그 영역은 그 자리의 것이라 그 자리에서 풀고 이름을 바꾸고 접고 펼 수 있고, Method와 같은 Method를 호출하는 다른 호출 블록은 바뀌지 않는다. Method에서 더하거나 풀거나 이름을 바꾼 접기 영역은 이미 펴 본 자리에 전달되지 않는다. 메인테이너가 펴 보인 곳에서 접기 영역을 풀 수 없다고 알렸다(그때는 Method의 접기 영역은 Method에서만 풀 수 있었다). 메인테이너: “접기영역은 가시성과 강조를 위한 것입니다. 다이어그램의 진정한 내용이 아니에요. 따라서 메소드에서 변경한 것을 호출블록 펼침에 적용할 필요가 없습니다.” 견준 안과 그림 → 시안 M69 https://claude.ai/artifact/FewcYev31r8gVFanWEKiqV · 사본 journal/assets/2026-11-21-site-fold-remove-study.html. 구조와 저장 방식 → ADR-0047, 지금의 규칙 → 펴 보인 곳의 접기 영역
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음):
- 복사는 내용을 바꾸므로, Method에 접기 영역이 있는 호출 블록을 처음 펴면 실행 취소 단계 하나가 생기고 문서가 바뀐 것(●)이 된다. 그 단계를 실행 취소하면 그 자리의 사본만 사라지고 호출 블록은 펴진 채로 남으며, 다시 복사하지 않는다. (같은 날 UN1로 바뀜: 펴 보기와 복사가 한 단계라, 실행 취소하면 호출 블록이 접히고 사본도 사라진다.) 명령(풀기, 호출 대상 바꾸기 등)이 새 자리를 그리게 해서 복사하면 그 명령의 단계에 묶인다. 이전 파일을 열 때와 보기 모드에서 펼 때는 단계를 만들지 않고 저장 표시도 바꾸지 않는다.
- “이미 복사함”의 표시는 CB13의 표시(
view.folded의b4/)를 그대로 쓴다. Method에 접기 영역이 있으면 이 표시를 파일에 언제나 적는다. - 이전 파일에서 펴 보인 호출 블록에 표시가 없으면 열 때 복사한다. 연 모습은 같고, 열고 바로 저장하면 사본이 더해져 바이트가 바뀐다.
- 그 자리에 범위가 같은 접기 영역이 이미 있으면 그 Method 영역은 복사하지 않는다(붙여넣은 호출 블록은 사본을 함께 가져가므로 두 번 생기지 않는다).
- 호출 블록을 풀면 표시가 있는 자리는 그 자리의 접기 영역만 보통 접기 영역이 되어 들어온다(그 자리에서 푼 영역은 돌아오지 않는다). CB8의 “보던 모습 그대로”와 같다.
- 펴 보인 곳에서 새 접기 영역은 그 자리의 영역(사본 포함)과만 같은 범위 · 걸침을 검사한다(CB10). Method의 영역은 그 자리에 그려지지 않는다.
UN1. 접고 펴기도 실행 취소의 대상
정함 (2026-11-21, 메인테이너): 접고 펴기는 모두 실행 취소의 대상이다. 접기 영역, 제어 블록의 안쪽(If · Case의 분기, 반복 블록의 본문), 호출 블록 펴 보기를, 펴 보인 곳과 그 밖 모두에서, 키(f · zo · zc · za) · 펼침 삼각형의 클릭 · 보기 메뉴 어느 것으로 접고 펴든 한 단계다. Q9(2026-10-13, “보기 상태는 대상이 아님”)를 대체한다. 메인테이너: “모두 접고 펴기를 대상으로 합시다”. 그림이 바뀌었는데 실행 취소가 듣지 않는 것은 처음부터 놀라운 곳이었고(6장), CB14의 복사가 들어오면서 펴 보기의 일부만 실행 취소되는 어긋남도 생겼다. 구조 → ADR-0048, 지금의 규칙 → 6. 실행 취소
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음):
- 실행 취소 한 단계는 그 앞의 내용과 접힘 · 펴 보기를 함께 되돌린다. 내용을 바꾸는 명령을 실행 취소해도 그 명령 전의 접힘으로 돌아간다. 그래서 새 접기 영역(만들면 바로 접힘)을 실행 취소하면 영역이 사라진 펴진 그림이 되고, 호출 블록을 처음 펴며 접기 영역을 복사한 것을 실행 취소하면 호출 블록이 접히고 사본도 사라진다(CB14의 Claude가 정한 것을 바꿈).
- 이름 띠 보기와 결과 기호는 지금처럼 대상이 아니다(메인테이너가 정한 범위는 접고 펴기). 실행 취소해도 이름 띠 · 결과 기호는 지금 값 그대로다.
- 접고 펴면 지금처럼 저장 안 됨(●)이 켜진다(파일에 저장되는 것이 바뀜). 실행 취소로 저장한 때의 모습에 돌아오면 꺼진다.
- 명령 하나가 한 단계다. 잇달아 접고 펴도 합치지 않는다. 바뀌는 것이 없는 접기 · 펴기는 단계를 만들지 않는다. 접고 펴면 다시 실행할 것(redo)은 비워진다.
- 모두 접기 · 모두 펴기(아직 없음)는 만들 때 명령 하나가 한 단계다.
- 보기 모드에서 접고 펴는 것은 단계를 만들지 않고 저장 안 됨도 바꾸지 않는다(지금 그대로). 실행 취소도 보기 모드에서는 되지 않는다.
- 실행 취소 뒤의 선택은 Q19 그대로다: 선택한 것이 그려져 있으면 그대로, 접혀 안 보이게 되었으면 선택이 없다.
CB15. Method 만들기
정함 (2026-11-21, 메인테이너가 추천안을 받아들임): 이름을 적는 호출 블록에서 “Method 만들기”를 하면 문서에 그 이름의 Method 다이어그램을 만들어 잇고 그리로 간다. 헤더는 이름(호출 블록의 인자)(인자가 비었으면 이름), 본문은 빈 블록 하나다. 문서 안에서 같은 이름을 적은 호출 블록도 모두 새 Method에 잇는다. 실행 취소 한 번으로 모두 되돌린다. 키는 gd: Method를 호출하면 지금처럼 그리로 가고, 이름을 적는 호출 블록이면 Method 만들기를 한다. 컨텍스트 메뉴의 “Method 만들기”는 이름을 적는 호출 블록에서만 보인다. 메인테이너의 inbox: “호출블록이 바라보는 Method가 없을 때 호출블록이 가리키는 Method 다이어그램을 새로 만드는 방법을 제공합니다. (단축키, 우클릭 메뉴)“. 논의 → 2026-11-21-03-call-without-method, 요구사항 R-EDIT-26, 모델 → ADR-0049, 지금의 규칙 → 호출 블록
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음):
- 새 Method의 자리는 “새 Method”와 같이 마지막 Method 뒤다(Method가 없으면 문서 끝). 다이어그램은 Method와 Event를 나눠 놓으므로(5장) 이것이 “문서 끝”이다.
- 만든 뒤의 선택은 새 Method의 헤더다(
gd로 Method에 간 것과 같다). 이름이 이미 있으므로 헤더 이름 편집을 열지 않는다. - 같은 이름의 Method가 이미 있으면(손으로 쓴 파일, 예전 파일) 새로 만들지 않고 그 Method에 잇는다. 같은 이름의 Event가 있으면 Method를 만들 수 없어 거절하고 “이름이 겹친다”고 알린다. 이름이 빈 호출 블록(“(이름 없음)“)은 “이름이 비었다”고 알린다.
- 같은 이름은 앞뒤 공백을 빼고 대소문자를 가려 견준다(헤더 이름의 규칙과 같다). 이은 호출 블록의 빈 인자에는 헤더의 괄호 안 텍스트가 들어간다(호출할 Method 바꾸기와 같다).
- 메뉴 바(다이어그램 메뉴)와 커맨드 팔레트에도 “Method 만들기”가 있다. 메뉴 바와 커맨드 팔레트의 “호출하는 Method로 가기”는 이름을 적는 호출 블록에서
gd와 같이 Method 만들기를 한다. 컨텍스트 메뉴에서는 둘이 겹치지 않게, 이름을 적는 호출 블록이면 “Method 만들기”만, 그 밖에는 “호출하는 Method로 가기”만 보인다. - 보기 모드에서는 Method 만들기와 이름을 적는 호출 블록의
gd를 “보기만 하는 중”으로 거절한다.
CB16. Method 풀어 넣고 지우기
정함 (2026-11-21, 메인테이너가 추천안을 받아들임): “Method 풀어 넣고 지우기”는 Method를 호출하는 모든 호출 자리에 그 Method의 블록들을 풀어 넣고(호출 블록 풀기와 같음, CB8) Method를 지운다. 실행 취소 한 번으로 모두 되돌린다. 호출 블록과 Method 헤더의 컨텍스트 메뉴 둘 다에서, 그리고 다이어그램 메뉴 · 커맨드 팔레트에서 부른다. 단축키는 없다. 자기 자신을 호출하는 Method와 호출하는 곳이 없는 Method는 거절한다. 메인테이너: “Method를 그 호출블록에 치환하고 Method를 지우는 기능을 추가하고 싶습니다.” 풀어 넣을 곳(모든 호출 자리)과 부르는 곳(호출 블록과 헤더 둘 다)은 메인테이너가 골랐고, 단축키를 두지 않는 것은 Claude의 추천이다(자주 쓰지 않고 여러 곳을 한 번에 바꾸는 명령이라, 메뉴에서 이름을 보고 고르게). 메인테이너: “네, 진행해 주세요”. 논의 → 2026-11-21-03-call-without-method, 요구사항 R-EDIT-27, 지금의 규칙 → 감싸기 · 풀기
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음):
- 거절하는 재귀는 직접 재귀뿐이다: 그 Method의 본문 안에 자기를 호출하는 호출 블록이 있으면 풀어 넣은 사본이 다시 지운 Method를 호출하게 되므로 거절한다. 서로를 호출하는 Method(A가 B를, B가 A를)는 거절하지 않는다. B를 풀어 넣고 지우면 A가 자기를 호출하게 될 뿐 잃는 것이 없다.
- 뒤의 선택: 호출 블록에서 불렀으면 그 자리에 들어간 블록들, 헤더에서 불렀으면 문서 순서로 첫 호출 자리에 들어간 블록들이다(풀기의 선택 Q19와 같음).
- 알림: “호출 {n}곳에 풀어 넣고 {이름}을(를) 지웠습니다.”, 영어 화면 “Inlined {name} at every call site ({count}) and deleted it.”(호출 자리가 하나일 때도 어색하지 않게 단수 · 복수를 피한 문장).
- 호출하는 곳이 없으면 메뉴 항목이 흐리고(컨텍스트 메뉴에도 보이되 흐림), 실행하면 “이 Method를 호출하는 곳이 없어 풀어 넣을 곳이 없습니다.”라고 알린다. 이름을 적는 호출 블록과 Event 헤더에서는 컨텍스트 메뉴에 나오지 않는다. 보기만 하는 중이면 다른 편집 명령처럼 거절한다.
2026-11-21 AI가 준 텍스트로 열기 (M57, 메인테이너가 추천안을 받아들임)
시안 M56의 안내서(/llms.txt)를 배포한 뒤 메인테이너가 AI 네 곳(ChatGPT · Gemini · Grok · claude.ai)에게 “https://ariadnensd.com 으로 버블소트(하노이탑) 알고리즘을 nsd로 그려주세요”라고 해 보았다. AI가 쓴 모델 JSON은 거의 항상 올바랐고, 실패한 곳은 JSON을 링크로 바꾸는 손 인코딩과 채팅 앱이 링크를 바꾸는 일(Gemini가 Google 검색 링크로 감쌈)이었다. 페이지를 열지 않거나(claude.ai) 화면부터 조작하려는 AI(Grok)는 그리지 못했다. 그래서 물음 여섯을 시안 M57에서 물었고, 메인테이너(2026-11-21)가 여섯 물음 모두 ★ 추천대로 골랐다. 견준 안과 그림, 시험 기록 → 시안 M57 https://claude.ai/artifact/QzYU7rsi5r15Xevc6XNgYm · 사본 journal/assets/2026-11-10-ai-paste-study.html. 지금의 규칙 → 붙여넣기, 3.2 붙여넣은 문서, 요구사항 R-WEB-11
JP1. 붙여넣기에서 문서를 알아보는 기준
정함 (2026-11-21, 1번 좁게): 앞뒤 공백과 코드 펜스(```json … ```)를 제거한 텍스트 전체가 "format": "ariadne-nsd"가 든 모델 JSON, 공유 링크 속의 봉투 {"name": …, "model": {…}}, https://ariadnensd.com/#ns1.로 시작하는 공유 링크 한 줄 가운데 하나일 때만 AriadneNSD 문서로 본다. https://www.google.com/search?q=로 감싼 링크는 q를 디코딩해 다시 본다. 그 밖의 텍스트(JSON이 아닌 텍스트, 다른 JSON)는 지금처럼 줄마다 처리 블록이다. 표지가 형식 이름과 우리 주소라서 사람이 쓴 텍스트가 우연히 걸릴 일이 없다. 나중의 의사코드 변환(R-CODE-01)은 “JSON이 아닌 들여쓰기 텍스트”를 받으므로 겹치지 않는다. 그때는 “줄마다 처리 블록”의 자리를 의사코드 해석이 이어받고, 이 검사는 그 앞에 그대로 선다. 견준 것: 2 넓게(JSON이면 모두. 다른 JSON을 블록으로 붙이려는 사람이 막힘), 3 알아보지 않음(블록 더미가 남음).
- 정해 둔 세부(시안의 “Claude가 정해 둔 세부”, 메인테이너가 확인): 텍스트 전체가 하나여야 한다(JSON 하나, 또는 링크 한 줄). AI의 답 전체(설명 + 코드 블록)에서 코드 블록 하나를 골라 꺼내지 않는다(오판을 피함). 감싼 링크는
google.com/search?q=만 디코딩한다(본 일). 다른 감싸기는 보면 더한다. - 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 지금 페이지의 주소 +
#ns1.로 시작하는 링크도 문서로 본다(앱의 공유 링크 복사가 만드는 링크는 그 페이지의 주소라서, 개발 서버 · 옛 주소에서도 같게). 봉투는 두 키만, 그model에도"format": "ariadne-nsd"가 있어야 한다.google.com/search(www 없음)도 같게 본다.
JP2. 알아본 뒤의 동작
정함 (2026-11-21, 1번 묻기): 문서를 알아보면 모달로 “붙여넣은 텍스트는 AriadneNSD 문서입니다. 새 문서로 열까요?”라고 묻는다. 버튼은 “취소” · “텍스트로 붙여넣기” · “새 문서로 열기”(기본, Enter). “텍스트로 붙여넣기”는 지금처럼 줄마다 처리 블록이고, 선택한 것이 없으면 흐리다. 선택한 것이 없을 때도 같은 질문이다. “새 문서로 열기” 뒤에는 공유 링크를 열린 탭에 붙여넣을 때와 같은 경우에 US1의 모달이 이어지고, 열어 보니 깨졌으면 LG6의 모달을 보인다. 붙여넣기는 원래 “지금 문서에 더하기”라서 문서를 바꾸는 일은 한 번 묻는 것이 맞다. 한 번의 Enter라 손이 거의 들지 않고 옛 동작도 남는다. 모달과 그 뒤의 US1 · LG6은 이미 있는 것을 다시 쓴다. 견준 것: 2 묻지 않고 바로 열기(JSON 조각을 붙이려던 사람이 놀람), 3 블록으로만 붙이기(헤더 · 여러 다이어그램 · 설정이 사라짐).
- 정해 둔 세부(메인테이너가 확인): 새 문서의 이름은 봉투의
name, 모델 JSON만이면 “제목 없음”(새 문서와 같음). 한 번도 저장하지 않은 새 문서로 열린다(공유 링크로 연 문서와 같고, 보기 모드는 아님). 새 문서로 연 것은 실행 취소로 되돌리지 않는다(열기와 같음). - 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 시안의 문구 “이 글은 …”, “글로 붙이기”는 용어집의 단어 규칙(텍스트 · 붙여넣기)에 맞춰 “붙여넣은 텍스트는 …”, “텍스트로 붙여넣기”로 했다. 모달의 제목은 LG6처럼 “AriadneNSD”다. 앱에서 복사한 블록(사용자 정의 형식)은 텍스트가 문서여도 묻지 않고 블록으로 붙인다. 보기 모드(읽기 전용)에서는 붙여넣기가 지금처럼 거절된다(그때는 파일 › 붙여넣은 JSON으로 열기…). 헤더 · 분기 라벨을 선택했을 때도 지금처럼 거절한다. 선택한 것이 없을 때 문서가 아닌 텍스트를 붙여넣으면 “먼저 블록을 선택하세요.”라고 알린다(그래서 붙여넣기 명령은 선택한 것이 없어도 흐리지 않다). 질문이 떠 있는 동안 저장은 붙여넣기를 기다리지 않는다(US1의 저장이 그 뒤에 오므로). 모델 JSON이 깨졌을 때 복사하는 오류 내용은
AriadneNSD could not open the pasted text (…)로 시작한다(공유 링크는 그대로… the share link …).
JP3. 메뉴로 여는 길
정함 (2026-11-21, 1번): 파일 메뉴에 “붙여넣은 JSON으로 열기…”(영어 화면 “Open from Pasted JSON…“)를 두고 커맨드 팔레트에도 같은 이름으로 둔다. 여러 줄 입력 칸의 모달(“AI가 준 모델 JSON이나 공유 링크를 붙여넣으세요.”, 취소 · 열기)을 띄워 붙인 텍스트를 JP1의 기준으로 연다. 안내서와 사용법이 “파일 › 붙여넣은 JSON으로 열기…”라고 한 줄로 가리킬 수 있고, 클립보드 권한이 없는 브라우저(휴대폰)에서도 된다. 견준 것: 2 메뉴 없음(기능이 있는 줄 모르고 가리킬 이름이 없음), 3 열기 창 안의 탭(한 번 더 들어가야 함).
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 시안의 “붙여 넣은”은 용어집대로 “붙여넣은”으로 붙여 썼다. 자리는 열기… 바로 아래(최근 파일 ▸ 앞)다. 입력 칸에서
Enter는 줄 바꿈,Ctrl+Enter는 열기다. 칸을 비우거나 취소하면 아무것도 하지 않고, 문서가 아닌 텍스트는 LG6의 모달로 “이 텍스트는 AriadneNSD 문서(모델 JSON이나 공유 링크)가 아닙니다.”와 이유를 보인다.
RQ1. 요청문 복사
정함 (2026-11-21, 1번 · ○○ 자리는 a): 사용법의 “AI에게 그려 달라고 하기” 꼭지(#ai, 도움말 메뉴가 이미 엶 → LG7)에 요청문과 “요청문 복사” 버튼, “링크가 열리지 않으면 AI가 준 JSON을 복사해 파일 › 붙여넣은 JSON으로 열기…에 붙여넣으세요.”를 둔다. 요청문은 “https://ariadnensd.com/llms.txt 를 읽고, ○○을 NS 차트로 그려 공유 링크와 모델 JSON을 주세요.”(영어 “Read https://ariadnensd.com/llms.txt, then draw ○○ as a Nassi–Shneiderman diagram and give me the share link and the model JSON.“)이고, ○○은 글 속에 그대로 두고 색을 칠한다. 요청문 한 줄이 페이지를 열지 않는 AI와 화면부터 조작하는 AI 모두에게 통하는 유일한 경로다. “공유 링크와 모델 JSON”을 함께 청해 두면 링크가 깨져도 JSON을 붙여넣어 열 수 있다. 견준 것: 2 메뉴를 누르면 곧바로 복사(무엇이 복사됐는지 보이지 않음), 3 요청문 없이 사용법만(지금. 시험한 넷 가운데 둘이 그 한 줄이 없어 그리지 못함). ○○ 자리의 견준 것: b 입력 칸을 채워 복사, c 예시를 넣어 둠.
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 버튼은 요청문 상자 오른쪽에 두고, 누르면 잠시 “복사했습니다”로 바뀐다. 클립보드를 쓸 수 없으면 요청문을 선택해 손으로 복사하게 한다. 그 꼭지의 “AI가 엉뚱하게 답하면 … 덧붙입니다” 항목은 요청문이 대신하므로 뺐고, “JSON을 붙여넣으면” 항목을 더했다.
GD1. 안내서 손질
정함 (2026-11-21, ① ~ ④ 모두): /llms.txt에 ① 링크를 코드 블록에도 그대로 적고 모델 JSON은 따로 코드 블록으로(채팅 앱이 링크를 바꾸므로), ② 횟수를 세는 반복은 for, ③ 링크가 열리지 않으면 사용자가 모델 JSON을 앱에 붙여넣어 열 수 있다(파일 › Open from Pasted JSON…, 또는 페이지에 그대로 붙여넣기)를 더하고, ④ “코드를 실행할 수 있으면 실행하라”를 단계 3의 앞으로 옮긴다. ③은 JP가 구현된 뒤에 넣는다. ①과 ③은 “링크는 깨져도 JSON은 남는다”는 테스트 결과를 경로로 만든다. ②는 Gemini가 세는 반복을 while로 쓴 것을 보고 더했다. ④는 손 인코딩의 실패(Gemini, M56의 haiku)가 모두 단계 3을 먼저 읽고 따른 데서 왔다. 문장은 시안의 “변경 후” 그대로다. 지금의 안내서 → 3.1 LLM · 에이전트를 위한 안내서
RQ2. 요구사항 ID
정함 (2026-11-21, 1번): 새 요구사항 R-WEB-11(P1)을 R-WEB-10 바로 다음에 둔다. 인수 테스트 AT-12에 “AriadneNSD 문서인 텍스트는 새 문서로 열지 묻는다”를 덧붙인다. 요구사항 하나는 “무엇을” 한두 줄이므로 따로 두고, 계기와 쓰는 곳이 웹의 AI 경로(공유 URL, 안내서)라 R-WEB에 둔다. 다른 배포 대상으로 넓히면 그 대상의 요구사항을 새로 둔다. 견준 것: 2 R-WEB-10의 상세에 둠(정적 파일과 편집기의 동작이 섞임), 3 R-EDIT-26(편집 기능으로 읽히지만 다른 배포 대상에서 쓸지 정하지 않음).
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): 요구사항의 문구는 시안의 “AI가 준 글로 열기 …붙여 넣어…”를 문서의 말 규칙(글 → 텍스트)과 용어집(붙여넣기)에 맞춰 “AI가 준 텍스트로 열기: 모델 JSON이나 공유 링크를 붙여넣어 새 문서로 연다”로 했다.
RO1. 다른 탭이 편집 중일 때의 보기만 하는 중
정함 (2026-11-21, Claude가 정함, 메인테이너의 확인을 받지 않음): 다른 탭이 같은 문서를 편집하고 있어 보기만 할 때는 메뉴 바 오른쪽의 라벨을 “보기만 하는 중 · 다른 탭에서 편집 중”(영어 “View only · editing in another tab”)으로 보이고, 툴팁에 “그 탭을 닫으면 여기서 편집할 수 있습니다.”(영어 “Close that tab to edit here.“)를 둔다. 그 탭이 닫혀 이 탭이 편집을 되찾으면 라벨이 사라진다. 공유 링크의 보기 모드와 그 밖의 보기만 하는 경우는 지금처럼 “보기만 하는 중”이다. 메인테이너의 결함 신고(BUG-18, 2026-11-21): “로컬서버에서 실행하고 있는데, 보기만 하는 중이라는 우상단 메시지가 나오고 편집가능으로 갈 방법이 없습니다.” 까닭은 처음에 상태 표시줄의 알림으로만 보여 곧 사라졌다. 결함 → BUG-18, 지금의 규칙 → 화면 배치, 2. 로컬 백업과 자동 저장
19. 2026-11-22의 결정
SK1. 문장 하나에 처리 블록 하나
정함 (2026-11-22, 메인테이너): Claude 스킬은 코드의 문장 하나를 처리 블록 하나로 옮긴다. lo = 0과 hi = n - 1처럼 짧고 함께 하는 문장도 줄바꿈으로 한 블록에 합치지 않고, \n은 긴 문장 하나나 조건 하나를 여러 줄로 나눌 때만 쓴다. 줄바꿈으로 합치면 그림은 작아지지만, 고전 NS 차트의 형태(문장 하나가 블록 하나)에서 벗어나고 블록 단위로 옮기고 지우기 어렵다. 메인테이너는 작게 줄이는 것보다 고전 형태와 블록마다 다루기 쉬운 쪽을 골랐다. 지금의 규칙 → 2. 구성의 references/code-to-blocks.md, 스킬의 SKILL.md(text 항목)
GL1. 알고리즘 갤러리의 화면
정함 (2026-11-22, 메인테이너, 시안 M70의 G3): 알고리즘 갤러리(/gallery/, /gallery/ko/)는 왼쪽에 알고리즘 목록(칸: 고전 · 어려운 것 · 재미), 오른쪽에 고른 그림 하나를 크게 보인다. 고른 것은 주소의 hash(#kmp)에 남아 글에서 그림 하나로 바로 링크할 수 있다. 알고리즘은 22개(예제 가운데 알고리즘 6개 + 고전 · 어려운 것 · 재미 16개). 견준 것: G1 카드 그리드 + 누르면 큰 그림, G2 한 장씩 크게. 견준 안과 그림 → 시안 M70 https://claude.ai/artifact/1Vc5umdeaw4e36hzAhnv5C · 사본 journal/assets/2026-11-22-gallery-layout-study.html. 지금의 규칙 → 5.1 알고리즘 갤러리, 요구사항 R-WEB-12
- 만들며 Claude가 정한 것(메인테이너의 확인을 받지 않음): hash가 없거나 없는 항목이면 다익스트라를 보인다. 그림 위에 이름 · 한 줄 설명과 버튼 둘(“편집기에서 열기”는 공유 링크로 앱을 엶, “.ns.svg 받기”).
↑↓(목록 안에서는HomeEnd도)로 목록을 넘기고, 키로 넘길 때는 방문 기록을 쌓지 않는다(누를 때만 쌓음). 언어 링크는 고른 그림을 유지한다. 그림이 칸보다 넓으면 “넓은 그림: 옆으로 스크롤해 보세요.”를 보이고 옆으로 스크롤한다. 760px 이하의 좁은 화면은 목록 대신 선택 상자(select) 하나. 공유 카드용 Open Graph 그림(1200 × 630, 로고 · 제목 · 그림 셋).
GL2. 갤러리로 가는 링크
정함 (2026-11-22, 메인테이너): 갤러리로 가는 링크를 두 곳에 둔다. 사이트 왼쪽 메뉴의 “사용자 도움말” 바로 아래 “알고리즘 갤러리”(/gallery/ko/, site/patch-quartz.mjs), 앱의 도움말 메뉴의 “사용법” 바로 아래 “알고리즘 갤러리”(새 탭, 화면 언어의 gallery/ · gallery/ko/). 지금의 규칙 → 05-screen-layout, 5.1 메뉴 구성
- 만들며 에이전트가 정한 것(메인테이너의 확인을 받지 않음): 앱 메뉴에 구분선 · 단축키는 없고, 아래 항목(AI에게 그려 달라고 하기 · 단축키 목록 · 예제…)은 한 칸씩 내려간다. 영어 이름 “Algorithm gallery”.