왜 중요한가

모든 서비스는 지식에 의존합니다. 어떻게 작동하는지, 전에 무엇이 잘못되었는지, 어떻게 고치는지, 왜 그렇게 만들어졌는지. 그 지식이 소수의 머릿속에만 있으면 서비스는 취약합니다. 휴가, 퇴사, 당직 중의 나쁜 밤이 10분짜리 수정을 10시간의 장애로 바꿀 수 있습니다. 지식 관리는 알아야 하는 사람들이 알아낼 수 있도록 하는 실천입니다.

애자일 전통은 문서보다 대화와 작동하는 소프트웨어 쪽으로 기울며, 애자일 선언문의 저자들은 그 때문에 비판받았습니다(주제 1.1 — 애자일 선언문 참조). 공정한 해석은 문서가 자기 자리를 얻어야 한다는 것입니다. 지식 관리는 무엇이 그 자리를 얻는지 결정하는 방법을 줍니다. 자주 쓰이거나, 다시 발견하는 데 비용이 많이 들거나, 너무 적은 사람이 갖고 있는 지식. 나머지는 대화와 페어링이 더 나을 수 있습니다.

지식 관리에 관한 위키백과 문서는 폭이 넓으며, 이 분야를 콘텐츠나 정보 관리와 구별되는, 조직의 목표를 달성하기 위해 지식을 처리하는 것으로 설명합니다. 역사, 모델, 접근, 촉진 요인, 장벽, 비판을 기록하고 IT 서비스에 대해서는 구체적으로 아무 말도 하지 않습니다. 이 주제는 문서의 일반적인 아이디어를 쓰고 서비스 팀에 적용하며, 보고가 아니라 적용하는 곳에 표시합니다.

핵심 개념

지식 관리란

위키백과는 지식 관리(KM)를 조직의 목표를 뒷받침하기 위해 지식을 사용하고 공유하는, 조직의 인식, 학습, 협업, 혁신을 위한 프로세스를 아우르는 것으로 설명합니다. 도제 제도, 기업 도서관, 멘토링 같은 실천이 이 용어보다 훨씬 앞선다고 언급합니다. KM은 1990년대 초 학문 분야로 등장했으며, 노나카 이쿠지로, 다케우치 히로타카, 토머스 H. 대븐포트, 바루크 레브를 포함한 학자들이 분야를 발전시키는 데 도움을 주었습니다. 문서는 ISO 9001:2015가 "조직 지식"에 대한 규격을 추가했다고 말합니다.

암묵지와 형식지

문서는 두 가지 형태를 구분합니다. 암묵지는 내면화되어 있고 흔히 의식적으로 알려져 있지 않습니다. 형식지는 의식적으로 갖고 있으며 쉽게 전달될 수 있습니다. 문서가 노나카와 다케우치의 1995년 책에 귀속시키는 노나카의 SECI 모델(사회화, 표출화, 연결화, 내면화)은 둘 사이의 나선을 설명합니다. 문서는 후대 연구자들이 이 구분을 지나친 단순화라고 불렀다고도 언급합니다.

서비스 팀에게 이 구분은 실용적입니다. 경험 많은 엔지니어는 경보가 아마 잡음이라거나 특정 릴리스가 위험하다는 것을 흔히 감지하지만, 이유를 쉽게 적을 수는 없습니다. 그 감각의 일부는 런북과 점검으로 바꿀 수 있고, 일부는 함께 일하면서만 공유할 수 있습니다.

성문화와 개인화

한센 외(1999)에 따라 문서는 두 전략을 구분합니다. 성문화는 다른 이들이 재사용할 수 있도록 지식을 저장소에 저장합니다. 개인화는 사람들 사이의 직접 접촉을 통해 지식을 공유합니다. 각각이 서로 다른 지식에 맞습니다.

전략 맞는 것 서비스 팀에서의 예
성문화 반복되는, 잘 이해된 작업 런북, 알려진 오류 기록, 서비스 설명, 방법 문서
개인화 복잡하거나, 변하거나, 판단이 많이 필요한 사안 당직 페어링, 섀도잉, 실천 공동체, 설계 논의

대부분의 팀에는 둘 다 필요합니다. 레시피의 지식 베이스는 판단을 가르치지 못하고, 대화만으로는 야간 근무로 확장되지 않습니다.

