본문으로 건너뛰기

[1편] 협업 문서를 만들다가, "대시보드" 만든 이야기

[1편] 협업 문서를 만들다가, "대시보드" 만든 이야기 본문 이미지

소개

시도하고자 했던 것

업무 진행 방식이 바뀌는 과정에서 파트너사와 우리 팀이 같은 화면에서 진행 상황을 보고, 해야 할 일을 놓치지 않게 하는 "진행 현황 대시보드 + 프로젝트 체크리스트" 를 기획하고 있습니다.

왜 필요했나

  • 업무 지식이 여러 문서에 흩어져 있었습니다. 같은 업무를 설명하는 가이드가 여러 개였고, 내용이 조금씩 달랐습니다.

  • 파트너사는 내부 시스템 권한이 없습니다. 일부 신청 업무는 우리 팀이 대신 처리하는 경로가 필요했습니다.

  • 문서만으로는 놓칩니다. 프로젝트마다 확인할 항목이 많고, 리드타임이 긴 항목은 기한이 지난 뒤에야 발견되곤 했습니다. 그래서 "가이드를 읽어라"가 아니라 "이번 프로젝트에서 지금 무엇을, 누가, 언제까지"를 보여 주는 도구가 필요했습니다.

작업 흐름

흩어진 가이드 검토·통합 → 외주 협업 프로세스 설계 → 대시보드 기획 < 1편
→ 구현 → 시범 운영 < 2편


진행 방법

사용한 도구

  • Claude Code: 문서 검토, 기획 대화, 설계 문서 작성, 구현

  • Orca: 작업마다 독립된 작업 폴더와 AI 세션을 열어 병렬 진행

  • superpowers 스킬: brainstorming(질문하며 요구 정리) → writing-plans(구현 계획) → subagent-driven-development(구현)

1) "만들어 줘"가 아니라 "파악해 줘"로 시작

처음 요청은 도구가 아니라 업무 파악이었습니다.

업무를 파트너사가 진행할 수 있도록 업무를 인계하고 프로세스를 마련해야 해.
우리 팀은 검수 정도만 할 수 있도록 하는 것이 목표야.
기존 문서들을 검토해서 전체 업무를 파악하고, 잘못 이해한 부분이나 보충할 내용이 있는지 봐 줘.

AI가 문서 간 차이와 틀린 값을 먼저 찾아냈고, 그 결과로 통합 가이드 한 장을 만들었습니다. 이 가이드가 나중에 체크리스트의 원본이 됐습니다.

2) 도구 기획은 세션을 분리

이 내용을 기반으로 파트너사와 우리 팀이 진행 상황을 확인할 수 있는 대시보드와 체크리스트를 만들고 싶어.
진행 중인 업무 리스트, 각 프로젝트에서 해야 하는 리스트를 제공해서 놓치지 않게 하는 거지.
세션을 별개로 열어서 기획해 봐.

Claude가 새 세션에 넘길 핸드오프 프롬프트를 직접 써 줬습니다. 담긴 내용은 이렇습니다.

  • 목표와 범위: "이번 세션은 기획만, 구현하지 않는다"

  • 먼저 읽을 기준 문서

  • 재사용을 검토할 기존 자산 (이미 쓰는 일정 추적 도구 등)

  • 브레인스토밍에서 정할 질문 (사용자, 매체, 데이터 갱신 방식, 알림, MVP 범위)

  • 제약 (외부로 나가는 작업은 사용자 확인 후, 파트너 대상 산출물에는 업체 정보 노출 금지)

꿀팁: 핸드오프에 "기획만", "재사용할 기존 자산", "외부 작업은 확인 후"를 넣어 두면, 새 세션이 코드부터 짜거나 이미 있는 걸 다시 만들지 않습니다.

3) 브레인스토밍: AI가 묻고, 나는 고르고 고쳤다

brainstorming 스킬은 질문을 하나씩 던지고 선택지를 줍니다. 중요한 건 고르는 것보다 틀린 걸 잡아내는 것이었습니다. 제가 개입한 방식은 크게 네 가지였습니다.

개입

예시

출처 묻기

