2026-10-10 프로토타입 피드백

같은 날 네 번째 세션이다 (← 2026-10-10-03-inbox-review). 메인테이너가 프로토타입을 직접 써 보면서 inbox에 적은 것을 하나씩 확인하고, 그 자리에서 프로토타입을 고쳐 가며 요구사항을 정했다.

프로토타입: https://claude.ai/artifact/RuUjpc7YmCcbJXAdCeQiRG (journal/assets/2026-10-10-ns-prototype.html, 이 세션에서 33번 다시 게시함)

논의 흐름

  1. 세션 시작과 inbox. ADR을 고치는 규칙을 정했다(제안됨은 자유롭게, 승인된 것은 맨 위 “이후 변경” 콜아웃). ADR-0011을 승인했다.
  2. E 키에서 여러 다이어그램으로. “이벤트가 있으면 무엇을 할지 묻기”를 이야기하다가, 한 문서에 다이어그램 여러 개(#P1), 호출 블록, 고른 블록을 새 다이어그램으로 빼기가 요구사항에 들어갔다. 프로토타입 셋째 판.
  3. inbox의 프로토타입 항목을 하나씩. 메인테이너가 “하나씩 물어보세요”라고 해서, 항목마다 지금 동작·해 볼 것·Claude가 정한 것·질문을 보여 주고 답을 받아 고쳤다. 접기, 붙여넣기, 좌우 방향키, 넣을 위치, E, 더블클릭, 다이어그램 사이 이동, Ctrl+방향키, 호출 블록 바꾸기, 머리 이름, 캔버스 포커스 선.
  4. 접기를 여러 번 다시 정했다. 이 세션에서 가장 오래 걸린 부분이다.
    • 강조 영역이 접기와 섞여 혼란스러워서 강조 영역 요구사항을 없앴다.
    • “이름 붙은 영역”과 “접기펴기 영역”이 같은 것인지 묻는 질문에서, 용어를 접기 영역으로 통일했다.
    • 접기 영역의 키를 셋으로 나눴다: 만들기 Shift+F, 접기·펴기 F, 풀기 Ctrl+Shift+F. U는 제어 블록 풀기로만 쓴다.
    • 제어 블록의 F는 세 번 바뀌었다. 갈래별 접기 + 이름 붙이기 → “갈래마다 접기 영역을 만든다”로 단순화 → 다시 예전 방식(갈래별로 ”⋯ 블록 n개”, 이름 없음) → 갈래 전체가 접기 영역이면 그 영역을 접는다.
  5. 접기 영역을 어떻게 보여 줄지. 이름표가 블록 글자를 가린다는 지적에 시안 네 가지를 프로토타입에 넣었고, 이름 띠로 정했다.
  6. 저장되는 그림. “현재 보이는 상태대로 저장하면 좋겠어요”에서 ADR-0018을 쓰고 승인받았다. ADR-0016은 대체됨이 되었다.
  7. 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 승인합니다”