실천 공동체

문서는 실천 공동체를 KM의 관점 중 하나로 나열합니다. 서비스 조직에서는 데이터베이스 엔지니어나 데스크 분석가처럼 팀을 가로질러 비슷한 문제를 다루는 사람들의 정기적인 비공식 모임만큼 단순할 수 있습니다. 지식과 규범을 퍼뜨리고 사람들에게 물어볼 곳을 줍니다.

무엇을 포착할 것인가

모든 것이 기록할 가치가 있는 것은 아닙니다. 서비스 팀에서 유용한 후보는 다음과 같습니다.

  • 서비스를 복구하는 방법: 런북과 복구 단계(주제 3.2 — 인시던트 관리 참조).
  • 알려진 오류와 회피책: 증상, 회피책, 오너(주제 3.3 — 문제 관리 참조).
  • 서비스 설명: 서비스가 무엇을 하고, 누가 소유하며, 무엇에 의존하는지(주제 3.8 — 서비스 카탈로그 관리 참조).
  • 결정과 그 이유: 왜 어떤 설계가 선택되었는지, 미래의 변경이 이를 맹목적으로 되돌리지 않도록.
  • 인시던트의 교훈: 다른 이들이 읽을 수 있는 포스트모템.
  • 흔한 사용자 질문에 대한 답: 서비스 데스크와 셀프서비스를 위한 짧은 문서.

촉진 요인과 장벽

문서는 사람과 문화, 프로세스와 구조, 기술을 핵심 구성 요소로 꼽습니다. 동기에는 혁신, 더 짧은 개발 주기, 전문성의 활용이 있고, 조직이 콘텐츠 제출 의무화 같은 인센티브를 쓰지만 인센티브가 효과가 있는지에 대한 합의는 없다고 언급합니다. 지식이 전달되지 않음, 불충분한 교육, 경험 많은 직원이 떠날 때의 지식 손실 같은 장벽을 나열합니다. 서비스 팀에게 가장 중요한 장벽은 시간 압박, 불분명한 콘텐츠 소유권, 불편한 도구, 공유보다 영웅주의에 보상하는 문화입니다.

업무 흐름 속의 지식

서비스 데스크에서 널리 쓰이는 실천적 원칙은 지식을 별도의 작업이 아니라 일의 일부로 포착하는 것입니다. 분석가가 새로운 문제를 해결하면 티켓을 닫기 전에 해결책이 문서 초안이 됩니다. 엔지니어가 인시던트를 고치면 단계가 런북에 들어갑니다. 이는 각 일을 작은 기여로 바꿉니다. 이 가이드를 위해 읽은 출처들은 이를 위한 구체적인 방법을 설명하지 않으므로, 원칙을 시험해 볼 흔한 실천으로 다루고 도구로 무엇이 통하는지 보십시오.

비판과 한계

문서는 비판을 기록합니다. 학문적 KM 연구의 실용적 적합성에 의문이 제기되었다는 것, 암묵-형식 구분이 비판받았다는 것, 인센티브의 효과가 논쟁적이라는 것, 지식을 보호하는 데 과보호와 도용 같은 위험이 따른다는 것. KM의 효과나 투자 수익에 대한 측정된 증거는 보고하지 않습니다. 서비스 팀에게 교훈은 소박한 야망입니다. 부재가 해를 끼친 지식부터 시작하고, 쓰이는지 측정하고, 쓰이지 않는 것은 버리십시오.

지식과 조직 학습

문서는 KM이 조직 학습과 비슷하지만 전략적 자산으로서의 지식과 정보 공유를 더 강조하며, KM이 조직 학습을 촉진한다고 말합니다. 이는 애자일 학습(주제 1.10 — 애자일 학습 참조)과 지속적 개선(주제 3.15 — 지속적 개선 참조)으로 이어집니다.

