팀의 언어로 승격 — 트래커·위키·Git (5)

내 메모리와 노트는, 결국 나와 AI만 읽습니다. 동료가 알아야 할 것은 팀의 언어로 옮겨야 비로소 공유됩니다.

개인 기록에서 멈추면, 팀과 단절된다

앞 편들에서 규칙·메모리·노트를 쌓았습니다. 그런데 이건 전부 나와 AI만 읽는 기록입니다. AI와 한참을 일해 좋은 결론에 이르렀는데 그게 이슈 트래커·위키·저장소에 반영되지 않으면, 동료 입장에서는 내가 무슨 일을 했는지 확인할 길이 없습니다. 개인 기록에서 멈추는 순간 팀과 단절됩니다.

그래서 필요한 것이 승격입니다. 데일리 노트에서 반복해 참조되는 내용, 동료도 알아야 할 절차·결정·결론을 팀 시스템으로 올립니다.

어디로 승격하나

• 이슈 트래커(Jira·Redmine·OpenProject 등) — 진척·담당·기한. 세션 결과를 티켓 코멘트나 첨부로. 단 "완료"가 곧 "해결"은 아니므로, 검증 결과를 코멘트로 남깁니다.
• 위키(Confluence·Notion·Outline 등) — 절차서·설계 결정·회의 결론 같은 정본. 신규 입사자도 이해할 수준으로, 맥락을 생략하지 않습니다.
• Git 저장소 — 코드·스크립트뿐 아니라 스킬·규칙 파일·설정도. 여러 PC와 팀원이 공유하고, 커밋 메시지가 곧 짧은 작업 기록이 됩니다.

원칙은 하나. 한 정보는 한곳에만 원본으로. 같은 내용을 세 군데 적으면 반드시 어긋납니다. 승격한 뒤 개인 메모리에는 원본을 복사하지 말고 링크만 남깁니다.

앞선 팀들은 이미 이렇게 한다

이건 이상론이 아니라, 잘하는 조직들이 실제로 굴리는 방식입니다.

• 토스는 슬랙의 논의를 요약해 문서 저장소에 자동으로 쌓고, 그 문서가 다시 사내 문서 챗봇의 학습 데이터가 되게 만들었습니다. 글 제목이 상징적입니다 — 토스 프론트엔드 개발자들이 더 이상 문서를 찾지 않는 이유. 기록이 쌓이니 검색조차 필요 없어진 것입니다.
• 아키텍처 결정 기록(ADR)은 위키가 아니라 소스 관리 저장소에 두라는 것이 ThoughtWorks의 권고입니다. 기록이 코드와 함께 움직여야 어긋나지 않기 때문입니다(ThoughtWorks Technology Radar).
• GitLab은 회사 운영 방식 전체를 공개 핸드북에 적는 "핸드북 우선" 문화로 유명합니다. 수천 쪽에 이르는 이 문서가 "우리가 일하는 방식의 단일 진실 원천"이며, 개인이 떠나도 남습니다.
• 구글과 스포티파이는 문서를 코드처럼 다루는 docs-as-code를 정착시켰습니다. 구글은 흩어진 위키 대신 코드 옆 마크다운(g3doc)을, 스포티파이는 개발자 포털 Backstage의 TechDocs를 씁니다. 국내에서는 라인이 개발자 문서를 GitHub에 두고 docs-as-code로 운영한 사례를 공개했습니다.

문서화는 비용이 아니라 증폭기다

"문서 쓸 시간에 일을 더 하지"라는 반론이 있습니다. 데이터는 반대로 말합니다. 구글의 DORA 연구는 내부 문서 품질이 좋은 팀일수록 같은 기술 관행에서 훨씬 큰 성과 향상을 얻는다는 것을 반복해 확인했습니다. 신뢰성 목표를 달성할 가능성은 문서 품질이 좋을 때 두 배 이상 높았고, DORA는 "품질 좋은 문서가 우리가 연구한 모든 기술 관행의 실행을 이끈다"고 정리합니다. 문서는 다른 관행의 효과를 증폭합니다.

거꾸로, 기록이 없을 때의 손실은 앞서 1편에서 본 그대로입니다. 지식이 개인에게만 묶여 있으면(Panopto 조사에서는 기관 지식의 42퍼센트가 한 사람에게만 존재했습니다) 그 사람이 떠나는 순간 통째로 사라집니다.

흐름으로 기억하기

전체 흐름은 이렇게 정리됩니다.

데일리 노트 → 반복되면 메모리 → 팀도 알아야 하면 위키 → 모두가 매번 지켜야 하면 규칙 파일.

아래로 갈수록 더 많은 사람이, 더 오래 읽습니다. 초안은 AI가 만들고, 외부에 게시하는 마지막 확인은 사람이 합니다.

이어지는 이야기

마지막 편에서는 이 체계를 운영하며 반드시 만나는 함정과, 한 번에 다 하려다 지치지 않도록 4주로 나눈 도입 로드맵을 정리합니다 — 함정과 4주 도입 로드맵.

우리 팀 도구(트래커·위키·저장소)에 AI 기록을 어떻게 연결할지 그림이 필요하시다면, 문의하기로 연락 주세요.

---

「AI를 기억하는 동료로 쓰는 법」 시리즈

1. AI는 왜 어제를 잊는가 — 세션의 망각과 맥락 비용
2. 규칙은 한곳에 — AI 규칙 파일 쓰는 법
3. 하나의 파일에 하나의 사실 — AI 자동 메모리
4. 다음 세션의 나에게 — 데일리 노트와 인수인계
5. 팀의 언어로 승격 — 트래커·위키·Git (현재 글)
6. 함정과 4주 도입 로드맵