[작성자:] 컴맹 집사

작성자: 컴맹 집사

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

대표 이미지: 여럿이 역할을 나누어 일하는 회의 자리 (사진: sakibmia24 / Pixabay)

시즌 1 때는 AI 하나와 모든 걸 했다. 아이디어도 묻고, 코드도 받고, 오류도 물었다. 앱이 작을 때는 그게 편했다. 그런데 웹툰을 그리고, 노래를 만들고, 반려견 동반 여행지를 조사하는 단계가 되자 한 대화창으로는 감당이 안 됐다. 대화가 길어질수록 앞에서 한 이야기를 잊었고, 조사하다 말고 코드를 고치다 보면 둘 다 엉성해졌다.

그래서 회사처럼 부서를 나눴다. 사장은 나, 직원은 AI들이다.

우리 왕국의 AI 부서 배치표

지금 왕립 개집사협회 앱을 만드는 데 쓰는 AI는 이렇게 나뉘어 있다.

여기에 하나가 더 있다. 앱 안에서 일하는 AI다. 혈통 감정소에서 강아지 사진을 보고 견종을 추측하는 AI는 구글이 공개한 작은 이미지 인식 모델로, 사용자의 휴대폰 안에서만 돌아간다. 이건 나중에 혈통 감정소 편에서 자세히 이야기하겠다.

나누고 나서 달라진 점

가장 크게 달라진 건 조사와 개발을 떼어 놓은 것이다. 휴양소를 만들 때 처음에는 개발하는 AI에게 “반려견 동반 가능한 곳을 넣어 줘”라고 했다. 그러자 그럴듯한 장소 이름이 술술 나왔다. 문제는 그게 진짜인지 확인할 길이 없다는 것이었다. 실제로 가 보니 없는 곳이 들어갈 수도 있었다.

그래서 조사는 조사실 AI에게 따로 맡겼다. 한국관광공사나 산림청, 지자체처럼 공식 자료에서 확인한 곳만 적고, 출처 주소와 확인한 날, 확인 등급을 함께 남기게 했다. 조사실이 만든 결과 파일을 개발실 AI가 받아서 앱에 넣는다. 부식보급청의 음식 정보도 같은 방식으로, 여러 자료를 비교한 표까지 만들어 넘겼다.

그림도 마찬가지다. 세자 그림 16장을 만들 때는 개발실 AI가 “이런 그림이 필요하다”는 프롬프트 목록을 쓰고, 미술실 AI가 그림을 그리고, 내가 골랐다. 그림이 앱에 들어간 뒤 글씨가 잘 안 보이면 다시 개발실이 화면을 손봤다.

부서끼리 일을 넘기는 방법

여러 AI를 쓰면 생기는 문제가 있다. 서로 대화를 못 한다는 것이다. 조사실 AI가 찾은 내용을 개발실 AI는 모른다. 그래서 일을 넘길 때는 반드시 파일로 넘긴다.

• 조사 결과는 데이터 파일과 조사 결과 문서로
• 디자인 결정은 기준서의 확정 결정 칸으로
• 다음에 이어서 할 일은 지시서로

지시서는 “이 문서를 다른 대화창에 그대로 붙여 넣으면 이어서 일할 수 있게” 쓴 문서다. 무엇을 먼저 읽을지, 지금 어디까지 했는지, 건드리면 안 되는 것이 무엇인지가 들어 있다. 덕분에 한 기능을 며칠에 걸쳐, 여러 대화창에서 나눠 만들어도 흐름이 끊기지 않았다.

한 AI가 쓰고, 다른 AI가 검토한다

부서를 나누고 나서 생긴 좋은 습관이 하나 더 있다. 중요한 계획은 만든 AI가 아닌 다른 AI에게 검토를 맡기는 것이다. 사람도 자기 글의 오타는 잘 못 찾듯이, AI도 자기가 쓴 계획의 빈틈은 잘 못 본다.

앱 전체의 큰 방향을 담은 종합계획서를 썼을 때도 검토 의견을 따로 받아서 고쳤다. 동궁을 만들 때가 대표적이다. 처음 계획서에는 “왕자견”이라는 별도 캐릭터를 새로 만들자고 적혀 있었다. 검토를 거치면서 이게 “우리 집 폐하의 세자”로 바뀌었다. 새 캐릭터를 하나 더 만들면 세계관이 갈라지지만, 폐하의 아들로 두면 연대기와 작위증과 동궁이 한 가족 이야기로 이어지기 때문이다. 기준서에는 이 변화가 “계획서에서 바뀐 것”이라는 표로 남아 있다.

검토를 맡길 때는 칭찬 말고 문제를 찾아 달라고 분명히 말한다.

