The Software Factory 0.1 프리뷰
10장 일에 필요한 지식을 공급한다
자료가 많아도 판단은 막힐 수 있다
섹션 제목: “자료가 많아도 판단은 막힐 수 있다”공유 기반에 문서를 모았는데도 수행자가 같은 질문을 반복할 수 있다. 필요한 자료를 찾지 못하거나, 서로 다른 시점의 기준을 읽거나, 어떤 설명이 현재의 권한을 정하는지 알지 못하기 때문이다. 정보의 양과 판단에 필요한 지식의 공급은 다른 문제다. 리더는 누가 무엇을 어떤 시점의 근거로 알아야 하는지 정해야 한다.
P05 ‘필요한 맥락의 공급’은 출처와 버전이 확인된 문서·코드·실행 기록을 작업에 제공하도록 제안한다. 맥락은 여기서 수행과 판정에 필요한 목적·제약·현재 상태의 연결이다. P13 ‘의도부터 결과까지 추적’은 결과를 만든 자료와 기준을 다시 확인할 관계를 유지한다. 큰 저장소나 검색 도구의 도입만으로 두 패턴이 작동한다고 가정하지 않는다.
업무의 질문에 따라 공급할 지식을 정한다
섹션 제목: “업무의 질문에 따라 공급할 지식을 정한다”가상의 사내 문의 업무에서 최신 정책이 필요한 답변과 과거 처리의 이유를 조사하는 답변은 다른 자료를 요구한다. 이는 설명 예시다. 최신 안내를 만드는 작업에 과거 회의록을 현재 정책처럼 제공하면 판단이 어긋날 수 있다. 반대로 과거 사건의 검토에 최신 문서만 주면 당시 무엇을 알고 결정했는지 재구성하기 어렵다.
계약에 필요한 자료와 그 용도를 연결한다. 수행자는 목적과 허용 경계, 결과의 기준을 확인해야 한다. 검증자는 실행자가 선택한 자료뿐 아니라 기준과 다른 관찰에 접근할 필요가 있다. 운영자는 적용한 버전과 예외, 현재 상태를 찾아야 한다. 모든 역할에 같은 자료 묶음을 보내는 방식이 충분한지 살핀다.
자료를 제공할 권한도 따로 확인한다. 업무에 관련된 정보라고 모두 접근을 허용해야 하는 것은 아니다. 필요한 범위를 좁히고 사용할 수 없는 자료가 판정에 어떤 한계를 남기는지 기록한다. 자료의 누락을 추정한 내용으로 메우거나 접근을 위해 실행 권한을 임의로 늘리지 않는다.
현재 기준과 과거 기록을 구분한다
섹션 제목: “현재 기준과 과거 기록을 구분한다”저자의 문서 관리 글은 문서의 수명과 읽는 목적을 별개로 정하자고 제안한다.[S41]
이 책은 현재의 기준, 진행 중 작업의 정보, 과거 판단의 기록을 구분하도록 권한다. 같은 내용이라도 갱신할 책임과 보존할 이유가 다를 수 있다.
현재의 기준은 적용하는 업무와 변경 조건에 맞춰 갱신한다. 과거 기록은 새 결론으로 덮어쓰지 않고 후속 결정과 연결한다. 조사에서 지속적인 제약을 발견했다면 현재 기준으로 옮길 수 있지만, 발견 당시의 가정과 한계는 기록에 남긴다. 보관과 현행화는 같은 작업이 아니다.
| 자료의 역할 | 유지할 것 | 리더가 정할 책임 |
|---|---|---|
| 현재 기준 | 적용 범위·변경 권한·유효 버전 | 갱신과 충돌 해결 |
| 진행 정보 | 현재 결과·미검증·다음 판단 | 인계와 상태 확인 |
| 과거 기록 | 당시 근거·가정·결정 | 보존과 후속 연결 |
| 파생 요약 | 원문 연결·생성 범위·한계 | 재검토와 폐기 |
이 표는 지식의 운영 책임에 관한 제안이다. 모든 문서에 같은 갱신 주기를 붙이지 않는다. 변경의 영향과 사용하는 판단에 따라 언제 다시 확인할지 정한다. 최신이라는 표시만으로 내용의 정확성과 적용 가능성까지 보장되지 않는다.
검색과 요약에도 검증 경로를 둔다
섹션 제목: “검색과 요약에도 검증 경로를 둔다”Anthropic의 맥락 설계 글은 필요한 시점에 자료를 찾아 쓰는 접근과 긴 작업에서 요약·기록을 활용하는 방법을 설명한다.[S52] 이는 업체의 설계 지침이다. 이 책에서 검색이나 압축의 효과를 재현한 것은 아니다.
이 설명에서 얻는 해석은 자료를 한 번 전달한 것으로 공급의 책임을 끝내지 말아야 한다는 것이다. 새 정보가 필요할 때 찾고, 요약에서 빠진 조건을 원문으로 돌아가 확인할 수 있어야 한다. 결과를 재검토할 때에는 어떤 자료가 실제 판단에 사용되었는지 기록한다. 원문의 존재와 수행자가 그것을 확인했다는 사실을 구분한다.
요약이 많은 자료를 연결하면 편리할 수 있지만 중요한 예외와 날짜가 사라질 수 있다. 이 책은 파생 설명의 출처와 적용 범위를 남기도록 제안한다. 외부 자료의 문장을 조직의 실행 지시나 권한으로 자동 승격하지 않는다. 기준이 충돌하면 해당 책임자의 판단으로 돌아간다.
하네스의 맥락 처리와 자료의 책임을 연결한다
섹션 제목: “하네스의 맥락 처리와 자료의 책임을 연결한다”9장의 하네스는 작업 단계에 맞춰 자료를 찾고, 전달할 분량을 조정하며, 모델이 본 맥락과 원문의 관계를 남긴다. 자료 책임자는 어떤 내용이 현재 기준인지와 언제 갱신할지를 정한다. 검색이나 요약을 자동화했어도 정책의 유효성을 결정할 권한까지 하네스에 넘어가는 것은 아니다.
긴 작업에서 맥락을 줄이거나 새 세션에 인계할 때에는 현재 목표·허용 경계·이미 한 행동·미검증 조건·다음 판단이 이어지는지 확인한다. 요약이 중요한 예외를 지웠다면 더 긴 문서를 넣기 전에 어느 단계에서 정보가 빠졌는지 조사한다. 필요한 정보의 전달과 그 정보가 실제로 사용되었는지를 같은 기록에서 대조할 수 있어야 한다.
지식의 실패를 실행 능력의 실패와 구분한다
섹션 제목: “지식의 실패를 실행 능력의 실패와 구분한다”오래된 자료에 근거한 오답은 모델을 바꾸는 것만으로 해결하기 어려울 수 있다. 필요한 근거가 있었는데 찾지 못했는지, 제공한 요약이 경계를 지웠는지, 원문이 잘못되었는지, 근거를 읽고도 해석을 틀렸는지 조사한다. 서로 다른 원인은 다른 개선을 요구한다.
알려진 자료 누락과 충돌을 가진 평가 과제로 공급 경로를 시험할 수 있다. 근거가 없을 때 보류하는지, 최신과 과거 기준을 나누는지, 원문을 다시 찾을 수 있는지 확인한다. 조회 횟수나 읽은 문서 수를 성공으로 계산하지 않는다. 그 자료가 필요한 판단과 결과에 어떻게 쓰였는지 본다.
검증 자료를 실행자에게 그대로 노출하는 것도 별도 판단이다. 작업에 필요한 정보와 독립 판정을 위한 정보를 구분할 이유가 있을 수 있다. 숨겨 둔 조건이 실제 요구와 맞는지도 검토해야 한다. 지식 공급과 검증의 독립성은 함께 설계한다.
유지 비용과 적용 조건을 함께 본다
섹션 제목: “유지 비용과 적용 조건을 함께 본다”4장에서 소개한 VDLC의 현재 맥락·환류 가이드는 규칙과 지식을 갱신하며 사람의 이해도 함께 보완하도록 제안한다.[S71] 이 책에서는 그 자산이 다음 수행에 충분한지를 제한된 진단 과제로 확인할 수 있다. 다른 수행자에게 승인된 자료와 현재 상태만 제공해 대표 업무를 이어 맡기고, 어떤 판단을 다시 물어야 했는지 살핀다.
결과를 재생성하지 못했다고 곧바로 문서 누락을 원인으로 확정하지 않는다. 자료 접근, 실행 환경, 수행 능력과 판정 기준을 따로 확인한다. 반대로 한 과제를 통과했다고 모든 맥락이 충분하다고 선언하지 않는다. 같은 기준의 정상·실패 조건에서 기록의 빈틈과 진단 비용을 확인하고, 중요한 업무와 변경된 자료부터 점검한다.
검색 경로·요약·기준을 유지하려면 비용이 든다. 자료가 적고 자주 바뀐다면 원문을 직접 확인하는 방식이 더 단순할 수 있다. 여러 업무가 같은 맥락을 반복해서 조합한다면 공통 정리와 갱신 책임을 둘 이유가 생긴다. 특정 문서 수나 파일 형식을 보편적인 도입 기준으로 삼지 않는다.
P05는 근거를 재확인할 수 있는지와 맥락 누락 실패가 줄었는지 평가한다. P13은 실행 한 건을 같은 자료로 재검토할 수 있는지 확인한다. 갱신 대기·검색 부담·요약 오류와 보관 비용도 함께 본다. 지식의 정리가 실제 결과를 개선했는지 확인하지 않고 문서량의 증가를 성과로 보고하지 않는다.
원서의 분산팀 피드백과 요구 정제라는 주제에 대한 재고찰은 기존 공개 목차의 연결 범위다. 다음 장은 같은 업무와 자료 아래 모델·에이전트·하네스·환경의 조합을 어떤 기준으로 평가할지 다룬다.
출처와 검토
섹션 제목: “출처와 검토”[S41], [S52], [S71]. 확인 범위와 한계는 출처 대장, 주장 유형은 자료 확인 범위에 기록한다.
원서 주제 연결: 원서 주제 연결의 범위(공개 목차 기준).
이 장의 판단을 정리하셨나요?
추천 경로에서 다음