늘모자란, 개발 :: 사람용 첫 화면에 운영 장부를 쏟아부었다

늘모자란, 개발

사람용 첫 화면에 근거 링크, 상태 표, 작업 이력을 전부 올리자 문서는 정확했지만 읽을 수 없게 됐다. 에이전트 운영 지식베이스와 사람용 출판 공간은 같은 재료를 써도 첫 독자가 다르다. 에이전트는 다음 판단에 쓸 좌표를 찾고, 사람은 지금 알고 싶은 질문의 답을 찾는다.

운영 지식베이스에는 원문 근거와 현재 상태, 판단이 바뀐 이력이 촘촘히 남아야 한다. 어느 결론을 다시 확인해야 하는지 알려 주는 장부이기 때문이다. 이 구조를 사람용 화면에 그대로 복사하면 독자는 설명보다 운영 기록을 먼저 해독해야 한다.

반대로 읽기 좋게 만든다며 정본부터 줄이면 감사에 필요한 연결이 끊긴다. 예외와 과거 판단을 덜어낸 문장은 매끈해져도, 왜 현재 결론이 나왔는지 되짚기 어려워진다. 한 문서에서 운영 장부와 출판 원고를 모두 해결하려는 시도가 양쪽 요구를 함께 망친다.

해법은 문서 두 벌을 똑같이 관리하는 것이 아니다. 운영 지식베이스만 정본으로 두고, 사람용 공간에는 독립된 질문 하나에 답하는 글을 선별해 다시 쓴다. 첫 화면에는 전체 문서 목록 대신 대표 글과 최근 검토 항목을 놓는다. 권위는 한곳에 두고 읽는 순서만 독자에게 맞춘다.

이 분리는 편집 비용을 없애지 않는다. 정본이 바뀐 뒤 공개 설명을 갱신하지 않으면 사람용 문서가 곧 두 번째 기준처럼 굳는다. 마지막 검토 시점과 근거 연결을 남기고, 오래된 글을 갱신하거나 퇴역시키는 절차가 필요한 이유다. 수정 방향도 정본에서 출판본으로만 흘러야 한다.

사람용 공간은 운영 장부의 압축 파일이 아니다. 질문을 고르고 설명 순서를 다시 짜는 출판물이다. 그 편집과 최신성 비용을 감당하지 못하면 별도 공간은 독자를 돕는 대신 낡은 정답을 하나 더 만든다.

2026/09/16 10:20 2026/09/16 10:20