DRAFT작업 노트입니다. 출간된 글이 아니며, 자유롭게 갱신·재구성됩니다.
CodePoet / Essay
역명세화6 / 10

역명세화의 절차

결과물에서 받는 쪽 명세를 다시 짜는 행위를 네 단계로 분해한다. 머릿속의 자동 작업을 손으로 옮기는 절차. 시리즈 '역명세화' 6편 — Part 3 시작.
2026-05-17
역명세화방법론절차시리즈6편

머릿속에서 손으로

2편에서 역명세화에 이름을 붙였다. 매일 머릿속에서 자동으로 일어나는 행위. 그게 조직의 자산이 되려면 머릿속에서 손으로 옮겨야 한다.

손으로 옮긴다는 건 절차로 만든다는 뜻이다. 누가 따라가도 같은 자리에 도달할 수 있게.

절차 — 네 단계

  1. A. 받는 쪽 모양을 먼저 적는다 — 결과물부터 보지 않는다
  2. B. 결과물의 부품 경계를 잡는다 — 분해 가능한 형태로
  3. C. 어댑터를 식별한다 — 부품과 모양 사이의 변환
  4. D. 변환된 결과를 받는 쪽에 끼워본다 — 안 끼워지면 A로

순서가 중요하다. 결과물부터 보면 출력 측의 형식에 끌려간다. 받는 쪽 모양부터 봐야 어디까지를 변환할지가 정해진다.

A — 받는 쪽 모양을 먼저 적는다

이건 4편의 모양 그리기를 절차로 옮긴 단계다.

받는 쪽 사람에게 묻는다 — 당신의 부품은 어떤 입력을 받는가. 형식·필드·예시. 빠진 게 있으면 그 자리에서 받아낸다. 받는 쪽이 자기 부품의 입력을 모르고 있다면 그게 먼저 채워질 자산이다.

이 명세가 안 적힌 상태에서 다음 단계로 가면 안 된다. 그 명세 자체가 가장 비싼 산출물이다.

B — 결과물의 부품 경계를 잡는다

결과물은 보통 한 덩어리로 보인다. 한 덩어리에서 받는 쪽 모양으로 가는 변환은 너무 크다.

그래서 결과물을 부품으로 분해한다. 입력 경계, 출력 경계, 내부와 외부의 차이가 보이는 단위로. 모델 출력이면 — 어느 필드가 어떤 의미인지, 어디가 모듈 경계인지.

부품 경계가 안 잡히면 변환은 한 덩어리 → 한 덩어리가 된다. 그건 변환이 아니라 재작성이다.

C — 어댑터를 식별한다

A의 모양과 B의 부품 사이에, 한 줄짜리 변환이 보인다.

부품 X의 필드 a → 받는 쪽 모양의 필드 a' (형식 변환 1회)

이 한 줄이 어댑터다. 어댑터가 안 보이면 — 부품 단위가 너무 크거나, 받는 쪽 모양이 너무 모호하다. B 또는 A로 돌아간다.

어댑터 한 줄로 안 풀리면 거의 항상 명세가 부족하다. 더 짜는 것이 답이지, 변환을 복잡하게 만드는 게 답이 아니다.

D — 끼워본다

어댑터로 변환한 결과를 실제 받는 쪽 부품에 끼운다. 끼워지면 끝. 안 끼워지면 — 어느 단계의 명세가 어긋났는지 본다. 대개 A의 모양이 받는 쪽이 말한 모양이 아니라 내가 추측한 모양이었던 경우가 많다.

D는 현실 테스트다. 머릿속에서 끝내면 안 된다.

이 절차는 IP가 아니다

여기까지가 절차다. 흐름은 단순하다. 복잡한 게 따로 있다.

각 단계에 들어가는 질문 세트템플릿이 진짜 작업물이다. A 단계에서 "어떤 입력을 받는가"를 끌어내는 질문, B 단계에서 부품 경계를 그리는 질문, C 단계에서 어댑터 후보를 좁히는 질문 — 이게 모이면 현장에서 쓸 수 있는 도구가 된다.

이 시리즈의 본문에서는 절차의 원리까지를 적는다. 완전한 질문 세트와 템플릿은 별도 자리로 분리해둔다 — 그게 컨설팅으로 가는 길이다.

다음 두 편은 절차에 들어가는 두 자산 — 팀 프로토콜과 자산 인벤토리 — 을 어떻게 만드는가로 들어간다.

이 글에 남긴 포스트잇0

아직 포스트잇이 없어요. 첫 자리를 남겨보세요.

이어 읽을 글
감정은 신호였다될지 안 될지 모르는 일을 기한 안에 해내야 하는 요즘, 가장 고약한 건 모르는 걸 모르는 상태였다. 사람에게는 AI에 없는 센서가 있다 — 감정이다. 화남·슬픔·억울함·감동은 내가 모르던 무언가가 근처에 있다는 신호이고, 모델이 loss로 배우듯 사람은 감정으로 모름을 감지한다. 감정을 신호로 읽기 시작하자 마음의 힘듦과 해야 할 일·해야 할 말이 갈라졌다 — 재촉하는 사람의 불안도 같은 신호였다. 그리고 사람도 환각한다 — 모른다는 걸 모른 채 아는 해법으로 문제의 본질을 덮는다. 부딪혀야 신호가 온다.무한 루프는 버그가 아니었다팀과 팀 사이에서 매일 일을 나누다 발견한 조직의 작동 원리. 팀마다 목적이 하나씩 뚜렷할 때 서로의 견제는 상승효과가 되고, 이 루프가 멈추지 않는 것이 목표다 — 옳은 말이 일이 되어 돌아오면 루프는 멈추고, 새 일은 언제나 R&R의 회색지대에서 태어난다. 회색지대의 일에 필요한 것은 끌어안는 사람, 아니면 빠른 지정이다.머릿속에서 MSA는 그려지는데 고양이는 안 그려진다MSA라는 말엔 설계도가 펼쳐지는데, 고양이라는 말엔 색도 질감도 없는 흐릿한 형체 하나만 뜬다는 걸 알아챈 날의 기록. 딸은 오만가지 고양이를 재잘거리는데, 나는 언제부턴가 세상을 요약만 하고 있었다 — 좋아한다는 게임조차 뜯어본 적 없이 심볼로 봤다. 설계도가 선명하고 고양이가 흐릿한 건 재능의 배치가 아니라 시간의 배치였다. 개발을 배우던 방식을 그대로 옮긴다 — 많이 보고, 역기획서로 뜯어보고, 직접 그린다. 끝그림은 나만의 그림체로 내 것을 만드는 것. 시리즈 '프로그래머가 그림을 배우는 방법' 1편.
dev · 2026. 9. 20.