2026-10-13 단축키에 Vim 키를 들이다

2026-10-13의 첫 세션이다 (← 2026-10-12-01-docs-restructure). “리뷰가 끝난 뒤”로 미뤄 두었던 단축키 설계를 메인테이너가 앞당겼다. Vim 키를 들이기로 하고, 프로토타입을 38번째 판에서 45번째 판까지 여덟 번 고쳐 게시했다. 중간에 inbox를 검토했고, 리뷰 2판(풀기)이 함께 들어갔다.

논의 흐름

  1. “vim 단축키 진행합시다. 이거 하고 싶어요. vim 단축키 중 어떤 것들을 도입할지 제안해주세요.” Claude가 상태 문서를 읽고, 프로토타입의 지금 키를 모아 제안을 냈다. 편집기의 세 상태(블록을 고름, 글자를 고침, 영역을 고름)가 Vim의 세 모드와 짝이 맞는다는 것을 바탕으로, 들일 키의 표와 들이지 않을 것, 정할 것 넷을 적었다.
  2. “1: 추천수용, 2: 추천 수용, 3: 추천 수용, 4: 추천 수용” 키 배열 하나, 고치다 누른 Esc는 받아들임, a + 종류로 넣기, dd는 잘라내기. Claude가 ADR-0025와 단축키 표 초안을 쓰고, 프로토타입에 “Vim 키 (시험)” 스위치를 넣어 38번째 판으로 게시했다. 진행 중인 리뷰를 흔들지 않으려고 기본값은 옛 키로 두었다.
  3. “vim 키를 끄고 키는 기능이 필요한가요? 혹시 vim 키를 키면 충돌이 나나요?” 제품에는 필요 없고 프로토타입의 임시 장치라고 답했다. 켜도 충돌은 없지만, 같은 글자가 두 배열에서 뜻이 달라 함께 켜 둘 수는 없다는 표를 보였다. 한글 입력 상태만 확인하고 없애자고 추천했다.
  4. “한글 입력 상태에서 vim 단축키 j, dd, zf가 잘 동작합니다.” Claude가 스위치와 옛 키를 없애고 39번째 판을 게시했다. 없애라는 말은 없었다. 바로 앞의 추천을 따른 것이다.
  5. “inbox 체크해주세요” 새 항목 다섯과 10-11부터 남은 하나가 있었다. 분명한 넷(머리에서 dd, 안내 문구, 설정 이름, 위·아래 이동)은 바로 넣어 40번째 판으로 게시했고, 셋은 물었다.
  6. “헤더에서는 x와 d를 동일하게 delete로 해주세요” 머리에서 x도 머리 떼기로(41번째 판).
  7. “1. 지금대로 2. 다이어그램 지우기는 단축키 없음. 블록도 ‘x’를 ‘delete’와 동일하게 3. 확인하고 싶습니다 부분을 검토했나요?” x를 어디서나 Delete와 같게 했다(42번째 판). 3번은 Claude가 “키가 같다”고만 답했던 것을 메인테이너가 되물은 것이다. 프로토타입의 동작을 맞대어 보니 다른 곳이 셋 있었다.
  8. “3-1: 추천 수용 3-2: Q-7이 뭐지요?” 펴 보인 안쪽에서 za를 맞췄다(43번째 판). Claude가 번호만 적고 설명하지 않았던 Q7을 표로 다시 설명했다.
  9. “vim 단축키를 도입한 이유는 vim 사용자에게 친숙한 환경을 제공하기 위함입니다. 그점도 고려가 되면 좋겠습ㄴ디ㅏ.” 이 세션의 전환점이다. Claude의 추천은 “규칙의 수를 줄이는 것”만 기준으로 삼고 있었다. Vim에서 그 키가 실제로 어떻게 움직이는지로 다시 보니 Q7의 추천이 뒤집혔고(풀기를 하나로 → ds와 zd를 따로), Vim과 어긋난 곳 넷이 더 나왔다.
  10. “1~7 모두 추천 수용” 호출 블록 풀기, 안쪽에서 ds, i · cc, Ctrl+R, V, zo · zc(44번째 판).
  11. “zR, zM도 합시다” 모두 펴기 · 모두 접기(45번째 판).
  12. “마무리”

