본문 바로가기
C.W.K.
Stream
Lesson 04 of 04 · published

조율하고 기록해, 집필은 절대 안 해

~11 min · architecture, boundaries, workshop, design

Level 0젖은 흙
0 XP0/36 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete

집필을 빼고 나면 뭐가 남을까

내용물 결함을 측정한 다음 짓고 싶어지는 도구는 더 나은 내용물을 뽑는 도구야. 이건 그 도구가 아냐. 집필을 통째로 걷어내면 일이 넷 남는데, 알고 보니 하중을 받는 게 그 넷이야.

큐잉. 작업 단위가 누가 시작하기 전에 기록으로 먼저 존재해. 어떤 파이프라인인지, 대상이 뭔지, 누가 쓰고 누가 리뷰하는지, 그리고 뭘 원하는지 적은 브리프까지. 큐에 안 들어간 작업은 추적이 안 되고, 서술되기 전에 시작한 작업은 그 사람이 하고 싶던 무엇이 돼버리는 경향이 있어.

계약. 그 작업의 단계마다 허용 입력, 금지 입력, 그리고 그 단계를 닫는다는 게 뭔지를 선언해. 앞 강의의 사다리 칸이 실제로 사는 자리가 여기야.

기록. 모든 단계 경계에서 그 일이 벌어지는 순간에, 누가 뭘 갖고 돌렸는지까지 실어서 항목을 써. 나중에 쓰는 요약이 아니라 도중에 쓰는 항목이야.

직렬화. 세션 둘이 동시에 착지했다가 충돌을 사후에 발견하는 일이 없게, 결과물이 착지하는 순간을 잠금 아래 붙잡아.

넷 중 어느 것도 도구가 문장에 대해 의견을 가질 것을 요구하지 않아. 그게 요점이고.

경계가 왜 절대적이어야 하냐면

집필까지 하는 작업장은 자기가 관찰하려고 지어진 당사자 중 하나가 조용히 돼버린 거야. 기록은 증거이길 그만둬. 기록하는 것이 기록되는 것이 됐으니까. 단계 계약도 중립이길 그만두고. 단계가 뭘 볼 수 있는지도, 그 단계가 뭘 내놓는지도 자기가 정하니까. 리뷰도 경계를 넘는 일을 그만둬. 저자랑 하네스가 같은 행위자니까.

야심을 금지하는 규칙이 아냐. 온도계가 방을 데우지 않는 거랑 같은 이유야. 참여하는 계기는 더 이상 계기가 아니고, 참여시키자는 논거는 전부 이 도구를 지을 값어치가 있게 만들었던 측정값을 포기하자는 논거야.

비유가 정확해

도공이 그릇을 빚어. 가마는 아무것도 안 빚어. 통제된 열을, 통제된 순서로 주고, 소성 일지를 남길 뿐이야. 그릇이 갈라지면 일지가 승온 속도랑 유지 시간이랑 누가 쟁였는지를 알려줘. 그릇이 아름다웠는지는 안 알려주고, 원래 알려줄 물건도 아니었어.

제안된 기능이 작업장더러 자료를 만들게 한다면 그 기능은 모양이 틀린 거야. 시험 하나로 갖고 다니기 좋아. "이왕이면 초안도 뽑아줄 수 있잖아" 쪽으로 끌어당기는 힘은 늘 있고, 늘 재설계가 아니라 편의처럼 들리거든.

Code

작업장의 어휘 전부 — 빠진 게 뭔지 봐·bash
# Queue a unit of work. Nothing starts here; a record is created.
kiln delegate --quest <slug> --pipeline create --note "<topic + angle>"

# A human opens an interactive session and claims it.
kiln take <id>

# Each stage boundary writes a log entry AT THE MOMENT IT CLOSES.
kiln stage sweep     --note "<what the survey found>"
kiln stage plan-gate --note "<what was approved, by whom>"
kiln stage compose   --note "<what was written>"

# Review crosses an instance boundary; the verdict carries its log.
kiln review-run --reviewer <brain> --prompt-file <request>
kiln review --verdict fix-first --note "<what was rejected and why>"

# Mechanical gates, then a landing serialized behind a lease.
kiln verify
kiln land --note "<what shipped>"

# There is no `kiln write`. There is no `kiln draft`. There is no
# `kiln fix`. Every verb above moves a record or a file that a human
# and their chosen brain already produced.

External links

Exercise

반복되는 작업 하나를 골라서 지금 도구가 제공하는 동사를 전부 나열해봐. 각 동사를 큐잉, 계약, 기록, 직렬화, 생산 중 하나로 분류하고. 생산 칸이 제일 길면 생성기를 갖고 있는 거고, 비어 있으면 작업장을 갖고 있는 거야. 그다음 생산 칸에서 하나 골라서, 그걸 사람이랑 그 사람이 고른 도구한테 넘기면 뭐가 망가지는지 적어봐.
Hint
대개 망가지는 건 처리량이고, 그건 감추지 말고 이름을 붙일 만한 진짜 비용이야. 물어야 할 건 그 처리량이 뭘 사줬냐는 거지. 결과물은 어차피 누군가 읽고 판정하고 결재해야 했고, 그 누군가는 기계가 만들었다는 이유로 오히려 조금 더 믿게 되니까.

Progress

Progress is local-only — sign in to sync across devices.
이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

댓글 0

🔔 답글 알림 (로그인 필요)
로그인댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.