"그 기한 규칙은 어디서 가져온 거야?" → 옛 문서의 틀린 값이었음. 고쳐야 할 문서 목록까지 받음

누락 지적

"문서에 있는 분류가 빠졌어. 다시 확인해 봐."

과잉 설계 견제

"승인 단계가 정말 필요한지 확인해 봐. 증빙 링크만으로 충분하지 않아?" → 항목마다 승인하지 않고 큰 단계 관문에서만 승인

모르는 말 되묻기

"이건 무슨 뜻인지 모르겠어. 설명해 줘." → 설명을 듣고 보니 필요 없는 기능이었음

마지막에는 "빠진 부분은 운영하면서 추가하자"로 마무리했습니다. 이 원칙을 설계 문서에 적어 두니 결정이 빨라졌습니다.

4) 결과물: 설계 문서 = 사실상의 PRD

브레인스토밍이 끝나면 Claude가 설계 문서를 씁니다. 목표와 성공 기준, 역할과 권한, 체크리스트 구조, 기한 규칙, 화면, 연동, 알림, 시범 운영 계획, 리스크까지 담겼습니다.

핵심 구조는 단계 관문(게이트)별로 묶인 체크리스트입니다.

[착수] → [기획] → [설계] → [디자인] → [QA] → [오픈] → [종료]
  └ 각 관문 아래 필수 항목이 묶여 있고, 다 끝나야 다음 관문 승인 가능
게이트별 체크리스트: 항목마다 담당, 필수 여부, 중요도, 상태, 기한, 증빙 개수가 붙습니다. (가상 데이터)

성공 기준

  • 기한이 지난 뒤에야 발견되는 항목이 줄어든다

  • 리드타임이 긴 항목을 기한 전에 알림으로 받는다

  • 우리 팀의 개입이 관문 승인에 집중된다

5) 다른 세션의 교훈을 옮겨 왔다

같은 날 다른 작업에서 여러 세션이 같은 파일을 동시에 고치다 내용이 덮어써지고, 종료 처리 과정에서 미결 사항이 유실될 뻔한 일이 있었습니다. 이 교훈을 그대로 설계에 넣었습니다.

  • 종료 게이트: 남은 미결을 모두 처리하고 정산 기록을 남겨야 종료할 수 있음

  • 동시 수정 방지: 다른 사람이 먼저 고쳤으면 말없이 덮어쓰지 않고 알려 줌

종료 화면: 남은 미결, 정산, 후속 작업, 앞선 관문 승인 중 하나라도 비면 종료되지 않습니다. (가상 데이터)


결과와 배운 점

결과

  • 흩어진 가이드를 통합 가이드 한 장으로 정리

  • 파트너 전달용 가이드와 신청 양식 초안

  • 대시보드·체크리스트 설계 문서 확정

배운 점과 꿀팁

  1. "어디서 가져온 거야?"를 습관처럼 묻기. AI는 그럴듯한 숫자를 가져옵니다.

  2. 모르는 말은 넘기지 말기. 이해가 안 되는 설계는 대개 덜 다듬어진 설계입니다.

  3. 승인 단계를 따로 검증시키기. AI가 설계하면 승인 단계가 늘어나기 쉽습니다.

  4. 기획과 구현은 세션을 나누기.

  5. 완벽하게 정하려 하지 않기. "운영하면서 보완"을 원칙으로 적어 두기.

시행착오

  • 원본 문서가 있어도 AI가 일부를 빠뜨렸습니다. 다 반영했다고 믿으면 안 됩니다.

  • 대시보드보다 통합 가이드를 먼저 만든 게 중요했습니다. 순서가 바뀌었다면 체크리스트가 틀린 내용을 그대로 담았을 겁니다.

  • AI가 효율을 위해 다른 사람의 문서까지 고치자고 제안한 적이 있어서, "원작자 문서는 수정 금지"를 제약으로 명시했습니다.

앞으로의 계획 → 2편

설계 문서를 확정한 뒤 바로 구현 계획을 쓰고, AI 서브에이전트로 MVP까지 만들었습니다. 2편에서 이어집니다.


도움 받은 글 (옵션)

  • superpowers (Claude Code 플러그인)

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기