ADR-0022: 호출 블록의 이름은 Method의 머리를 따른다
이후 변경
- 2026-11-21: 다른 문서의 Method 호출을 철회하고, Method를 잃은 호출 블록(
lost)과 다른 문서의 Method(external)를 이름을 적는 호출 블록(named)으로 합쳤다. Method가 없어지면 호출 블록은 보이던 이름을 적은 호출 블록이 되어 실선이고 편집할 수 있으며, “Method 만들기”로 다시 잇는다. 위의 2026-10-17 “다른 문서의 Method를 부르면”은 지금 해당하지 않는다 → ADR-0049, R-BLK-09, R-EDIT-26- 2026-10-17: 이 문서가 남긴 “무엇으로 가리킬지”를 정했다. 호출 블록은 Method를 id로 가리키고, 다른 문서의 Method는 그 파일과 id로 가리킨다. 한 문서 안에서 같은 이름의 Method는 허용하지 않는다(메인테이너: “A2 · 1번으로 합니다. 그대로 같은 이름의 Method는 허용하지 않게 해주세요.“) → 4.4 문서 모델
- 2026-10-11: 이 문서가 정하지 않고 남긴 “결과를 적는 기호”를 정했다. 사용자가 적은 대로 보여 준다(
=로 적으면=,←나<-로 적으면←). 호출 블록의 꼴을결과 ← 이름(인자)라고 적은 곳의←는 그 한 가지 모습이다 → R-BLK-07- 2026-10-11: 이 문서가 정하지 않고 남긴 “머리에서 괄호를 지웠을 때”를 정했다. 호출 블록에 적어 둔 인자는 숨기고, 모델이 아니라 사용자 환경(파일 밖)에 기억해 둔다. 괄호를 다시 붙이면 돌아온다 → R-BLK-07
- 2026-10-11: 고치는 칸을 둘(결과 칸, 인자 칸)로 정하면서, 결과 기호는 “적은 대로”에서 “문서마다 하나(
←또는=)“로 바꿨다. 바로 위의 “사용자가 적은 대로 보여 준다”는 지금 해당하지 않는다 → R-BLK-07- 2026-10-13: 위의 2026-10-11 결정 가운데 “머리에서 괄호를 지웠을 때”를 바꿨다. 머리에서 괄호를 지우면 호출 블록의 인자는 사라지고, 편집기는 그것을 어디에도 기억하지 않는다. 괄호를 다시 붙이면 머리의 괄호 안 글자가 채워진다. 파일 밖에 기억해 둘 자리를 배포 대상마다 만들지 않으려는 것이다 → 호출 블록
- 2026-10-17: 이름을 Method의 머리에서 받지 않는 호출 블록이 둘 생겼다. 부를 것이 문서에 없으면 이름을 직접 적는다(같은 문서에 Method를 그려 이으면 그때부터 머리를 따른다). 다른 문서의 Method를 부르면 그 파일을 읽을 수 있을 때만 머리를 따른다 → R-BLK-08, R-BLK-09, M18 호출 대상 시안 https://claude.ai/artifact/RXopHw9gKu4hmz5GvFo6Vx
배경
ADR-0021에서 호출 블록의 글자를 처리 블록처럼 자유롭게 적기로 했다(그 ADR의 A1). 같은 날 프로토타입에 넣으면서 Claude가 “글자가 머리 글자와 똑같은 동안에는 머리를 고치면 함께 바뀐다”는 규칙을 더했고, 이 규칙을 확인받는 자리에서 메인테이너가 다른 규칙을 말했다.
메소드 머리글자 바꾸면 호출블록도 따라서 바뀐다. 호출블록은 새로 메소드 다이어그램을 만들 때만 호출 이름을 바꿀 수 있을 뿐, 다른 경우는 모두 기존 메소드 중에서 고를 수만 있다.
이 규칙은 A1과 맞지 않는다. A1에서는 호출 블록의 글자를 언제든 고칠 수 있고, 머리 이름을 고치면 글자와 이어진 Method가 어긋날 수 있다(ADR-0021의 “감수하는 점”).
이 ADR은 ADR-0021 가운데 인자와 결과를 적는 법(A1)만 바꾼다. Event와 Method의 구분, 머리 모양(H3), 호출 블록은 Method만 부름(C1), 단축키(S2)는 그대로다. 그래서 supersedes로 잇지 않고 ADR-0021의 “이후 변경”에 적었다.
결정 기준
- 머리 이름을 고쳐도 호출 블록과 Method가 어긋나지 않을 것
- 이름을 정하는 곳이 한 군데일 것 (Method의 머리)
- 인자가 다른 호출과 결과를 받는 호출을 그릴 수 있을 것 (ADR-0021에서 A1을 고른 까닭)
- 문장식으로 쓰는 사람에게 새로 배울 것이 적을 것
검토한 대안
시안은 journal/assets/2026-10-11-call-block-text-study.html에 있다. 안의 이름은 ADR-0021의 것을 그대로 쓴다.
A1 글자를 자유롭게 (ADR-0021의 결정)
- 장점: 쉽다. 인자와 결과를 다 적을 수 있다.
- 단점: 호출 블록에서 글자를 고칠 수 있어 메인테이너의 규칙과 맞지 않는다. 머리 이름을 고치면 옛 이름이 남는다.
A0 글자 전체가 머리와 같다
- 장점: 가장 단순하다. 호출 블록에 적을 것이 없고 어긋날 일이 없다. 메인테이너의 규칙 그대로다.
- 단점: 퀵소트의 두 재귀 호출이 같은 글자가 된다. 결과를 받을 수 없다. 그런 호출은 처리 블록으로 적어야 하고, 그러면 Method와 이어지지 않는다.
A2 이름은 따라오고, 인자와 결과만 적는다
- 장점: 이름은 머리에서만 정하고 호출 블록에서는 고르기만 한다는 규칙을 지킨다. 인자가 다른 호출과 결과를 받는 호출을 그릴 수 있다. 인자가 없는 Method는 A0와 똑같이 보인다. 이름, 인자, 결과가 따로 있어 코드 연동에 좋다.
- 단점: 머리 글자에서 이름과 인자를 가르는 규칙이 필요하다. 문장식에서 넘겨줄 것을 적으면 괄호 때문에 조금 코드처럼 보인다.
결정
A2로 한다. 메인테이너가 시안을 보고 골랐고(“A2, 권고 수용”), 세부는 Claude가 권한 대로 정했다.
- 호출 블록의 꼴:
결과 ← 이름(인자). 이름은 부르는 Method의 머리를 따르고 호출 블록에서는 고칠 수 없다. 인자와 결과만 호출 블록마다 적는다. - 이름을 적는 때: 새 Method를 만들 때뿐이다(블록을 새 Method로 빼기, “새 Method를 만들고 호출”). 그때 적는 이름이 새 Method의 머리 이름이다. 그 밖에는 있는 Method 가운데 고른다.
- 머리 글자에서 이름과 인자를 가르는 법: 첫 여는 괄호
(앞까지가 이름이고, 괄호 안은 받는 것의 이름이다. 괄호가 없으면 글자 전체가 이름이고 받는 것이 없다. - 이름이 겹치는지: 이름만으로 견준다.
sort(a)와sort(a, lo, hi)는 겹친다. - 머리 이름을 고치면: 그 Method를 부르는 호출 블록의 이름이 모두 따라 바뀐다. 적어 둔 인자와 결과는 남는다.
- 인자 칸에 처음 들어가는 글자: 머리의 괄호 안 글자 그대로(
a, lo, hi). - 넘겨줄 것이 없는 Method: 호출 블록에는 이름만 보인다. 빈 괄호를 붙이지 않는다. 호출 블록을 넣을 때 인자 칸이 열리지 않는다. 고치기(
Enter)는 결과 칸만 연다. - 이미 부르고 있는 Method의 머리에 나중에 괄호를 붙이면: 넘겨주는 것이 비어 있던 호출 블록에 머리의 괄호 안 글자를 채워 보여 준다. 사용자가 필요한 곳을 고친다.
- 부를 Method를 바꾸면(
R): 이름이 바뀌고, 적어 둔 인자와 결과는 남는다.
세부 규칙은 요구사항에 적었다 → R-BLK-07, R-BLK-11, R-BLK-10
결과
- 좋아지는 점: 머리 이름을 고쳐도 호출 블록이 어긋나지 않는다. 이름을 정하는 곳이 머리 하나다. 퀵소트의 재귀와 결과 받기는 그대로 그릴 수 있다. 코드를 만들 때 이름, 인자, 결과를 글자에서 가려낼 필요가 없다.
- 감수하는 점: 머리 글자의 괄호가 뜻을 가진다. 이름에 여는 괄호를 쓸 수 없다. 호출 블록을 고칠 때 칸이 둘(결과, 인자)이다. 인자 이름만 다른 Method 둘을 둘 수 없다.
- 후속 작업: 프로토타입에 반영한다. 파일 형식과 모델 설계에서 호출 블록이 이름을 글자로 갖지 않고 부르는 Method를 가리키게 한다(01-file-format, 01-model). 정하지 않은 것: 결과를 적는 기호(시안은
←), 머리에서 괄호를 지웠을 때 호출 블록에 적어 둔 인자를 어떻게 할지, 머리의 인자 개수와 호출 블록의 인자 개수가 다를 때 알려 줄지 → outbox