진행 상황 문서로 팀 의사결정을 체계적으로 기록하는 법

PROGRESS.md를 갱신했다. 로그인, 친밀도, 사진업로드, fresh셀카, 외모, LLM 관련 결정들이 쌓여가면서 한번쯤은 정리해야겠다 싶어서다. 단순한 문서 갱신이지만, 이 작은 습관이 팀 운영에서 생각보다 큰 역할을 한다는 걸 계속 느끼고 있다.

PROGRESS.md의 역할

개발팀을 이끌다 보면 의사결정이 매일 쌓인다. "이 기능의 우선순위는 언제?", "LLM 선택은 뭘로 갈까?", "로그인 플로우는 이 방향이 맞나?" — 이런 질문들이 코드 리뷰, 스탠드업, 슬랙 어딘가에 흩어진다. 시간이 지나면 그 결정 과정이 희미해진다.

그래서 PROGRESS.md처럼 간단한 추적 문서를 둔다. 이건 단순히 진행률을 보는 게 아니라, 의사결정 과정 자체를 기록하는 것이다. 각 기능이나 항목마다 "지금 뭘 하고 있고, 왜 이렇게 했으며, 뭐가 남았는가"를 한두 줄씩 써 두면, 시간이 지난 뒤에도 "그때는 왜 이렇게 했지?" 같은 질문에 답할 수 있다.

# PROGRESS.md 작성 예시

## 진행 중
- 로그인: OAuth 연동 (예상: 6월 말)
- 친밀도: 가중평균 알고리즘 구현 중
- 사진업로드: 이미지 최적화 테스트 중

## 완료
- fresh셀카: UI/UX 완성
- 외모: 점수 계산 로직 검증

## 결정 메모
- LLM: Claude 선택 (이유: 응답 품질 vs 비용 밸런스)

이 정도면 충분하다. 팀원들이 "우리 지금 뭘 하고 있어?" 할 때 링크 하나 던져주면 끝. 신입이 들어왔을 때도 컨텍스트를 빠르게 넘길 수 있다.

의사결정 메모가 중요한 이유

이번 갱신에서 특히 주목한 부분이 "결정 메모"다. 커밋에 명시했듯이, 각 선택의 배경을 따로 기록해 두는 것이다.

첫째는 팀원 온보딩의 속도다. 예를 들어 LLM 부분을 누군가에게 넘겨줄 때, "왜 이 모델을 썼는가"를 기록해 두면 그 사람이 처음부터 생각할 필요가 없다. 의사결정 메모를 읽고 "아, 이런 트레이드오프가 있었구나" 하고 빠르게 주인의식을 갖는다. 불필요한 재논의도 줄어든다.

둘째는 나중의 재검토다. 6개월 뒤에 "이 선택이 여전히 맞나?" 할 때, 당시의 고민을 복원할 수 있다. 비용이 더 싸진 모델이 나왔다면? 팀의 우선순위가 바뀌었다면? 결정 메모가 있으면 "그땐 이 이유였는데, 지금은 다르니까 바꿔보자" 같은 판단이 빨라진다.

여러 기능을 한번에 보기

로그인, 친밀도, 사진업로드, fresh셀카, 외모, LLM — 이렇게 여러 항목을 한곳에 모으는 것도 중요하다. 각 기능의 진행 상태가 한눈에 보인다.

개별 이슈 트래커에서는 "이 기능은 언제 끝날까?", "다음은 뭘 해야 할까?"라는 큰 그림이 잘 안 보인다. 하지만 PROGRESS.md를 보면 "아, 우리가 이만큼 진행했고, 다음은 저 부분이 병목이네" 같은 것들이 자연스럽게 보인다. 우선순위도 명확해진다.

또한 팀과 대화할 때도 유용하다:
- "현재 상태가 뭐야?" → 한 파일이 답이 된다
- 각자 읽고 → "아, 그럼 나는 저 부분을 밀어주면 되겠네"라는 주인의식이 생긴다
- 신입과 기존 팀원 모두 → 같은 언어로 소통할 수 있다

다음은 갱신의 반복

이번 갱신은 작은 commit이지만, 이렇게 정기적으로 상태를 기록하는 습관이 팀을 건강하게 유지한다고 생각한다. 특히 초기 단계에서 여러 기능을 병렬로 진행할 때는 더욱 그렇다.

코드도 중요하지만, 왜 이 코드를 썼는가, 현재 어디까지 왔는가를 기록하는 것도 엔지니어링이다. 다음 번 갱신할 때, 이 항목들 중 몇 개가 "완료"로 넘어가 있을 것 같다. 그때가 기대된다.

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

• 인체공학사무의자 쿠팡에서 보기 →
• 기계식키보드 쿠팡에서 보기 →
• 책상조명 쿠팡에서 보기 →

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