모범 사례

  1. 부재가 해를 끼친 지식부터 시작하십시오. 누락된 지식 때문에 일어난 최근 인시던트나 지연을 나열하십시오. 모든 것을 문서화하려는 시도가 아니라 그 주제부터 시작하십시오.
  2. 일하는 순간에 지식을 포착하십시오. 인시던트, 요청, 변경을 닫을 때 짧은 메모를 쓰는 것을 포함시키십시오. 지금 쓴 거친 메모가 나중으로 미룬 다듬은 문서보다 가치 있습니다.
  3. 문서를 짧고 구조화되게 유지하십시오. 일관된 형식을 쓰십시오. 증상, 알려진 경우 원인, 단계, 상향 보고할 때, 오너, 마지막 검토 날짜. 압박 속의 사람들은 제목과 번호 붙은 단계를 읽습니다.
  4. 모든 문서에 오너와 검토 날짜를 주십시오. 오너 없는 콘텐츠는 썩습니다. 독자가 신뢰를 판단할 수 있도록 검토 날짜를 문서에 보이십시오.
  5. 삭제하고 합치십시오. 아무도 쓰지 않는 문서는 퇴역시키고 중복은 합치십시오. 작고 최신인 베이스가 크고 낡은 것보다 낫습니다.
  6. 찾기 쉽게 만드십시오. 사람들이 이미 일하는 곳에 지식을 두고, 실제 질의로 검색을 시험하며, 티켓, 서비스 카탈로그(ITIL은 "service catalogue"로 씁니다), 런북에서 문서를 연결하십시오.
  7. 런북은 써 보면서 시험하십시오. 런북을 쓸 사람에게 테스트 사례로 따라 해 보게 하십시오. 불분명한 것을 고치십시오. 문서를 작동하는 지식으로 바꿉니다.
  8. 암묵지는 페어링과 섀도잉으로 나누십시오. 경험이 적은 사람들이 실제 인시던트와 변경에서 경험 많은 사람들과 함께 일하게 하십시오. 모두가 바쁠 때는 일어나지 않으므로 페어링을 계획하십시오.
  9. 실천 공동체를 지원하십시오. 사람들에게 팀을 가로질러 만날 시간과 장소를 주십시오. 주제는 구성원에게서 나오게 하십시오.
  10. 결정과 이유를 기록하십시오. 중요한 설계와 프로세스 결정과 그 이유의 짧은 기록을 유지하십시오. 재발견을 막고 신입을 돕습니다.
  11. 교훈을 공유하십시오. 포스트모템과 문제 요약을 평이한 말로 널리 발행하고, 다른 팀에게 무엇이 적용되는지 물어보십시오(주제 3.2 — 인시던트 관리 참조).
  12. 지식 위험을 지켜보십시오. 분기마다 한 사람에게 의존하는 기술과 시스템을 나열하고 이를 퍼뜨릴 계획을 세우십시오. 퇴사를 검토의 촉진제로 다루십시오.

팀과 논의할 질문

이름이 있는 한 사람이 한 달간 자리를 비운다면 우리는 무엇을 할 수 없게 되는가?

팀에게 부재가 해가 될 사람과 그 이유를 말해 달라고 합니다. 그들에게 의존하는 작업을 나열합니다. 보통 긴 목록이고 이름이 오른 사람들에게는 불편합니다. 판단이 아니라 서비스의 위험으로 틀을 지으십시오. 진행자는 어떤 작업을 공유하는 것이 가장 긴급하고 어떻게 할지 물을 수 있습니다. 시작할 하나를 고르십시오.

우리는 무엇을 적어 두며, 누군가 읽는가?

사람들이 마지막으로 쓴 문서 세 개와 마지막으로 쓴 것 세 개를 물어봅니다. 비교합니다. 간극은 문서화 노력이 어디서 엉뚱하게 쓰였는지 보여 줍니다. 읽히지 않는 문서의 유용한 버전은 어떤 모습일지, 혹은 삭제해야 하는지 물어보십시오. 퇴역시키거나 고칠 하나에 합의하십시오.

새로운 것을 고치면 지식은 어디로 가는가?

가장 최근의 새로운 문제를 추적합니다. 누가 고쳤고, 누가 방법을 알고, 어디에 기록되었는지. 답이 "티켓에" 또는 "내 머릿속에"라면 더 나은 경로가 어떤 모습일지 논의합니다. 종결 시의 템플릿 같은 작은 습관이 차이를 만드는 경우가 많습니다. 한 달 동안 하나를 시도하십시오.

어떤 지식은 글쓰기가 아니라 함께 일하면서 나누는 것이 가장 좋은가?

