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 덕에 공책이 다시 내 손에 돌아왔다. 만드는 기술을 배우는 재미는 AI가 가져갔지만, 사람이라는 끝없는 판이 남아 있었다. 그리고 오래 붙든 콘텐츠는 하나같이 무언가를 가르쳐 줬다 — 누군가 그걸 깨닫고 웃는 얼굴을 보는 것, 그게 충만감이었다.그만두고 싶은 이유를 세어 보았다리더를 그만두고 싶다는 마음이 올해 내내 있었다. 디렉터와 이야기하기 전에 그 이유를 하나씩 세어 보았다. 가운데 낀 양가감정, 실무를 못 하는 우울, 줄 수 있는 게 칭찬뿐인 손, 끝이 없는 목표, 정해지지 않은 AI 사용료. 아무나 할 수 있게 해 주는 건 저점을 올리는 일이지 고점을 올리는 일이 아니라는 것도 보였다. 세다 보니 이유들이 한 곳을 가리켰다 — 일은 한데 모였는데, 일하는 판은 각자 하던 때 그대로였다. 하소연 말고 가안 한 장을 들고 가기로 한다. 그만두고 싶은 마음은 그대로인 채로. 다시 읽고서야 R&R은 어떻게 짜든 부딪힌다는 것, 가장 큰 빈칸은 내 기준이었다는 것이 보였다.북쪽이라고만 말했다한참 준비한 일을 사내 소프트런칭으로 내놓았고 결과도 좋았다. 잠깐 행복했고, 그다음엔 우울이 왔다. 대기업과의 경쟁, 모호한 지시, 북쪽을 보자는데 동쪽 서쪽으로 뛰는 사람들, 그리고 일 잘하던 팀원의 퇴사. 위에서 내려오는 말이 흐릿하다고 답답해하던 내가, 아래에는 '북쪽'이라는 방향 한마디만 건넸다는 걸 알았다. 사람을 움직이는 건 내가 열심히 해서 되는 일이 아니었다. 내가 요구할 수 있는 건 기대하는 결과를 분명히 하는 것뿐이었다 — 아직 우울한 채로, 그 말하는 법부터 연습하기로 한다.
v2026.10.31.1 · 2026. 11. 1.