코드가 아니라 문서를 먼저 만든다 — 설계 단계가 남기는 다섯 갈래

앞 편은 다섯 칸을 순서대로 지나 착수 · 보류 · 추가조사 가운데 하나를 냈다. 이 편은 착수 판정을 받은 착상이 그다음에 무엇으로 바뀌는지를 다룬다. 답부터 적으면 코드가 아니라 문서다.

만들기로 정해졌으니 곧바로 만들면 될 것 같지만, 그 사이에 나중에 바꾸기 어려운 결정 다섯 개를 미리 골라 적어 두는 단계가 있다. 다루는 것은 그 다섯 결정과 거기서 나오는 산출물까지이며, 그 산출물을 어떤 표준 형식으로 굳히는지는 다음 편의 몫이다.

설계대에 올라가는 것과 내려오는 것

마지막 줄이 이 단계의 위치를 정한다. 잘 그린 구조도는 그 자체로 설득력이 있어서 판정을 대신하기 쉬운데, 그러면 증거로 여는 문을 도면으로 여는 셈이 된다.

그렇다면 보류를 받은 건은 설계할 이유가 없어 보인다. 반대다. 「통과한다면 어떻게 만들 것인가」를 미리 그려 보면 무엇을 확인해야 하는지가 좁아진다. 층을 가르는 순간 어느 층이 검증되지 않았는지 드러나고, 모델을 배치하는 순간 어느 값을 아직 모르는지 드러난다. 설계는 검증의 해상도를 높이는 도구이지 통과의 근거가 아니다.

다섯 갈래가 다섯 결정을 맡는다

설계는 한 덩어리로 하는 일이 아니라 다섯 갈래로 나뉘고, 갈래마다 나중에 바꾸기 어려운 결정 하나씩을 맡는다.

다섯의 공통점은 되돌리는 값이 크다는 것이다. 화면 배치나 문구는 나중에 고쳐도 값이 거의 들지 않지만, 이 다섯은 만든 뒤에 바꾸려면 이미 쌓은 것을 걷어 내야 한다. 설계 단계가 코드가 아니라 문서를 남기는 이유가 여기에 있다 — 문서는 고치는 값이 싸고, 이 다섯 결정은 고칠 일이 반드시 한 번은 생긴다.

흐름의 뼈대를 먼저 고른다

첫 갈래는 부품을 어떤 모양으로 잇는지를 정한다. 후보는 넷이고, 고른 이유를 세 문장으로 적는 것까지가 이 갈래의 산출물이다.

네 패턴은 성능이 아니라 관계로 갈린다. 순차는 뒤가 앞을 기다리고, 병렬은 기다리지 않으며, 분기는 하나만 고르고, 위임은 하나가 나머지를 부린다.

세 층으로 가르고 만들 곳만 만든다

층을 가르는 일은 곧 직접 만들 곳을 하나로 좁히는 일이다. 차별화되는 자리에만 힘을 쓴다는 판단이 층 구분과 정확히 겹친다.

무엇을 기억할지가 곧 프라이버시 설계다

쓰는 사람과 값을 내는 사람이 다른 구조에서는 「이것이 누구의 데이터인가」가 그대로 설계 질문이 된다. 사용자가 보는 화면에는 개인의 것을 두고, 값을 내는 쪽이 받는 보고서에는 합쳐 놓은 수치만 남긴다. 이렇게 갈라 두는 일 자체가 제품 설계이지 저장소 설정이 아니다.

경계는 처음에 그으면 선 하나지만 나중에 그으면 구조 전체를 다시 짜는 일이 된다.

작업마다 다른 모델을 붙인다

두 줄뿐이지만 이 표가 단위경제의 절반을 정한다. 앞 편의 원가 계산이 한 건에 드는 값을 재는 장치였다면, 이 배치는 그 값을 실제로 결정한다.

왜 안 망하는지를 네 항목으로 적는다

네 항목은 「좋은 제품인가」를 묻지 않는다. 무엇이 이것을 무너뜨릴 수 있는가를 묻는다. 마지막 항목이 구조 안에 없는 위험을 담는 자리인데, 쓰던 모델의 값이나 정책이 바뀌면 구조가 아니라 사업이 흔들린다.

쓰는 사람과 내는 사람이 다르다

설계를 가르는 질문은 「시장이 큰가」가 아니라 **「누가 값을 내는가」**다. 내는 쪽의 지불 의향을 보지 않으면 사용 화면을 아무리 잘 만들어도 구조 전체가 헛돈다.

무엇을 누구에게 보여 줄지도 여기서 갈린다. 사용자에게 평가 점수를 그대로 내보이면 불이익을 걱정해 오히려 위축되는 일이 생길 수 있다. 누구에게 무엇까지 보일지를 설계 시점에 갈라 둔 사례가 있는데, 화면 문제로 보이지만 실은 제품 전략 문제다.

한 번에 한 시장만 고른다

셋째 줄이 앞 편과 이어지는 자리다. 하지 않기로 한 시장을 이유와 함께 남겨 두면 그것이 다음 판정에서 대조할 기록이 된다.

건너뛰면 무엇을 치르는가

다섯 줄 가운데 마지막이 가장 늦게 드러난다. 앞의 넷은 만드는 쪽에서 끝나지만 마지막 것은 이미 쌓인 데이터를 건드려야 해서 되돌리는 값이 다른 층에 있다.

무엇을 맡기고 무엇을 직접 하는가

왼쪽은 전부 나열과 계산이고 오른쪽은 전부 선택과 책임이다. 다섯 줄 모두 도구가 후보를 만들고 사람이 하나를 고르는 형태인데, 앞 단계와 달리 여기서는 고른 것을 되돌리는 값이 특히 크다.

이 편이 쓴 용어

아래는 지도편이 모아 둔 낱말 가운데 이 편의 본문에 등장한 행이다.

정리

세 가지가 이 편에 남는다.

첫째, 설계 단계가 남기는 것은 코드가 아니라 문서다. 다섯 갈래가 정하는 것은 전부 되돌리는 값이 큰 결정이고, 그런 결정은 고치는 값이 싼 자리에서 먼저 확정돼야 한다.

둘째, 설계는 통과를 만들지 않는다. 구조도가 아무리 설득력 있어도 판정은 앞 편의 게이트가 낸다. 보류를 받은 건을 설계하는 이유도 통과시키기 위해서가 아니라 무엇을 확인할지 좁히기 위해서다.

셋째, 값이 드는 자리와 차별화되는 자리는 서로 다른 곳에 있다. 층을 가르면 직접 만들 곳이 하나로 좁혀지고, 모델을 배치하면 한 건당 값이 정해진다. 두 결정이 만나는 자리가 단위경제다.

다음 편은 이 문서들을 실제로 만드는 단계에 넘긴다. 무엇이 갖춰져야 만들기 시작할 수 있는지, 그리고 요구사항 문서를 매번 다시 쓰지 않도록 표준으로 굳히는 방법이 거기서 갈린다.