판단이 중요한 곳을 물어보십시오. 그래프 읽기, 상향 보고 시점 결정, 고객 알기. 신입이 지금 이를 어떻게 배우는지 논의합니다. 흔한 답은 운과 시간입니다. 당직 섀도잉 같은 의도적 배치를 계획하십시오. 누가 누구와 짝이 될지 합의하십시오.

지식 문서가 여전히 사실인지 어떻게 아는가?

문서 하나를 골라 시험합니다. 오너, 검토 날짜, 단계가 작동하는지 점검합니다. 많은 문서가 시험에 실패합니다. 어떤 검토 주기가 현실적이고 누가 문서를 퇴역시킬 수 있는지 물어보십시오. 목적은 각 문서에 신뢰의 눈에 보이는 표시를 두는 것입니다.

우리가 아는 것을 공유하지 못하게 막는 것은 무엇인가?

솔직한 답을 모읍니다. 시간 없음, 어리석어 보일까 하는 두려움, 명백한 장소 없음, 인정 없음. 위키백과 문서는 인센티브의 효과가 논쟁적이라고 언급하므로 쉬운 답을 피하십시오. 팀이 바꿀 수 있는 장애물과 경영진이 필요한 장애물을 물어보십시오. 눈에 보이는 변경 하나를 약속하십시오.

실전 사례: 애자일 ITIL 예시

국영 철도의 14명 승객 정보 팀은 역의 표시 장치와 시간표 앱 뒤의 시스템을 운영합니다. 표시 장치 컨트롤러를 만든 가장 경험 많은 엔지니어가 6개월 뒤 은퇴를 발표합니다. 컨트롤러가 실패를 어떻게 처리하는지 이해하는 사람은 아무도 없고, 문서는 10년 전에 쓴 200페이지짜리 설계 문서입니다.

팀 리더는 그 엔지니어가 알고 다른 이들은 모르는 것을 나열합니다. 세 그룹이 나옵니다. 실패 후 컨트롤러를 복구하는 방법(형식지이고 반복 가능), 특정 이상한 동작이 존재하는 이유(일부는 기록되고 일부는 기억 속에), 결함이 심각한지 판단하는 방법(암묵지). 첫 번째에 대해 팀은 엔지니어와 함께 런북을 쓰고, 동료가 테스트 장치에서 각각을 따라 해 보게 하여 시험합니다. 두 번째에 대해 엔지니어 두 명이 매주 그를 인터뷰하고 각각 오너가 있는 짧은 결정 노트를 공유 폴더에 씁니다. 세 번째에 대해 경험이 적은 엔지니어가 6개월 동안 모든 당직 인시던트에서 그를 섀도잉하고, 그가 지켜보는 가운데 일부는 주도합니다.

6개월이 끝나자 엔지니어 세 명이 컨트롤러 실패를 처리할 수 있고, 200페이지 문서는 열한 개의 짧은 런북과 스무 개의 결정 노트로 대체되었으며, 팀에는 한 사람이 아는 것을 설명하는 월간 세션이 생겼습니다. 문제는 남아 있습니다. 두 런북은 다른 하드웨어 버전에서 시험하자 실패하여 다시 써야 했고, 암묵적 판단은 일부만 전달되었습니다. 섀도잉한 엔지니어는 일부 판단이 여전히 추측처럼 느껴진다고 말합니다. 팀은 은퇴하는 엔지니어의 후임과 함께하는 두 번째 섀도잉을 계획하고 런북을 분기마다 검토하기로 합니다.

네 가지 관점

제품 및 전달 팀

전달 팀은 서비스가 어떻게 만들어졌는지에 대한 지식의 상당 부분을 갖고 있습니다. 완료의 정의의 일부로 짧은 런북과 결정 노트를 쓰고, 쓸 사람과 함께 시험하십시오. 변경이 이를 맹목적으로 되돌리지 않도록 설계 이유를 운영과 공유하십시오.

서비스 및 운영 팀

운영 팀은 일상 지식의 상당 부분을 만들고 씁니다. 티켓을 닫을 때 해결책을 포착하고, 알려진 오류를 최신으로 유지하고, 필요한 것을 전달 팀에 요청하십시오. 데스크와 셀프서비스를 위해 문서를 찾기 쉽게 만드십시오.

리더십과 거버넌스

