2026-10-10 프로토타입 피드백
같은 날 네 번째 세션이다 (← 2026-10-10-03-inbox-review). 메인테이너가 프로토타입을 직접 써 보면서 inbox에 적은 것을 하나씩 확인하고, 그 자리에서 프로토타입을 고쳐 가며 요구사항을 정했다.
프로토타입: https://claude.ai/artifact/RuUjpc7YmCcbJXAdCeQiRG (journal/assets/2026-10-10-ns-prototype.html, 이 세션에서 33번 다시 게시함)
논의 흐름
- 세션 시작과 inbox. ADR을 고치는 규칙을 정했다(제안됨은 자유롭게, 승인된 것은 맨 위 “이후 변경” 콜아웃). ADR-0011을 승인했다.
E키에서 여러 다이어그램으로. “이벤트가 있으면 무엇을 할지 묻기”를 이야기하다가, 한 문서에 다이어그램 여러 개(#P1), 호출 블록, 고른 블록을 새 다이어그램으로 빼기가 요구사항에 들어갔다. 프로토타입 셋째 판.- inbox의 프로토타입 항목을 하나씩. 메인테이너가 “하나씩 물어보세요”라고 해서, 항목마다 지금 동작·해 볼 것·Claude가 정한 것·질문을 보여 주고 답을 받아 고쳤다. 접기, 붙여넣기, 좌우 방향키, 넣을 위치,
E, 더블클릭, 다이어그램 사이 이동,Ctrl+방향키, 호출 블록 바꾸기, 머리 이름, 캔버스 포커스 선. - 접기를 여러 번 다시 정했다. 이 세션에서 가장 오래 걸린 부분이다.
- 강조 영역이 접기와 섞여 혼란스러워서 강조 영역 요구사항을 없앴다.
- “이름 붙은 영역”과 “접기펴기 영역”이 같은 것인지 묻는 질문에서, 용어를 접기 영역으로 통일했다.
- 접기 영역의 키를 셋으로 나눴다: 만들기
Shift+F, 접기·펴기F, 풀기Ctrl+Shift+F.U는 제어 블록 풀기로만 쓴다. - 제어 블록의
F는 세 번 바뀌었다. 갈래별 접기 + 이름 붙이기 → “갈래마다 접기 영역을 만든다”로 단순화 → 다시 예전 방식(갈래별로 ”⋯ 블록 n개”, 이름 없음) → 갈래 전체가 접기 영역이면 그 영역을 접는다.
- 접기 영역을 어떻게 보여 줄지. 이름표가 블록 글자를 가린다는 지적에 시안 네 가지를 프로토타입에 넣었고, 이름 띠로 정했다.
- 저장되는 그림. “현재 보이는 상태대로 저장하면 좋겠어요”에서 ADR-0018을 쓰고 승인받았다. ADR-0016은 대체됨이 되었다.
- Case. “case나 parallel은 구현하지 않나요?”라는 질문에서 Case 블록을 프로토타입에 넣었다.
결정
| 결정 | 반영한 곳 |
|---|---|
| 개발 순서: 웹 → Obsidian → 데스크톱 | ADR-0011 승인 |
승인된 ADR이 나중 일로 달라지면 맨 위 > [!NOTE] 이후 변경에 적는다 | CLAUDE.md, ADR 템플릿, 승인 ADR 아홉 건 |
| 한 문서에 다이어그램 여러 개(#P1), 호출 블록, 새 다이어그램으로 빼기 | R-EDIT-18, R-BLK-07, R-EDIT-19 |
| 호출 블록은 글자를 고치지 않고 부를 것을 목록에서 고른다. 이름은 머리에서만 고친다 | R-BLK-07 |
| 이벤트 머리의 이름은 겹치거나 비울 수 없다. 새 머리에는 기본 이름이 들어간다 | R-BLK-10 |
새 다이어그램 명령(E)은 묻지 않는다. 머리 달기는 다른 명령(M) | R-EDIT-19 |
넣기는 고른 블록 뒤(Shift는 앞), 빈 블록은 그 자리. 넣을 위치 모드는 없앤다 | R-EDIT-03 |
방향키 규칙: 좌우로 갈래 건너기, Ctrl+상하는 제어 블록을 한 덩어리로, Ctrl+좌우는 옆 갈래, 다이어그램 밖으로는 머리에서 또는 Ctrl+Shift+좌우 | R-EDIT-03 |
| 캔버스에 들어오면 첫 블록을 고른다 (캔버스 포커스 선 대신) | R-EDIT-03 |
| 붙여넣기: 고른 것 뒤에, 고른 것이 없으면 붙이지 않는다 | R-EDIT-10 |
| 강조 영역 요구사항을 없앤다 | ADR-0015 폐기 |
| 용어 “접기 영역” (전: 이름 붙은 영역) | 06-glossary |
| 접기 규칙 전체 (명령 셋, 갈래별 접기, 이름 띠, 중첩) | R-EDIT-13 |
| 저장되는 그림은 지금 화면 그대로, 접힘 상태도 파일에 저장 | ADR-0018 승인, ADR-0016 대체됨 |
| Case 블록의 모양과 갈래 조작 | R-BLK-05 |
발견한 위험
- 프로토타입을 Claude가 브라우저에서 한 번도 보지 못했다. 가짜 화면 위의 검사 177개로만 확인했다. 실제로 “접힌 칸 더블클릭이 안 된다”는 메인테이너가 눌러 보고서야 드러났다 (→ browser-focus-and-double-click). 화면 모양은 메인테이너의 눈에만 기대고 있다.
- 접기 규칙이 여러 번 뒤집혔다. 요구사항의 접기 절을 그때마다 고쳐 썼지만, 다른 문서(설계 문서, 예전 세션 기록)에 옛 규칙이 남아 있을 수 있다. 다음에 문서 전체를 훑을 때 확인한다.
F하나가 제어 블록과 접기 영역을 모두 다룬다. 접기 영역 안의 제어 블록을 골랐을 때 어느 쪽이 접힐지가 아직 덜 정해졌다. 메인테이너도 “더 구체화해야겠다”고 했다.- ADR-0018로 접고 펴기가 파일을 바꾸게 되었다. 그런데 프로토타입은 접고 펴기를 되돌리기에 넣지 않는다. 정해야 한다.
- 모델이 달라졌다. 다이어그램 여러 개, 호출 블록, Case, 접기 영역, 보기 상태가 하루에 들어왔다. 아키텍처 설계를 시작할 조건(status의 3번, “프로토타입 뒤에 나온 요구사항이 모델을 바꾸지 않는다”)이 아직 맞지 않는다.
- Claude가 앞서 나간 일이 있었다. 확인받기 전에 inbox 항목(
U)을 지우고 요구사항에 반영했다. 바로 알리고 원문은 기록에 옮겼다.
다음 할 일
- inbox에 남은 두 항목 검토: 이름을
Ariadne/Ariadne's NSD로 바꾸기, 로고와 아이콘에 영감을 주는 작품 (그림 8장) - 접기에서 덜 정해진 곳: 접기 영역 안의 제어 블록에서
F, 갈래의 일부만 접기 영역일 때, 접힌 줄을 펼 때 안쪽 접기 영역의 상태 - 접고 펴기를 실행 취소에 넣을지 (ADR-0018의 후속)
- 프로토타입에 드래그로 옮기기 넣기
- 오늘 바뀐 모델을 뒤따르는 문서에 반영: 파일 형식, 용어집, 모델·레이아웃 설계 (→ status)
- 프로토타입의 질문 목록에서 아직 답하지 않은 것
inbox 원문 (지운 항목)
1. 일하는 방식
- 아직 승인되지 않은 ADR은 수정할 수 있지 않나요?
- 승인된 ADR이 이후 작업에서 관련 내용이 변경된다면 승인된 ADR에 “참고사항” 또는 “이후 변경/추가 사항”으로 언급하는 것이 repo 방문자에게 혼란을 덜어 줄 것 같아요. (예를들어 배포 유형이 늘어난다든지하면 dr-0002-development-order이나 0002-three-targets-shared-core에)
- 이 문서에서 2, 3Level 제목이더라도 최근 함께 해왔던 작업에 비추어 내가 계속 쓸 것 같으면, 처리해서 내용을 지우더라도 그 제목을 남겨주세요. 더이상 안 쓸 것 같으면 지우시구요.
- dr-0002-development-order에 최근에 추가된 배포 방식에 대한 내용이
추가로 언급되어있지 않습니다. ADR을 보는 사람들이 우리가 논의한 히스토리를 전부 알거라고 기대할 수 없습니다. ADR을 보는 사람이 “이 ADR이 작성될 당시에는 이랬지만, 현재의 모습과 다른 모습을 기반으로 논의한 이유는, 이 이후에 추가/변경된 사항이 있어서 그랬구나”하는 것을 쉽게 이해할 수 있어야합니다. - ADR의
이후 변경은 문서 맨 앞에> [!NOTE]로 해주세요.
3. 기능
프로토타입 > 추가/변경 요건
E:- 이벤트 없는 경우 이벤트 머리달기
- 이벤트 있는 경우 뭘 할지 물어보기
- 새로운 빈 다이어그램을 만들고 이벤트를 달지
- 선택된 영역을 새로운 다이어그램으로 만들고 이벤트를 달고
- 현재 선택된 영역은 그 이벤트를 발생하는 처리 블록으로 치환
- Block 하나만 선택할 경우 접기 안 하게 해주세요
- (세션 중 덧붙인 말) “제어블록 내부더라도 블록 하나는 접을 필요 없습니다.” / “IF나 CASE는 브랜치별로 접습니다.” / “접힌 갈래로도 방향키가 들어가면 좋겠습니다.”
- Block 또는 선택영역 잘라내기/복사 기능. 이후 붙여넣기 하면 현재 선택된 Block 또는 선택영역 이후에 삽입되게 해주세요.
- (세션 중 덧붙인 말) “고른 것이 없이 붙이기 하면 아무것도 하지 마세요”
- If나 Case 처럼 나란히 lane이 있는 경우 좌우 방향키로 건너편 lane 첫번째 block으로 건너가게 해주세요.
- 가장 왼쪽 첫번째 block에서 좌방향키 클릭하면 위쪽 바같 블록으로
- 가장 오른쪽 마지막 block에서 우방향키 클릭하면 아래쪽 바같 블록으로
O의 사용법이 혼란스럽습니다. 지금 넣을 위치가뒤인지,앞인지,안쪽인지 알 수가 없어요.안쪽이고 처리블록이 선택되었을 때P하면 동작이 없는 것 같아요. 사용하면서 혼란스럽습니다.- 선택영역 +
E는 추가 선택없이 “고른 블록을 새 다이어그램으로 빼고 이벤트 달기(그 자리에는 호출 블록)“으로 동작- (세션 중 덧붙인 말) “머리가 없는 다이어그램에서도 이벤트 빼기로 합시다. 머리 달리기는 다른 단축키를 씁시다.” → 머리 달기는 M
- 접기 상태를 더블클릭하면 펼치기
- 좌우방향키로는 다이어그램간 이동 하면 안됨:
- 헤드에서라면 지금처럼 가능
- Ctrl + Shift + 좌우방향키로 이동 가능하게 할 것
- Ctrl + 상하방향키:
- 컨트롤 블록 내부라면 컨트롤 블록의 위아래 블록으로 이동
- 일반 블록이라면 그냥 위아래 블록으로 이동
- (세션 중 덧붙인 말) “다시 정의할께요. Ctrl+상하방향키는 제어블록을 내부까지 포함해서 하나의 블록으로 취급합니다. 제어블록 바로 아래 블록에서 Ctrl+위방향키 하면 그 제어블록 전체가 선택되는 식입니다.”
- Ctrl + 좌우방향키:
- IF나 Case 내부라면 좌우 옆 브랜치로
- 일반 블록이라면 그냥 위아래 블록으로 이동
- 호출 블록을 다른 이벤트/메소드를 호출하는 것으로 변경하는 방법 필요
- 호출 블록에서의 수정은 이벤트 이름바꾸기가 아니라 호출할 이벤트 선택이 편할 것 같음
- 이벤트 헤드에 같은 이름 불가하게 해야함
- (세션 중 덧붙인 말) “빈 이름을 허용하지 않게 해주세요.”
- 캔버스 전체가 선택된 것처럼 파란 굵은 선이 되는데 어떤 의미인가요? 필요한 것인가요?
- (세션 중 덧붙인 말) “캔버스에 들어오면 첫 블록을 자동으로 고릅시다”
U단축키 사용법이 혼란스럽습니다. 어쩔때는 동작하고 어쩔때는 아니에요. 접힌 상태에서는 동작하는데 펴기 상태에서는 동작을 안 합니다. 선택영역에 포함되는 모든 접기펴기 영역을 상태에 상관 없이 접기펴기 영역 해제해주세요.- (세션 중 덧붙인 말) “이름 붙은 영역보기가 안됩니다. 안 보여요” / “강조영역 기능 요구사항을 없앱시다. 혼란스럽네요. 지금은 접기/펼치기에 집중하겠습니다.”
- (세션 중 덧붙인 말) ""이름 붙은 영역” = “접기펴기 영역” 인가요? 용어를 정의한 적이 있나요?” → ""접기 영역”으로 통일합시다” / “현재는 접기영역 전체를 선택해야
F가 동작하는데 접기영역의 일부만 선택하더라고 동작하게 해주세요.” - (세션 중 덧붙인 말) “접기 영역은 중첩이 되면 좋겠어요”
- (세션 중 덧붙인 말) “Shift+F: 접기영역 설정, Ctrl+Shift+F 또는 U: 선택 영역을 온전히 다 포함하는 제일 작은 범위의 접기영역 해제, F: 선택영역을 온전히 다 포함하는 제일 작은 범위의 접기영역 접기/펴기”
- (세션 중 덧붙인 말) “1:
U는 제어블록 풀기로만 씁시다 / 2: 제어블록 선택 했을 땔F는 좀더 정의를 구체화해야겠어요. 일단 오류입니다: IF제어블록의 한 브랜치 전체를 접기영역으로 만들면 그 영역을 접기펴기하지 못하고 마치 제어블록 전체를 접기한 것처럼 동작합니다.” - (세션 중 덧붙인 말) “제어블록
F시에 접히는 부분들의 이름을 정할 수 있으면 좋겠어요. 실제로 접기 영역을 정한 것은 아니지만 접혔을 때 뭐하는 부분인지는 알 수 있어야죠.” - (세션 중 덧붙인 말) “복잡해졌네요. 문제를 간단하게 풉시다. 제어블록 선택하고
F하면 내부 브랜치의 시퀀스블록을 각각 접기 영역으로 만듭니다. 이렇게하면 제어블록F시 예외케이스가 줄을것 같아요.” - (세션 중 덧붙인 말) “접기영역의 설명이 원래 코드식을 침범하는 경우가 있습니다. 좋은 방식을 제안해주세요.” → 표시 방식 시안 네 가지를 프로토타입에 넣음
- (세션 중 덧붙인 말) “이름 띠가 좋습니다. 이름 띠를 더불클릭하면 접기도 해주세요.”
- (세션 중 덧붙인 말) “저장되는 그림은 현재 보이는 상태대로 저장하면 좋겠어요” → ADR-0018 제안
- (세션 중 덧붙인 말) “제어블록
F는 예전 방식대로 합시다. 접기영역을 만들지 마세요.” - (세션 중 덧붙인 말) “더 예전 방식이요. 이름 지정하지 않고 블록n개 표시만 나오는거요.”
- (세션 중 덧붙인 말) “맞습니다만 여기부터 다시 구체화하겠습니다. 제어블록의 브랜치 시퀀스블록 모두가 접기영역으로 되어있다면 제어블록 접었을 때 그 접기영역이 접힌 것으로 해주세요.”
- (세션 중 덧붙인 말) “근데 case나 pararell은 구현하지 않나요?” → “Case를 프로토타입에 넣어주세요”
4. 나의 결정
- dr-0002-development-order - 제안 수용: 웹 → Obsidian → 데스크톱
- (세션 중 말로) “ADR-0018 승인합니다”