결정

무엇결정어디에
단축키의 방향표준 키 위에 Vim 키를 얹는다. 키 배열은 하나, 설정으로 켜고 끄지 않는다ADR-0025
고치다 누른 Esc적은 대로 받아들인다 (Enter와 같음)ADR-0025, ux-decisions Q3
블록 넣기처리 블록은 o / O, 그 밖은 a / A + 종류ADR-0025
dd잘라내기. x는 Delete와 같다(복사 없이 지우기). 머리에서는 둘 다 머리 떼기ADR-0025, 03-keymap
다이어그램 지우기글자 키를 두지 않는다03-keymap
키를 정하는 기준Vim에서 그 키가 실제로 어떻게 움직이는지를 먼저 본다. 다르게 만들 때는 까닭을 적는다03-keymap
푸는 명령 (Q7)껍데기 풀기 ds(제어 블록, 호출 블록. 안쪽에서도 들음)와 접기 영역 풀기 zd를 따로 둔다ux-decisions Q7
호출 블록 풀기 (Q16, Q17)Method의 블록들을 글자 그대로 복사한다. 인자와 결과는 사라진다. 이어진 곳이 없으면 풀 수 없다ux-decisions 4.2, R-EDIT-08
펴 보인 안쪽에서 접기 · 펴기가장 가까운 펴 보인 호출 블록이 접힌다ux-decisions 4.1
위·아래 이동If · Case의 옆 갈래로 넘어가지 않는다. 갈래의 끝에서 아래로는 그 If · Case의 다음 블록, 처음에서 위로는 그 If · Case02-interaction-rules
글자 고치기를 여는 법i는 글자를 두고 커서를 맨 앞에, cc는 비우고 새로, Enter · F2는 전체를 고른 채로03-keymap
더한 키Ctrl+R 다시 하기, V, zo · zc, zR · zM03-keymap
설정의 이름”접기 영역 이름 띠 보기” → “접기 영역 보기”프로토타입

발견한 것과 위험

  • Claude의 추천은 기준 하나에 치우쳐 있었다. 10-11의 UX 검토는 “같은 일을 같은 방법으로”가 기준이었고, Claude는 Vim 키를 들인 뒤에도 그 기준으로만 추천했다. 메인테이너가 Vim 키를 들인 까닭을 말하자 Q7의 추천이 뒤집혔다. 남은 물음(Q1 · Q2 · Q4Q6 · Q8Q12, Q19~Q21)의 추천도 같은 눈으로 다시 봐야 한다. 특히 Q8(“내용을 바꾸는 명령은 고른 것에만”)은 안쪽에서 듣는 ds와 이미 어긋난다 → backlog
  • Claude는 물음을 검토하지 않고 답했다. inbox의 “단축키를 통일할 수 있나요?”에 두 번(10-11, 이번 세션) “된다”고만 답했다. 메인테이너가 “검토했나요?”라고 되묻고서야 프로토타입의 동작을 맞대어 보았고, 다른 곳 셋을 찾았다.
  • Claude는 설명 없이 번호를 썼다. “Q7을 1로 정할까요”라고 물었고 메인테이너는 Q7이 무엇인지 몰랐다.
  • 글자를 자판의 자리로 읽는다. 그래서 한글 입력 상태에서도 듣는다(브라우저에서 메인테이너가 확인). 대신 QWERTY가 아닌 배열(Dvorak, AZERTY)에서는 키에 적힌 글자와 맞지 않는다. 제품에서 어떻게 할지는 정하지 않았다 → keyboard-keys-and-ime, 03-keymap
  • 안쪽에서 누른 ds는 고르지 않은 제어 블록을 바꾼다. Vim(vim-surround)과 같지만 놀랄 수 있다. 써 보고 본다.
  • 프로토타입의 화면을 거의 보지 못했다. 시험은 131개가 통과했지만 화면은 39번째 판 한 장만 보았고, 그때 찾은 것(키 표의 설명 칸이 좁음)을 고친 뒤로는 다시 보지 않았다 → 시험한 곳과 못 한 곳
  • 이 컴퓨터의 헤드리스 Chrome은 웹 글꼴을 기다리다 페이지 스크립트를 돌리지 않았다. 시험이 첫 단계에서 멈춰 원인을 찾느라 돌았다. 글꼴 줄을 뺀 사본으로 시험했다. 끝나지 않은 시험이 남긴 Chrome이 다음 시험의 포트를 잡고 있던 것도 한 번 겪었다. 시험 스크립트의 머리에 적어 두었다.
  • claude.ai의 페이지를 고쳐 올릴 때 “지금 올라가 있는 판을 읽었는가”를 확인받는다. 올라가 있던 판이 커밋된 사본과 같다는 것을 맞대어 본 뒤 올렸다.
  • 프로토타입이 리뷰 중에 여덟 번 바뀌었다. 메인테이너가 1판을 써 보던 중이었다. 단축키가 통째로 바뀌었으므로 1판의 느낌은 새 키로 다시 들어야 한다.

