기능 하나 만들기 전에 ‘기준서’부터 쓰는 이유

작성자: 컴맹 집사

시즌 2 「비록 작은 왕국이지만, 왕립 개집사협회 앱의 세계관을 넓혀 가는 과정」 2편

대표 이미지: 일을 시작하기 전에 책상 위에 계획부터 펼쳐 둔다 (사진: rawpixel / Pixabay)

시즌 1 때의 나는 성격이 급했다. 떠오르면 바로 AI에게 “이거 만들어 줘”라고 했다. 기능이 몇 개 없을 때는 그래도 됐다. 그런데 왕국이 커지자 똑같은 방식이 사고를 쳤다.

어느 날 홈 화면 카드를 정리해 달라고 했더니, AI가 며칠 전에 같이 정한 규칙을 까맣게 잊고 전혀 다른 배치를 만들어 왔다. AI가 잘못한 게 아니었다. 그 결정은 지난 대화창에만 있었고, 새 대화창의 AI는 알 길이 없었다. 그날부터 기능을 만들기 전에 반드시 하는 일이 생겼다. 기준서 쓰기다.

기준서가 뭐길래

기준서는 “이 기능을 무엇을 위해, 어떻게, 어디까지 만들지”를 적은 문서다. 회사에서는 기획서나 명세서라고 부를 것이다. 나는 거창한 이름 대신 기준서라고 불렀다. AI와 내가 둘 다 보고 따르는 기준이라는 뜻이다.

지금 앱의 내부 문서 폴더에는 00번부터 27번까지 번호가 붙은 기준서가 있다. 브랜드 표기 기준, 웹툰 제작 기준, 게임마다 하나씩, 휴양소, 혈통 감정소, 동궁, 연대기, 부띠끄 스튜디오까지. 기능 하나에 문서 하나가 짝을 이룬다.

기준서에 꼭 들어가는 것들

처음에는 이것저것 적다가 점점 틀이 잡혔다. 지금은 거의 모든 기준서가 이런 순서로 시작한다.

1. 먼저 읽기: 지금 어디까지 왔는지. 새 대화창의 AI가 가장 먼저 읽는 칸이다.
2. 한 줄 정의: 예를 들어 동궁은 “폐하의 세자를 하루 30초씩 돌보는 미니 육성 놀이”다.
3. 확정 결정: 무엇을 정했는지, 언제, 왜. 날짜를 꼭 붙인다.
4. 하지 않는 것: 만들지 않기로 한 기능. 이게 의외로 제일 중요하다.
5. 테스트와 출시 기준: 무엇을 확인하면 내보내도 되는지.
6. 진행 기록: 어느 날 어디까지 했는지.

“하지 않는 것”을 적는 이유는 AI가 착하기 때문이다. 부탁하지 않아도 이것저것 좋은 기능을 더해 주려 한다. 그러다 보면 하루면 끝날 일이 일주일이 된다. 휴양소 기준서에는 “예약·결제는 하지 않는다”, 혈통 감정소에는 “사진을 서버로 보내지 않는다”처럼 선을 먼저 그어 두었다.

기준서 덕분에 막은 사고들

홈 카드 정리 기준서 맨 위에는 이런 문장이 있다. “기준서만 저장한다. 착수는 사용자 지시가 있을 때. 음악당 작업이 끝난 뒤에 시작한다.” 같은 파일을 두 작업이 동시에 고치면 서로 덮어쓰는 충돌이 나기 때문이다. 이 한 줄 덕분에 다른 대화창에서 일하던 AI가 순서를 지켰다.

혈통 감정소 기준서에는 “계획서와 달라진 점”이라는 표가 있다. 처음 계획과 실제로 만든 것이 어떻게 다른지, 왜 바꿨는지 적어 두었다. 몇 주 뒤 “왜 이렇게 만들었지?” 싶을 때 이 표를 보면 바로 답이 나온다. 내 기억보다 문서가 훨씬 정확했다.