이 계획서에서 초보자가 만들기 어려운 부분, 기존 기능과 겹치는 부분, 빠진 부분을 찾아 줘. 좋은 점은 말하지 않아도 돼.

이렇게 물으면 AI가 듣기 좋은 말 대신 쓸모 있는 말을 해 준다. 그리고 검토 의견을 다 받아들일지는 역시 내가 정한다. 검토 의견 중 절반은 받아들이고 절반은 “우리 왕국에는 안 맞아”라며 넘긴 적도 많다.

그래도 사람이 해야 하는 일

AI 다섯을 써도 내 일은 줄지 않았다. 오히려 분명해졌다.

1. 정하기: 무엇을 만들지, 무엇을 만들지 않을지는 내가 정한다.
2. 고르기: 그림 여러 장, 노래 여러 곡, 시안 여러 개 중에 고르는 건 내 몫이다.
3. 써 보기: 왕실 연대기는 출시 기준에 “내가 실제 날짜로 사흘 넘게 직접 해 보기”를 넣었다. “내일도 열고 싶은가?”는 AI가 대신 답해 줄 수 없다.
4. 책임지기: 앱에 들어가는 정보가 틀리면 그건 AI 탓이 아니라 내 책임이다.

나에게 맞는 AI 배치표 만들기

꼭 다섯 개를 쓸 필요는 없다. 시작은 둘이면 충분하다. “자료를 찾는 AI”와 “결과물을 만드는 AI”를 나누는 것만으로도 실수가 확 준다. 찾는 쪽에는 “출처 주소와 확인한 날짜를 반드시 함께 적어 줘”라고 하고, 만드는 쪽에는 “이 파일에 있는 내용만 써. 없는 건 지어내지 마”라고 말해 보자. 시즌 1의 AI와 함께 앱 만들기 솔직 후기에서 말한 “성실한 조수”가 이제는 조수 여러 명이 된 셈이다.

이전 글: 기능 하나 만들기 전에 ‘기준서’부터 쓰는 이유
다음 이야기: 한국판 하나 고쳤는데 미국·일본판까지? 3개국 자동 배포 만든 날

작성자: 컴맹 집사

시즌 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 다섯과 일 나누기, 기획·조사·개발·그림·음악 담당 정하기

작성자: 컴맹 집사

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

대표 이미지: 잔디밭을 힘차게 달리는 강아지처럼, 작은 앱도 멈추지 않고 자랐다 (사진: ValterM / Pixabay)

작위증 하나로 끝날 줄 알았다. 질문 7개에 답하면 “당신은 간식 협상형 집사”라는 증서를 주는 앱. 시즌 1의 50편은 컴맹 집사가 AI와 함께 그 앱을 세상에 내놓기까지의 기록이었다.

그런데 이상한 일이 벌어졌다. 앱을 내놓고 나니 오히려 할 일이 늘었다. “작위증 받고 나면 그다음엔 뭘 하지?” 앱을 다시 열어 보던 내가 스스로에게 던진 질문이었다. 작위증은 한 번 받으면 끝이다. 한 번 보고 끝나는 앱은 다시 열 이유가 없다.

그래서 왕국을 넓히기로 했다. 시즌 2는 그 이야기다.

작위증 하나에서 작은 왕국으로

지금 왕립 개집사협회 앱을 열면 아래쪽에 탭이 다섯 개 있다. 홈, 연회장, 동궁/내전, 춘추관, 승정원. 처음엔 화면 하나짜리 테스트 앱이었는데, 이제는 궁궐처럼 방이 여러 개다.

• 연회장: 미니게임 5종이 있는 왕실 오락실, 노래 9곡이 흐르는 왕실음악당, 강아지 사진을 꾸미는 부띠끄 스튜디오, 매일 조금씩 사건을 푸는 왕실 연대기
• 동궁/내전: 아기 세자를 하루 30초씩 돌보는 동궁, 요리 게임 수라간, “이거 먹여도 돼?”를 찾는 부식보급청, 반려견과 갈 수 있는 곳을 모은 왕실 휴양소
• 춘추관: 사진으로 견종을 맞히는 혈통 감정소, 강아지와 집사 중 누가 사고뭉치인지 가리는 왕실 재판, 출석부와 훈장함

이름만 봐도 알겠지만 기능마다 왕실 이름을 붙였다. 강아지는 왕, 반려인은 집사라는 처음 세계관을 끝까지 지키고 싶었기 때문이다. 기능을 하나 더할 때마다 “이게 왕국 안에서는 무엇일까?”부터 물었다. 음식 정보는 부식보급청, 여행지는 휴양소, 동물 병원 정보는 어의원이 되는 식이다.

시즌 1과 무엇이 다른가