커밋

커밋무엇프로토타입
4b563a4ADR-0025, 단축키 표 초안, Vim 키 스위치38번째 판
04da496스위치와 옛 키를 없애고 Vim 키만 남김39
11322cdinbox: 위·아래 이동, 머리에서 dd, “접기 영역 보기”, 안내 문구40
8fce926머리에서 x41
009d0dex는 Delete와 같게42
9f7562d펴 보인 안쪽에서 za43
fba6373Vim에 맞춤: 호출 블록 풀기, 안쪽에서 ds, i · cc, Ctrl+R, V, zo · zc44
d297378zR · zM45

한 일 (할 일 목록에서 옮김)

  • 단축키 다시 설계: Vim 키(H J K L, V, P O 등), 사실상 표준은 유지, 겹치는 키 정리 → 큰 줄기 넷을 정함(ADR-0025). 키 표의 초안은 03-keymap, 프로토타입 39번째 판부터 이 키로 돈다
  • 단축키 전체 정리: 프로토타입에서 임시로 고른 키(M, K, +, -, L, G, C 등)를 모아 요구사항이나 설계 문서에 정한다 → 03-keymap의 표에 모음
    • (2026-10-10에 부채 목록에 적은 말) 프로토타입에서 임시로 고른 단축키(M 머리, K Case, + - L 갈래, G 따라가기, C 호출)를 요구사항에 적지 않음. 단축키를 한꺼번에 정할 때 다룰 것 (2026-10-10)
  • 프로토타입 리뷰 2판: 풀기 (Q7, Q16, Q17) → 정하고 44번째 판에 넣음. 써 보는 일이 남음

처리한 부채 (부채 목록에서 옮김)

  • ux-decisions의 물음 가운데 Q3 · Q7 · Q16 · Q17 → 정함 (위 “결정”)
  • inbox의 “단축키를 통일할 수 있나요?”(호출 블록 펴기와 접기 영역 펴기, 호출 블록 치환과 제어 블록 풀기)에 “된다. Q7과 접기 · 펴기 명령이 그것”이라고 답함. 메인테이너의 확인을 받지 못해 inbox에 남겨 둠 (2026-10-11) → 이번 세션에 다시 검토해 닫음 (아래 “inbox 원문”)
  • “브랜치 처음에서 위로 이동하면 제어블록 위 블록으로”를 그 If · Case 자신으로 간다고 풀이한 것 → 메인테이너: “1. 지금대로”

inbox 원문 (지운 항목)