리더는 공유가 보상받을지 낙담될지를 형성합니다. 위키백과 문서는 인센티브가 논쟁적이라고 말하므로, 장애물을 제거하는 데 집중하십시오. 시간을 주고, 도구를 쉽게 만들고, 남을 돕는 사람에게 보상하십시오. 단일 전문성 같은 지식 위험을 다른 서비스 위험과 같은 방식으로 추적하십시오.

고객과 사용자

고객과 사용자는 명확한 답과 셀프서비스 문서에서 이득을 봅니다. 문서가 틀렸거나 빠졌다면 팀에 알리십시오. 제공자에게 인시던트에서 어떻게 배우고 배운 것을 여러분과 어떻게 공유하는지 물어보십시오.

흔한 실패 유형

  • 모든 것을 문서화하는 것. 베이스가 크고 낡아집니다. 대신 부재가 해를 끼친 지식으로 시작하고 필요에 따라 더하십시오.
  • 글쓰기와 일의 분리. 포착이 사후의 잡무입니다. 대신 짧은 메모를 일을 닫는 것의 일부로 만드십시오.
  • 오너가 없는 것. 아무도 문서를 갱신하지 않습니다. 대신 각각에 오너와 검토 날짜를 지명하십시오.
  • 부실한 검색. 사람들이 있는 것을 찾지 못해 중복을 씁니다. 대신 실제 질의로 검색을 시험하고 사람들이 일하는 곳에서 문서를 연결하십시오.
  • 암묵지를 무시하는 것. 모든 것이 글로 쓸 수 있다고 가정됩니다. 대신 페어링, 섀도잉, 실천 공동체를 계획하십시오.
  • 시험되지 않은 런북. 필요할 때 단계가 실패합니다. 대신 사용자가 테스트 사례로 각 런북을 따라 해 보게 하십시오.
  • 지위로서의 독점. 사람들이 자신의 지위를 지키려고 지식을 보호합니다. 대신 공유를 인정하고 의존을 분산하십시오.
  • 콘텐츠를 의무화하는 것. 양의 목표가 얇은 문서를 낳습니다. 대신 사용과 품질에 집중하고 인센티브의 효과가 논쟁적임을 기억하십시오.

성숙도 모델

차원 시작 발전 표준화 관리 최적화
지식 포착 지식이 머릿속과 채팅에 있다 일부 팀이 노트와 런북을 유지한다 노트를 남기는 것이 일을 닫는 것의 일부다 포착률과 유용성이 검토된다 지식 포착이 팀과 공급자 간에 공유된다
품질과 오너십 오너가 없고 콘텐츠가 썩는다 일부 문서에 오너가 있다 모든 문서에 오너와 검토 날짜가 있다 정확성과 사용이 측정되고 낡은 콘텐츠가 제거된다 품질 실천이 조직 전체에서 공유·개선된다
찾기와 사용 검색이 부실하고 사람들이 서로에게 묻는다 일부 콘텐츠가 티켓에서 연결된다 지식이 티켓, 카탈로그, 런북에서 연결된다 사용과 검색 실패가 측정되고 고쳐진다 지식이 적절히 사용자, 공급자, 파트너에게 제공된다
암묵지 나누기 공유가 우연에 의한다 일부 페어링과 섀도잉이 일어난다 페어링, 섀도잉, 실천 공동체가 계획된다 지식 위험이 추적되고 줄어든다 공동체와 순환이 지식을 팀 간에 일상적으로 옮긴다

체크리스트

  • 부재가 해를 끼친 지식을 나열했고 거기서 시작했다.
  • 인시던트, 요청, 변경을 닫을 때 새로운 것이 있었다면 짧은 노트가 포함된다.
  • 문서가 오너와 검토 날짜가 있는 짧은 공통 구조를 따른다.
  • 런북을 쓰지 않은 사람이 시험했다.
  • 실제 질의로 검색이 작동하고, 문서가 티켓과 서비스 카탈로그에서 연결된다.
  • 쓰이지 않는 문서와 중복이 퇴역한다.
  • 한 사람이 가진 지식을 퍼뜨릴 계획이 있다.
  • 판단이 많이 필요한 업무를 위해 페어링이나 섀도잉이 계획되어 있다.
  • 인시던트의 교훈이 팀 밖으로 공유된다.
  • 지식 위험을 적어도 분기에 한 번 검토한다.