시즌 1이 “코딩을 몰라도 앱을 만들 수 있을까?”에 대한 답이었다면, 시즌 2는 “만든 앱을 어떻게 키우나?”에 대한 기록이다. 막히는 곳도 달랐다.

처음엔 기능 하나 만드는 게 어려웠다. 이제는 기능이 많아져서 생기는 문제가 어려웠다. 새 기능을 넣었더니 홈 화면이 길어져 아무도 끝까지 내리지 않았다. 늦게 만든 기능일수록 아무도 찾지 못했다. 한국판을 고쳤는데 미국판과 일본판에는 반영이 안 되는 일도 있었다. 기능끼리 따로 놀아서 “그래서 이 앱이 뭐 하는 앱이야?”라는 질문을 다시 듣기도 했다.

그때마다 AI와 머리를 맞댔고, 정답보다는 우리 왕국에 맞는 답을 찾으려 했다. 그 과정을 숨기지 않고 쓸 생각이다.

이 시즌에서 얻어 갈 수 있는 것

앱을 만들지 않는 분이라도 가져갈 게 있도록 글마다 세 가지를 담으려 한다.

1. 아이디어가 기능이 되기까지: 머릿속 생각을 AI에게 어떻게 설명했는지, 실제로 쓴 요청 문장까지
2. 막힌 곳과 바꾼 결정: 처음 계획에서 무엇이 왜 바뀌었는지
3. 바로 써먹는 팁: 내 앱이나 내 일에 그대로 가져갈 수 있는 방법 한 가지

순서는 대체로 실제로 만든 순서를 따른다. 먼저 일하는 방식이 어떻게 바뀌었는지부터 이야기하고, 웹툰과 음악, 매일 들어올 이유, 휴양소와 혈통 감정소, 재판, 동궁, 연대기 순으로 왕국을 한 바퀴 돌 예정이다.

왕국을 넓히며 지킨 세 가지 약속

기능이 늘수록 욕심도 늘었다. 로그인을 넣으면 기록을 여러 기기에서 볼 수 있고, 광고를 붙이면 운영비가 나오고, 사진을 서버로 보내면 더 똑똑한 AI를 쓸 수 있다. 하지만 시즌 2 내내 지킨 약속이 세 가지 있다.

• 회원가입과 서버 없이 만든다. 동궁의 육아일지도, 연대기의 진행 기록도 모두 그 휴대폰 안에만 저장된다. 대신 휴대폰을 바꿀 때를 위해 기록 백업 파일을 만들 수 있게 했다.
• 강아지 사진은 휴대폰 밖으로 나가지 않는다. 혈통 감정소가 사진으로 견종을 맞힐 때도, 부띠끄 스튜디오에서 모자를 씌울 때도 사진은 그 기기 안에서만 처리된다.
• 앱 안에 광고와 제휴 링크를 넣지 않는다. 쇼핑 링크 하나쯤 넣자는 유혹이 있었지만, 앱은 끝까지 놀이터로 두기로 했다. 블로그와 유튜브처럼 우리 채널로 가는 링크만 둔다.

재미로 하는 기능에는 “재미를 위한 오락용이며 실제 평가가 아니다”라는 안내도 꼭 붙였다. 혈통 감정서는 진짜 혈통 검사가 아니고, 재판 판결은 진짜 판결이 아니다. 반대로 휴양소나 부식보급청처럼 실제 생활에 쓰는 정보에는 출처와 확인한 날짜를 붙였다. 재미와 정보를 섞지 않는 것, 이게 작은 왕국이 믿음을 얻는 방법이라고 생각했다.

이 약속 때문에 포기한 기능도 있고, 더 어렵게 돌아간 길도 있다. 그 이야기들도 시즌 2에서 하나씩 꺼내 볼 생각이다.

여전히 컴맹 집사입니다

달라지지 않은 것도 있다. 나는 지금도 코드를 직접 짜지 못한다. 대신 무엇을 만들지 정하고, 결과를 직접 써 보고, “이건 아니야”라고 말하는 역할이 훨씬 능숙해졌다. 시즌 1을 읽은 분이라면 그 변화가 반가울 테고, 처음 오신 분이라면 이 시즌부터 읽어도 충분하다.

궁금한 기능이 있다면 앱을 먼저 열어 보셔도 좋다. 글을 읽고 다시 보면 같은 화면이 다르게 보일 것이다. 시즌 1 이야기는 코딩 1도 모르는 집사가 강아지 때문에 앱을 만들게 된 사연부터 시작한다.

이전 이야기: 시즌 1 「코딩 몰라도 AI로 첫 앱 만들기」 전체 목차
다음 이야기: 기능 하나 만들기 전에 ‘기준서’부터 쓰는 이유