인물 카드·감정 케어 완료를 살아있는 진행 문서로 기록한 방법

이번엔 PROGRESS.md 파일을 갱신했다. 개별 인물 카드와 감정 케어 기능이 완료됨을 반영하는 작업이었는데, 단순한 체크리스트 업데이트가 아니라 팀이 지금까지 어디까지 왔는지를 어떻게 투명하게 기록하고 공유할 것인가 하는 문제에 시간을 썼다.

진행 상황을 문서로 남기는 이유

프로젝트가 커질수록 "지금 뭐 하고 있어?"라는 질문이 잦아진다. 슬랙에 수시로 공유하고, 주간 미팅에서 구두로 설명하고, 이슈 트래커에 작업을 흩어놓으면 누군가는 항상 "최신 상황이 뭐더라?"라고 묻게 된다. 그래서 PROGRESS 같은 문서를 두는 것인데, 이건 단순한 진행률 표시가 아니라 팀이 어떤 우선순위로 일을 해왔고, 언제쯤 뭐가 나올 예정인지를 한 눈에 보여주는 창이다.

개별 인물 카드와 감정 케어는 사용자 경험을 다루는 핵심 기능들이었다. 인물 카드는 각 사용자의 정보를 어떻게 시각적으로 표현할 것인가의 문제였고, 감정 케어는 사용자의 감정 상태를 어떻게 추적하고 반응할 것인가의 기능이었다. 두 기능 모두 백엔드 구조보다는 사용자가 직접 마주하는 영역이라서, 개발 일정에 영향을 주고 마케팅에서도 관심이 많았다.

PROGRESS 파일의 역할 변화

처음엔 단순한 체크리스트였다. "기능 A: 완료", "기능 B: 70% 진행" 이런 식. 하지만 며칠이 지나면서 깨달았다. 마크다운 문서에 항목을 추가하는 것만으로는 충분하지 않다는 것을.

언제 완료됐는지, 완료된 것이 팀의 다음 일과는 어떻게 연결되는지, 완료 이후 발견된 개선점은 뭔지—이런 맥락 없이 단순히 "완료 ✓" 마크만 붙으면 그 파일은 죽은 문서가 된다. 팀원들이 열어보다가 "어? 이미 됐어?" 하고 닫아버린다.

그래서 이번 갱신에서 신경 쓴 부분:

문서 관리의 일반론

우리 팀이 배운 것:

• 마일스톤은 순간이지만, 기록은 영원하다. 기능이 완료되는 순간은 그때뿐이지만, 앞으로 온보딩 문서를 쓸 때, 사후 분석을 할 때, 신규 팀원에게 설명할 때 이 기록이 나침반이 된다.

• 완료와 "준비됨"은 다르다. QA를 통과했다고 완료가 아니다. 사용자에게 배포되고, 처음 사용한 피드백이 돌아오고, 핫픽스가 필요 없을 때쯤이 완료다. 문서엔 이 구분이 명확해야 한다.

• 한 줄 요약은 충분하지 않다. "감정 케어 완료"보다는 "감정 케어(일일 체크인, AI 피드백)—단, 푸시 알림은 다음 스프린트"라고 쓰는 게 팀원이 문서를 읽을 때 실제로 필요한 정보다.

타이밍의 중요성

완료 후 며칠 기다렸다가 갱신하는 것도 좋지만, 너무 늦으면 팀 기억에서도 흐려진다. 나는 보통 QA 확인이 끝나고, 배포 날짜가 잡힌 그 시점에 PROGRESS를 갱신한다. 그러면 그 파일을 본 팀원들이 "아, 이제 정말 나가는 거구나" 하고 느낀다. 신뢰가 생긴다.

이번 갱신도 마찬가지였다. 개별 인물 카드가 마지막 QA를 통과했을 때, 감정 케어가 프로덕션 배포 준비 상태가 되었을 때, 그때그때 PROGRESS에 반영했다. 그리고 몇몇 팀원이 슬랙에서 "어? PROGRESS 봤어? 개인화 기능이 드디어 나가네"라고 반응하는 것을 봤다. 죽은 문서가 아니라, 살아있는 커뮤니케이션 채널로 기능했다는 뜻이다.

다음은 이 두 기능과 연결된 개선 작업들이 파이프라인에 들어올 것이다. PROGRESS 파일은 그 연결고리를 보여주는 역할을 할 거다.

🛒 이 글과 어울리는 추천 상품

• 사무의자 쿠팡에서 보기 →
• 모니터 쿠팡에서 보기 →
• 커피머신 쿠팡에서 보기 →

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.