AI 프롬프트

목적: 해결된 티켓을 지식 문서의 초안으로 바꾼다.

Turn this resolved ticket into a draft knowledge article for service desk analysts.

The ticket (symptom, steps taken, resolution; remove personal data): [paste].

Write a short article with: a one-line symptom, likely cause (mark as "suspected" if the ticket does not say), numbered steps to check and fix, when to escalate and to whom (use [ROLE] if unknown), and a place for owner and review date. Use only what the ticket says. Mark any step that you inferred with [CHECK]. Ask clarifying questions first if information is missing, and list what you are unsure of.

목적: 팀의 지식 위험을 찾는다.

Here is a list of the systems and tasks our team handles and who can do each: [paste as a table, one row per system or task, with the names or roles of people who can do it].

Using only this list, identify those that only one person can do, and those with two. Rank by how critical the task is, if I have marked it, otherwise leave unranked. For each single-person item, suggest one low-effort way to spread the knowledge (for example pairing or a tested runbook). Do not invent tasks or people. Ask clarifying questions first, and list what you are unsure of.

목적: 시험하기 전에 런북의 명확성을 검토한다.

Here is a runbook: [paste].

Act as a tired on-call engineer who has not seen this system before. List every place where you would be unsure what to do, every term or tool not explained, and every step that assumes knowledge. Suggest clearer wording for each. Do not add technical steps that are not in the runbook; mark questions for the author as [ASK AUTHOR]. List what you are unsure of.

목적: 떠나는 사람을 위한 지식 인수인계를 계획한다.

Help me plan a knowledge handover for [role] who leaves in [time].

What they own or do that others do not: [list].
Where it is written down now: [list, or write "nowhere"].
Who will take over, and their current experience: [describe].

Sort the items into: repeatable tasks to turn into tested runbooks, reasons and decisions to record as short notes, and judgment to share by shadowing or pairing. Propose a week-by-week plan, including testing each runbook with the successor. Do not invent items. Ask clarifying questions first, mark assumptions, and list what you are unsure of.

AI 스킬

  • runbook: 압박 속에서 다른 사람이 따를 수 있는 단계별 절차를 쓸 때 사용합니다.
  • postmortem: 인시던트의 교훈을 다른 이들이 읽을 수 있는 형태로 기록할 때 사용합니다.
  • architecture-decision-record: 설계 결정이 왜 내려졌는지 기록할 때 사용합니다.
  • decision-records: 중요한 비아키텍처 결정의 짧은 기록을 유지할 때 사용합니다.
  • training-needs-analysis: 지식 공유가 다뤄야 할 기술 간극을 찾을 때 사용합니다.

주요 출처

  • Knowledge management (Wikipedia): 분야의 역사, 모델, 접근, 비판에 대한 폭넓은 개요입니다.
  • Postmortem Culture: Learning from Failure (『Site Reliability Engineering』, Google, sre.google): 한 조직이 인시던트의 교훈을 공유하는 방법입니다.
  • Tacit knowledge (Wikipedia): 글로 쓰기 어려운 지식에 대한 배경입니다.
  • Community of practice (Wikipedia): 지식을 공유하는 팀 간 집단에 대한 배경입니다.

참고 문헌

  1. Knowledge management — Wikipedia — https://en.wikipedia.org/wiki/Knowledge_management
  2. Postmortem Culture: Learning from Failure — Google SRE book, sre.google — https://sre.google/sre-book/postmortem-culture/
  3. Tacit knowledge — Wikipedia — https://en.wikipedia.org/wiki/Tacit_knowledge
  4. Community of practice — Wikipedia — https://en.wikipedia.org/wiki/Community_of_practice
  5. SECI model of knowledge dimensions — Wikipedia — https://en.wikipedia.org/wiki/SECI_model_of_knowledge_dimensions
  6. Organizational learning — Wikipedia — https://en.wikipedia.org/wiki/Organizational_learning
  7. Knowledge base — Wikipedia — https://en.wikipedia.org/wiki/Knowledge_base
  8. Ikujiro Nonaka — Wikipedia — https://en.wikipedia.org/wiki/Ikujiro_Nonaka
  9. Manifesto for Agile Software Development — Beck et al., agilemanifesto.org — https://agilemanifesto.org/