Workspace IndexKnowledge NotesEng › The function is fine. Who can call it?

#2001Review2026-09-16done 2026-09-18

The function is fine. Who can call it?

Priya's PR adds an admin pause to Verex settlement. The feature is needed; the PR never says who holds the switch or what turns it back on.

Why this conversation

The most useful review move in this genre: agree with the feature in two words, then ask for the paperwork without sounding like a block.

Dialogue

Priya: This adds a pause so we can stop settlement if the oracle goes bad. I think it's uncontroversial.

Jay: The function is. What I can't find in the PR is who can call it, and what un-pauses it.

Priya: Owner only, for now. We'd un-pause by hand once we've looked.

Jay: Reasonable start. I'd want those two sentences somewhere that isn't a code comment. "For now" and "by hand" are what an auditor asks about, not the modifier.

Priya: Where, then?

Jay: A three-column table in the repo: what a human can do, who and how, when we give it up. Even TBD in the third column beats the column not existing.

Priya: It'll be TBD for everything today.

Jay: That's honest. A table full of TBDs is a roadmap. A missing table is a question we answer under pressure later.

Key expressions

Expression뜻 · 쓰이는 자리
it's uncontroversial논란의 여지가 없다
who can call it누가 호출할 수 있나
what un-pauses it무엇이 해제하나
owner only, for now지금은 오너만
a reasonable start합리적인 출발점
somewhere that isn't a code comment코드 주석이 아닌 어딘가에
when we give it up언제 내려놓는가
TBD (to be determined)미정
beats the column not existing열이 없는 것보다 낫다
answer it under pressure later나중에 압박 속에서 답하다

← English · All Notes · Top ↑

함수는 괜찮다. 누가 호출하나?

Priya의 PR이 Verex 정산에 관리자 일시정지를 추가한다. 기능은 필요하지만, 누가 스위치를 쥐는지와 무엇이 다시 켜는지가 PR에 없다.

왜 이 대화인가

이 장르에서 가장 유용한 리뷰 기술. 두 단어로 기능에 동의한 뒤, 막는 것처럼 들리지 않게 문서를 요구한다.

대화

Priya: 오라클이 이상해지면 정산을 멈출 수 있게 일시정지를 추가했습니다. 논란의 여지가 없다고 봅니다.

Jay: 함수는 그렇습니다. PR에서 못 찾는 건 누가 호출할 수 있고 무엇이 해제하는가예요.

Priya: 지금은 오너만이요. 확인한 뒤 수동으로 풀 겁니다.

Jay: 합리적인 출발입니다. 그 두 문장을 코드 주석이 아닌 곳에 두고 싶어요. 감사자가 묻는 건 modifier가 아니라 "지금은"과 "수동으로"거든요.

Priya: 그럼 어디에요?

Jay: 레포에 세 열짜리 표요. 사람이 할 수 있는 것, 누가 어떻게, 언제 내려놓는가. 세 번째 열이 미정이어도 열이 없는 것보다 낫습니다.

Priya: 오늘은 전부 미정일 텐데요.

Jay: 그게 정직한 거죠. 미정으로 가득한 표는 로드맵이고, 없는 표는 나중에 압박 속에서 답할 질문입니다.

협업 기법 세 가지

  1. 기능과 문서를 갈라서 말한다. "The function is. What I can't find is…" 첫 두 단어로 기능에 동의한다고 못 박으면 뒤의 요구가 반대로 들리지 않는다.
  2. 제3자의 눈으로 번역한다. "what an auditor asks about" 상대가 사소하게 본 단어가 왜 중요한지 제3자 기준으로 말하면 취향 싸움이 되지 않는다.
  3. 빈칸을 허용해 문턱을 낮춘다. "Even TBD beats the column not existing." 완성도를 요구하면 아무도 시작하지 않는다. 표가 생기면 채워진다.

← English · 전체 노트 · 맨 위 ↑