메인테이너가 세션 중에 “inbox 체크해주세요”라고 했다. 아래는 그때 처리하고 지운 항목의 원문이다. “3. 기능 › 프로토타입”에 있었다.

  • 단축키
    • 헤더에서 dd하면 delete와 동일하게
  • “같은 부모 안에서만 영역을 넓힐 수 있습니다” 메세지 출력할 대 접기 영역 보기가 체크 안 되어있다면 이 점도 안내해주세요.
  • “접기 영역 이름 띠 보기” → “접기 영역 보기”

처리: 셋 모두 프로토타입 40번째 판에 넣었다.

  • 머리에서 dd는 머리 떼기다(Delete와 같음) → 03-keymap. 이어서 메인테이너가 “헤더에서는 x와 d를 동일하게 delete로 해주세요”라고 해, 머리에서는 x도 머리 떼기로 했다(41번째 판)
  • 영역을 넓힐 수 없다는 안내에, “접기 영역 보기”가 꺼져 있으면 꺼져 있어서 경계가 보이지 않는다는 말을 덧붙인다
  • 설정의 이름을 “접기 영역 보기”로 바꿨다

메인테이너의 답(“1. 지금대로 2. 다이어그램 지우기는 단축키 없음. 블록도 ‘x’를 ‘delete’와 동일하게”)을 받고 둘을 더 지웠다.

  • 단축키
    • x를 delete와 동일하게 검토
  • if/case에서 브랜치 마지막에서 아래로 이동하면 옆 브랜치로 이동이 아니라 제어블록 다음 블록으로. 브랜치 처음에서 위로 이동하면 제어블록 위 블록으로

처리:

  • x는 블록에서도 Delete와 같다(복사 없이 지우기). 영역 고르기 중의 x도 잘라내기에서 지우기로 바꿨다. 다이어그램 지우기에는 Vim 키를 두지 않는다(42번째 판)
  • 위·아래로는 If · Case의 옆 갈래로 넘어가지 않는다. 갈래의 처음에서 위로는 그 If · Case 자신으로 간다(Claude의 풀이를 메인테이너가 “지금대로”로 확인) → 키보드로 이동하고 삽입하기

2026-10-11부터 남아 있던 항목도 닫았다.

  • 확인하고 싶습니다. 다음 쌍들이 유사해보입니다. 단축키를 통일할 수 있나요?
    • 호출 블록 펼치기/원래블록보이기 vs. 접기영역 펼치기/접기
    • 호출 블록 치환 vs. 제어블록 벗기기

처리:

  • Claude는 처음에 “키가 같다”고만 답했다. 메인테이너가 “확인하고 싶습니다 부분을 검토했나요?”라고 되물었고, 프로토타입의 동작을 맞대어 보니 키는 같아도 동작이 다른 곳이 셋 있었다(안쪽에서 za, 접힌 것을 더블클릭, 띠를 더블클릭)
  • 펴기 · 접기: za 하나다. 펴 보인 안쪽에서 눌러도 가장 가까운 펴 보인 호출 블록이 접히게 맞췄다(43번째 판). 더블클릭은 ux-decisions Q2에서 함께 맞춘다
  • 치환과 벗기기: ds 하나다. 호출 블록에서는 Method의 블록들로 바꾸고, 제어 블록에서는 벗긴다(44번째 판) → ux-decisions Q7 · Q16 · Q17

inbox에 남은 항목은 없다.

다음 할 일

  • 메인테이너가 프로토타입 45번째 판을 Vim 키로 써 보기. 리뷰 1판(접기 영역의 막대, 호출 블록 펴 보기)과 2판(풀기)의 느낌을 함께 듣는다 → 리뷰 순서
  • Claude가 정해 놓고 확인받지 못한 것은 확인해 주세요의 맨 위 세 묶음
  • 다음은 리뷰 3판(고치기 규칙, Q1 · Q2 · Q4). 그 전에 남은 물음의 추천을 Vim의 눈으로 다시 본다 → backlog

마무리

  • 메인테이너의 말: “마무리”
  • 기술 설명은 keyboard-keys-and-ime에 정리했다(키보드 이벤트의 글자와 자리, 한글 입력기, 브라우저가 가져가는 키).