기획서를 받기 전에 개발자가 먼저 그려 본 스토리보드, AI로 기능 초안 만들기
이 블로그는 코드보다 스토리보드를 먼저 만들었습니다. 그때 쓴 방식으로 새 기능 하나의 요구사항과 스토리보드 초안을 AI와 만들어 보고, 어디까지가 초안이고 어디부터가 기획의 영역인지 정리했습니다.
기획부터 검증까지, AI와 넓힌 프론트엔드 개발자의 일· 1 / 6펼치기접기
이 블로그를 만들기 시작한 날, 처음 나온 결과물은 코드가 아니라 STORYBOARD.md라는 문서였습니다. Claude Code의 계획 모드에서 "이번 단계의 산출물은 스토리보드다, 코드는 승인 후에 쓴다"라고 못 박고 시작했습니다. 지금 저장소에 남아 있는 이 문서는 426줄입니다.
개발자로 일할 때는 주로 기획서를 받는 쪽이었습니다. 그런데 AI가 흔해지면서 개발자도 화면 흐름과 요구사항의 초안 정도는 직접 만들어 볼 수 있게 됐습니다. 이 시리즈에서는 기획, 디자인, 리소스, 문서, 개발, 검증 순서로, 프론트엔드 개발자가 AI로 해 볼 수 있게 된 일을 하나씩 정리합니다.
먼저 분명히 해 둘 것이 있습니다. 이 시리즈는 기획자나 디자이너의 일을 AI로 대신하자는 이야기가 아닙니다. 기획도, 디자인도 각자의 전문 분야입니다. 제가 하려는 건 개발자가 머릿속에 그린 것을 빨리 보여 줄 수 있는 초안으로 만들어서, 전문가와 같은 그림을 더 일찍 보는 것입니다.
1. 시리즈 내내 같은 기능 하나를 예제로 씁니다
단계마다 다른 예제를 쓰면 도구 소개를 여러 개 이어 붙인 글이 되기 쉽습니다. 그래서 6편 내내 기능 하나를 정해 두고, 그 기능의 기획 초안, 디자인 시안, 문서, 코드, 검증을 차례로 만들어 봤습니다.
고른 기능은 시리즈 읽기 진행 표시입니다. 이 블로그에는 시리즈가 몇 개 있는데, 방문자가 어디까지 읽었는지 알 방법이 없습니다. 시리즈 페이지에 "2 / 4 읽음"을 보여 주고, 다음에 읽을 글을 짚어 주는 기능입니다. 이 기능은 글을 쓰기 위한 시연으로만 만들었고, 실제 블로그에는 넣지 않았습니다.
2. 블로그 스토리보드는 이렇게 만들었습니다
블로그를 시작할 때 AI에게 바로 코드를 짜게 하지 않았습니다. 대신 계획 모드에서 화면 목록, 공통 레이아웃, 화면별 구성, 상태, 데이터를 문서로 먼저 받았습니다. 첫 판에서는 검색, 댓글, 조회수, RSS, 시리즈를 보류 항목으로 빼 두었다가, 두 번째 판에서 모두 범위에 넣었습니다.
라우트 목록 일부는 이렇습니다.
/ 메인(캐릭터 히어로 + 최근 글 + 인기 글)
/posts/[slug] 글 상세 (조회수, 시리즈 내비, 댓글)
/series 시리즈 목록
/series/[slug] 시리즈 상세 (순서대로 묶인 글)
/about 자기소개
/rss.xml RSS 2.0 피드 (published 글 최신 20개)
/admin/posts/[id] 글 수정 (관리자)화면마다 텍스트로 그린 와이어프레임이 붙어 있고, 빈 목록이나 로딩 같은 상태도 따로 적혀 있습니다. 이 문서가 있어서 구현 중에 "이 화면에 뭐가 있어야 하지"를 다시 묻는 일이 거의 없었습니다. 지금 보면 화면 설계보다 결정 목록 쪽이 더 쓸모 있었습니다. "익명 댓글은 받지 않는다, 스팸 관리 비용이 크다" 같은 줄이요.
3. 새 기능은 질문을 하나씩 받으며 좁혔습니다
진행 표시 기능도 같은 순서로 시작했습니다. "시리즈 진행 표시를 만들고 싶다"라고만 하면 AI는 그럴듯한 기능 목록을 길게 내놓습니다. 기기 간 동기화, 읽은 시간 통계, 완주 배지까지요. 그래서 brainstorming 스킬처럼 질문을 한 번에 하나씩 받고 답하는 방식으로 범위를 좁혔습니다.
실제로 결정에 영향을 준 질문은 세 개였습니다.
- 무엇을 읽은 것으로 칠까요? 글을 연 순간인지, 끝까지 내렸을 때인지
- 기록을 어디에 둘까요? 로그인 없이 브라우저에만 둘지, 서버에 둘지
- 어디에 보여 줄까요? 시리즈 페이지만인지, 글 안의 시리즈 상자에도 둘지
답을 정하고 나서 받은 요구사항 초안의 결정 부분입니다.
- 읽음 기준: 본문 끝(이전/다음 글 내비게이션)이 화면에 들어오면 읽은 글로 친다.
- 저장 위치: 이 브라우저의 localStorage만. 로그인 없이 동작하고 서버로 보내지 않는다.
- 보이는 곳: 시리즈 상세 상단 진행 표시와 글마다 읽음 표시, 글 안 시리즈 상자의 "n편 읽음".
- 하지 않는 것: 기기 간 동기화, 읽은 시각 기록, 진행률 통계 수집."하지 않는 것"을 같이 적어 둔 게 가장 도움이 됐습니다. AI는 하지 말라고 적지 않은 것은 해도 되는 것으로 받아들이기 때문입니다.
4. 스토리보드는 상태까지 그려야 쓸모가 있었습니다
요구사항 다음으로 시리즈 상세 화면의 스토리보드를 텍스트로 받았습니다.
┌──────────────────────────────────────────────────────┐
│ 모든 시리즈 │
│ React 19 다시 배우기 │
│ ┌──────────────────────────────────────────────────┐ │
│ │ 2 / 4 읽음 ██████████░░░░░░░░░░ │ │
│ └──────────────────────────────────────────────────┘ │
│ │ 01 [v] 제목 10.09 │ │
│ │ 02 [v] 제목 10.10 │ │
│ │ 03 [ ] 제목 [이어 읽기] 10.11 │ │
│ │ 04 [ ] 제목 10.13 │ │
└──────────────────────────────────────────────────────┘
상태: 기록 없음 / 모두 읽음 / 저장소를 쓸 수 없음화면 그림보다 마지막 줄이 더 중요했습니다. 기록이 없을 때, 다 읽었을 때, 브라우저 저장소를 쓸 수 없을 때 화면이 어떻게 보여야 하는지요. 이 세 줄은 뒤에서 테스트 케이스가 되고, 하나는 검증 단계에서 놓친 부분으로 다시 돌아옵니다.
5. 초안이 정하지 못한 것들이 기획의 영역이었습니다
이렇게 만든 초안에는 분명한 한계가 있었습니다. 이 기능이 정말 필요한지는 초안이 답해 주지 않습니다. 시리즈를 끝까지 읽는 방문자가 얼마나 되는지, 진행 표시가 그걸 늘리는지는 데이터와 사용자를 봐야 알 수 있습니다. 제가 가진 근거는 "있으면 좋겠다"는 제 추측뿐이었습니다.
우선순위도 마찬가지입니다. 같은 시간에 검색을 고치는 게 나은지, 진행 표시를 만드는 게 나은지는 서비스 전체를 보는 사람이 판단할 일입니다. 실제 서비스였다면 이 초안은 기획자와 대화를 시작하는 재료였을 겁니다. "제가 이해한 건 이건데 맞나요?"를 문서로 들고 가는 거죠.
기획서와 개발자의 이해가 어긋나는 건 보통 구현이 끝난 뒤에야 드러납니다. 초안을 먼저 보여 주면 그 어긋남을 구현 전에 찾을 수 있다는 점이, 이 방식에서 가장 기대하는 부분입니다.
마치며
블로그 스토리보드를 먼저 만든 덕분에 구현 내내 같은 질문을 반복하지 않았습니다. 새 기능도 질문 세 개와 "하지 않는 것" 목록만으로 범위가 꽤 선명해졌습니다.
다만 AI가 잘 만든 건 정해진 결정을 문서 모양으로 정리하는 일이었고, 결정 자체는 여전히 사람이 했습니다. 다음 글에서는 이 스토리보드를 디자인 시안으로 옮겨 봅니다.
Comments (0)