AI에게 「이 화면 만들어 줘」라고 하면 무언가가 나온다. 문제는 다음 날이었다. 어제 정한 것을 오늘의 AI가 몰랐고, 지난주에 뒤집은 결정을 다시 들고 왔다. 혼자 일하는 사람에게 이건 치명적이다. 기억을 책임질 사람이 하나뿐이기 때문이다. 낚시어때에서는 기억을 문서에 맡겼다.
번호를 붙이자 대화가 짧아졌다
기획서의 모든 화면 블록에 번호를 붙였다. 민물 홈은 2j, 민물 낚시터 상세는 5m 같은 식이다. 블록 안은 5m-03처럼 한 번 더 나눴다. 번호가 생기자 대화가 달라졌다. 「민물 상세 화면에서 위쪽 카드의 색이…」 대신 「5m 카드 색」이라고 하면 두 AI와 사람이 같은 곳을 봤다.
번호는 세 종류를 따로 썼다.
- 화면 번호 (
5m): 화면과 블록 - R 규칙(Rule,
R38): 사람이 승인한 화면·동작 규칙. 예) 위험 판정이 뜬 화면에는 광고를 넣지 않는다(9월 9일 확정). - D 결정(Decision,
D253): Claude Code가 스스로 판단하고 기록한 것
R과 D를 가르는 기준은 하나였다. 사람의 승인이 필요했으면 R, AI가 판단했으면 D. 이 기준은 8월 27일에 정리해 확정했다. 번호는 한 번 쓰면 다시 쓰지 않았고, 코드 주석에도 번호를 남겼다(// R38). 뒤집은 결정도 번호째 남겨, 「D29를 D74로 폐기」처럼 무엇이 무엇을 대신했는지 따라갈 수 있게 했다. 지금 코드에는 R 번호 주석이 77줄, D 번호 주석이 351줄 있다. 사람 승인이 필요한 결정(R)보다 구현이 스스로 정한 결정(D)이 코드에서 네 배 넘게 많이 쓰였다. 반년 뒤에 「왜 여기만 광고가 없지?」라는 질문이 생겨도 번호 하나로 이유까지 찾아갈 수 있다.
기획서보다 소스가 진실이었다
문서를 믿다가 한 번 크게 틀렸다. 기획서에는 민물 화면 색이 초록이었는데, 앱에서는 파랑이 그대로 나왔다. 연안 모드의 부품을 가져다 쓰면서 색까지 따라온 것이다. 기획서 목업의 실제 색 지정값과 실기기 화면을 맞대어 보니 12개 블록 중 4곳이 어긋나 있었다. 이 일로 모드 색을 본문까지 쓰는 규칙(R39)이 9월 11일에 생겼다. 기획서만 보고 「됐다」고 넘어갔다면 몰랐을 것이다.
그 뒤로 규칙을 하나 두었다. 기존 화면을 이어받는 기획은 반드시 실제 코드를 먼저 읽고 쓴다. 기억 속 기획서가 아니라 지금 돌아가는 코드가 기준이다. Claude Code 쪽에도 거꾸로 된 규칙을 두었다. CLAUDE.md(Claude Code가 프로젝트를 열 때 자동으로 읽는 규칙 파일)에 화면을 만들기 전에는 요약이 아니라 기획서 원본 블록을 열게 했다.
지시문은 카드 한 장에 하나씩
Claude Code에게 줄 지시는 「지시문 보드」라는 페이지에 카드로 썼다. 카드 한 장에는 목적, 순서, 완료 기준, 하지 말 것이 들어갔다. 복사와 전달은 다른 일로 나눴다. 복사 버튼을 누르면 제목과 본문이 함께 복사되지만, 그것만으로는 전달로 치지 않았다. Claude Code에 실제로 넘기고 나서야 「전달됨」에 체크했다. 지시가 사람, Claude Design, Claude Code 세 쪽을 오갔기 때문에, 이 체크 하나로 지금 이 카드가 전달됐는지 전달 전인지를 사람과 Claude Design이 같은 화면에서 알 수 있었다. 다 넘긴 카드는 보관함으로 옮겼다.
완료 기준을 꼭 적게 한 데는 이유가 있다. AI는 「다 했습니다」라고 쉽게 말한다. 완료 기준이 카드에 있으면 「기준 3번은?」이라고 되물을 수 있었다.
제안, 승인, 반영
AI가 좋은 아이디어를 가져와도 바로 반영하지 않았다. 순서는 늘 같았다. 제안을 받고, 사람이 승인하고, 그다음에 기획서나 코드에 넣었다. 작은 수정을 부탁하면 그것만 고치게 했고, 주변을 「개선」하지 못하게 했다. 이 규칙이 없으면 AI는 성실하게 일을 늘린다.
이 문서 체계가 실제 사고를 겪으며 규칙으로 바뀐 과정은 3편에 이어진다.
가져다 쓸 것
- 화면과 기능에 짧은 번호를 붙인다. 대화 길이가 절반이 된다.
- 사람이 정한 규칙(R)과 AI가 정한 결정(D)을 따로 기록한다. 나중에 무엇을 되돌려도 되는지 알 수 있다.
- 지시는 카드 한 장에 하나, 완료 기준을 꼭 적는다.
- 이어받는 작업은 문서가 아니라 실제 코드를 먼저 읽게 한다.
- AI의 제안은 승인 뒤에만 반영한다.
이 글은 2026-09-30 기준으로 헥사허브가 직접 겪은 일을 적었습니다.