부띠끄 스튜디오 기준서에는 내가 한 말이 그대로 적혀 있다. “어설픈 기능보단 멋지게 보여 주는 것이 중요하다.” 이 한 문장이 기준이 되어, 나중에 기능을 줄여야 할지 고민할 때 판단이 쉬워졌다.

기준서는 내가 쓰지 않아도 된다

오해하실까 봐 덧붙이면, 이 문서들을 내가 처음부터 다 쓴 건 아니다. 나는 하고 싶은 걸 말로 길게 설명하고, AI가 기준서 초안을 만든다. 나는 그걸 읽고 “이건 빼”, “이건 꼭 넣어”라고 고친다. 확정된 결정에는 “사용자 확정”이라고 날짜를 남긴다. 컴맹이 할 일은 쓰는 게 아니라 고르고 정하는 것이었다.

그리고 기능을 만드는 대화창에는 첫 문장으로 늘 이렇게 말한다.

먼저 22번 기준서를 처음부터 읽어. 기준서와 다르게 만들어야 하면 이유를 말하고 내 확인을 받아.

기준서가 너무 길어지면 생기는 일

기준서에도 부작용이 있었다. 왕실 연대기 기준서는 결정과 수정이 쌓이면서 어느새 아주 긴 문서가 되었다. 길어지니 AI가 중요한 부분을 놓치거나, 예전 버전의 문서를 읽고 일을 시작하는 일이 생겼다. 그래서 세 가지 장치를 더했다.

첫째, 문서 맨 위에 “낡은 사본 확인부터”라는 칸을 두었다. 이 문서의 첫 줄이 몇 번째 판인지, 옆에 어떤 파일이 함께 있어야 하는지를 적어 두고, 하나라도 다르면 낡은 사본을 읽고 있는 것이니 멈추라고 했다. 둘째, 분량이 큰 내용은 따로 뺐다. 연대기의 사건 이야기는 별도의 “사건 원고” 문서로 나누고, 기준서에는 어디에 있는지만 적었다. 셋째, AI가 일을 시작하기 전에 나에게 물어볼 것을 미리 정해 두었다. 왕실 주방 기준서에는 “착수할 때 사용자에게 확인할 것은 세 가지뿐, 나머지는 문서대로 만들고 첫 미리보기 화면에서 바꿀 것만 묻는다”고 적혀 있다.

세 번째가 특히 효과가 컸다. 예전에는 AI가 작은 것 하나하나를 물어봐서 대답하다 지치거나, 반대로 아무것도 묻지 않고 마음대로 만들어서 다시 해야 했다. 물어볼 것을 정해 두니 대화가 짧아지고 결과는 정확해졌다.

기준서를 쓰는 데 시간이 드는 건 사실이다. 하지만 기준서 없이 만든 기능을 고치는 데 드는 시간에 비하면 훨씬 짧았다. 무엇보다 “그때 왜 이렇게 정했더라?”를 떠올리느라 끙끙대는 일이 사라졌다.

바로 쓰는 기준서 틀

앱이 아니어도 좋다. 블로그 개편, 가게 메뉴 바꾸기, 여행 계획처럼 여러 날에 걸쳐 AI와 함께하는 일이라면 이 틀이 도움이 된다.

• 한 줄로 말하면: 무엇을 위한 일인가
• 정한 것: 날짜와 이유를 함께
• 하지 않을 것: 욕심나도 이번엔 빼는 것
• 다 됐다는 기준: 무엇을 확인하면 끝인가
• 지금 상태: 마지막으로 어디까지 했나

다섯 줄이면 충분하다. 대화창이 바뀌어도 이 문서만 붙여 넣으면 AI가 어제의 나를 기억해 준다. 시즌 1에서 배운 한 줄 기획서가 자라서 기준서가 된 셈이다.

이전 글: 50편 그 후, 작은 앱이 멈추지 않고 커진 이야기
다음 이야기: AI 다섯과 일 나누기, 기획·조사·개발·그림·음악 담당 정하기