진행 상황과 다음 계획을 문서화하다
목차
프로젝트의 진행 상황과 다음 단계의 계획을 docs/PLAN.md에 정리해서 팀에 핸드오프했다. 단순해 보이는 문서 하나지만, 팀과의 동기화와 컨텍스트 전달에서 생각보다 많은 역할을 한다.
개발을 진행하다 보면 매일 아침 어디까지 왔는지, 다음에 뭘 할지 팀원들과 맞춰야 한다. 특히 여러 사람이 동시에 움직이거나 누군가 업무를 인수인계받을 때는 더욱 그렇다. 빠르게 변하는 프로젝트의 현황을 말로만 전하면 누락되거나 왜곡되기 쉽다. 어떤 팀원은 A를 우선이라 생각하고, 다른 팀원은 B를 우선이라 생각하게 되는 식이다. 그래서 진행 상황과 계획을 문서로 남기는 것이 중요하다. 이건 단순한 기록이 아니라, 팀이 같은 방향을 보게 하는 일종의 나침반 역할을 한다.
진행 상황 문서의 여러 면
PLAN.md 같은 문서는 생각보다 여러 용도로 쓰인다:
| 용도 | 효과 | 예시 |
|---|---|---|
| 현황 기록 | 어디까지 왔는지 한눈에 파악 | 완료된 작업 vs 진행 중 작업 구분 |
| 우선순위 명시 | 다음 작업의 순서와 이유가 명확 | "A 완료 후 B, 그 후 C" 같은 의존성 |
| 컨텍스트 보존 | 새로 합류하는 팀원도 맥락 이해 | 한 달 뒤 들어온 신입도 5분이면 상황 파악 |
| 리스크 식별 | 예상되는 어려움과 대응 방안 미리 수립 | "X가 병목이 될 수 있으니 미리 Y 준비" |
| 의사결정 기록 | 나중에 "왜 이렇게 했을까" 되짚을 수 있음 | 3개월 뒤 "이 선택이 맞았나?" 되돌아볼 때 |
개인적으로 이런 문서들이 가장 가치 있을 때는 두 가지 상황이다. 하나는 누군가 프로젝트에 새로 합류할 때고, 다른 하나는 한두 달 뒤 내가 이전에 왜 이런 결정을 했는지 까먹었을 때다. 그 순간에 명확하게 남겨진 문서가 얼마나 도움이 되는지 느낀다. "아, 그때 이 문제 때문에 저렇게 한 거네" 하면서 순간적으로 전체 그림이 맞춰진다.
PLAN.md에 담을 만한 것들
실무에서는 보통 이런 식으로 구성한다:
- 현재 상태: 어느 단계를 진행 중인지, 완료된 것은 뭔지, 블로킹된 작업은 없는지
- 다음 단계: 어떤 작업을 언제 시작할 예정인지, 예상 소요 기간은 얼마인지
- 리스크 & 대응: 예상되는 문제점(외부 의존, 기술적 불확실성, 인력 부족 등)과 그에 대한 대비책
- 진행 정보: 주요 의존성, 외부 이슈, 팀원별 담당 영역, 중요한 데드라인
- 변경 이력: 이전 계획에서 뭐가 바뀌었는지 (이전에는 A였는데 지금은 B로 변경한 이유)
이렇게 명시해두면 팀원들이 "지금 뭘 해야 하나", "다음에는 뭐가 나와야 하나", "내 일과 다른 사람 일이 어떻게 연결되나"를 빠르게 파악할 수 있다. 특히 비동기로 일하는 팀이거나 시간대가 다른 팀원들이 있으면, 이런 문서가 거의 유일한 소통 채널이 될 수도 있다.
팀 리더 입장에서
총괄 팀장 입장에서는 이런 문서가 특히 중요하다. 여러 팀원의 작업이 얽혀 있고, 각자 다른 속도로 움직이는 상황에서 "우리가 지금 어디 가고 있는지" 명확히 해야 한다. 문서가 없으면 어떻게 될까?
- 매일 같은 말을 반복하게 된다
- 팀원마다 생각하는 방향이 조금씩 달라진다
- "나는 A가 우선인 줄 알았는데" 하면서 예상 외의 충돌이 생긴다
- 누군가 병가를 내거나 프로젝트를 옮길 때 그 사람이 뭘 하고 있었는지 알 수 없다
특히 다음 계획을 명시하는 것이 중요한데, 이건 단순히 "이거 먼저, 저거 나중"이 아니다. 왜 그 순서인지, 어떤 의존성이 있는지, 만약 X 문제가 생기면 우리는 어떻게 바뀔 준비가 되어 있는지까지 담아야 한다. 이렇게 하면 팀원들이 단순히 지시를 따르는 게 아니라, 프로젝트의 전략과 리스크까지 이해하고 움직이게 된다. 그럼 예상 밖의 변화가 생겨도 자기들 판단으로 대응할 수 있다.
회고
이번 커밋을 하면서 느낀 건, 문서화가 얼마나 시간을 버는 투자인지다. 분명 처음엔 시간이 든다. 현황을 정리하고, 계획을 명확히 하고, 예상 가능한 문제를 생각하는 데 30분, 1시간이 걸린다.
하지만 그 다음부터는? 팀과의 커뮤니케이션이 훨씬 빨라진다. 같은 질문을 반복 받지 않는다. 의도하지 않은 방향으로 흘러가는 일이 줄어든다. 장기적으로는 엄청난 시간 절감이다.
또 하나 배운 점은 문서는 일회성이 아니라 살아 있는 것이라는 거다. PLAN.md를 한 번 쓰고 끝이 아니다. 상황이 바뀌면 빠르게 업데이트해야 한다. 새로운 리스크가 드러나면 추가하고, 완료된 작업은 빼고, 우선순위가 바뀌면 반영한다. 그래야 팀원들이 여기 나온 정보를 신뢰하고 의사결정에 쓸 수 있다. 만약 문서가 현실과 어긋나면, 그건 문서가 없는 것보다 더 나쁘다. 잘못된 정보로 의사결정하는 게 더 위험하니까.
그리고 한 가지 더. 이런 문서를 처음부터 완벽하게 쓸 필요는 없다. 대충 시작해서 팀의 피드백을 받으면서 점진적으로 개선하면 된다. "이 부분이 더 필요해", "이건 너무 상세해" 같은 의견을 받으면서 우리 팀에 맞는 형태로 다듬어진다. 문서화는 그렇게 진화한다.
🛒 이 글과 어울리는 추천 상품
*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.
댓글 0
첫 댓글 달아줘.