16장. 검색 가능한 컨텍스트 패키지를 만드는 법

Express의 출발점은 개별 노트가 아니라 조합된 맥락이다

by hako

문서를 쓰기 시작하면 비슷한 일이 자주 생긴다.

근거는 회의 메모에 있고,
기존 결정은 다른 문서에 있고,
관련 개념은 또 다른 폴더에 따로 있다.
자료가 없는 것은 아닌데, 막상 한 번에 꺼내지 못한다.

그래서 결과물을 만들 때마다 다시 찾고, 다시 정리하고, 다시 맥락을 맞추게 된다.

Express 단계가 자주 느려지는 이유도 여기 있다.

이 문제를 줄이는 가장 실용적인 방법이 컨텍스트 패키지다.
컨텍스트 패키지는 특정 작업에 필요한 근거, 결정, 관련 지식, 제약 조건을 한 번에 묶어두는 단위다.


image.png


컨텍스트 패키지는 검색 가능한 작업 단위다

좋은 컨텍스트 패키지는 참고 링크를 모아둔 목록이 아니다.
지금 어떤 문제를 풀고 있는지, 어떤 근거와 결정이 이미 있고, 어떤 지식이 연결되어야 하는지를 한 번에 볼 수 있어야 한다.


예를 들어 신규 결제 기능 PRD를 써야 한다고 해보자.
이때는 최소한 문제 정의, 관련 Evidence Note, 기존 Decision Log, 관련 도메인 지식, 기술 제약이나 운영 조건이 함께 잡혀 있어야 한다.

이 다섯 가지가 따로 흩어져 있으면 문서는 써도 맥락은 약해진다.
반대로 한 묶음으로 정리돼 있으면 사람도 더 빨리 이해할 수 있고, AI에게 넘길 때도 입력 품질이 좋아진다.

즉 컨텍스트 패키지는 자료를 모아두는 상자가 아니라, 바로 작업에 들어갈 수 있게 만드는 맥락 단위다.


컨텍스트 패키지의 핵심은 많이 모으는 것이 아니라 적절히 고르는 것이다

자료를 많이 붙인다고 좋은 패키지가 되는 것은 아니다.
오히려 너무 많은 정보는 초점을 흐리고, 무엇이 핵심인지 더 보기 어렵게 만든다.

중요한 것은 지금 이 작업에 필요한 맥락만 적절하게 고르는 일이다.

그래서 컨텍스트 패키지를 만들 때는 이렇게 묻는 편이 낫다.


지금 풀고 싶은 문제는 무엇인가.
이 문제를 설명하는 근거는 무엇인가.
이미 내려진 결정은 무엇인가.
여기서 다시 써야 할 지식은 무엇인가.
반드시 고려해야 할 제약은 무엇인가.


이 질문에 답하는 구조로 묶이면 패키지는 훨씬 실무적으로 변한다.
많이 모은 패키지보다, 잘 고른 패키지가 더 자주 다시 쓰인다.


네 영역 지식은 패키지 품질을 높인다

여기서 네 영역 지식, 즉 맥락·도메인·기술이해·관계가 붙으면 패키지의 밀도가 달라진다.

같은 기능 PRD라도 맥락만 있으면 표면적인 요구사항 문서가 되기 쉽다.

도메인 지식이 붙으면 왜 이 문제가 중요한지가 보이고,
기술이해가 붙으면 비현실적인 요구를 줄일 수 있고,
관계 지식이 붙으면 누구를 어떻게 설득해야 하는지도 더 분명해진다.

즉 컨텍스트 패키지는 근거와 결정만 모아두는 묶음이 아니다.
필요할 때 네 영역 지식을 끌어와 결과물의 품질을 높이는 작업 단위이기도 하다.


패키지는 검색 가능해야 한다

패키지가 정말 유용하려면 만들 수만 있어서는 안 된다.
다음에도 다시 찾을 수 있어야 한다.

그래서 이름, 링크, 관련 프로젝트, 관련 결정, 관련 산출물과의 연결이 중요하다.

예를 들어 “신규 결제 기능 PRD 패키지”처럼 작업 목적이 드러나는 이름을 붙이고, 관련 Evidence와 Decision을 링크해 두면 다음에 비슷한 작업이 왔을 때 다시 불러오기 쉬워진다.

이렇게 되면 컨텍스트 패키지는 일회성 메모가 아니라 검색 가능한 재사용 단위가 된다.
Express 단계에서 중요한 검색은 개별 노트를 찾는 일만이 아니다.
한 번 잘 조합해 둔 작업 맥락을 다시 꺼내는 일도 포함된다.


좋은 패키지는 AI와 사람 모두에게 읽히는 형태다

컨텍스트 패키지는 사람이 읽어도 빠르게 이해할 수 있어야 하고, AI에게 넘겨도 구조적으로 읽힐 수 있어야 한다.

설명이 있어야 하지만 산만하면 안 되고,
링크가 있어야 하지만 무엇이 핵심인지도 드러나야 한다.

이 조건을 만족하면 패키지는 사람에게는 빠른 이해 도구가 되고, AI에게는 좋은 입력 세트가 된다.
결국 Express 단계의 속도와 품질은 패키지의 품질에 크게 좌우된다.


컨텍스트 패키지는 Express의 최소 단위다

좋은 결과물은 대개 빈 화면에서 나오지 않는다.
이미 정리된 맥락 위에서 나온다.

PRD든, 제안서든, 보고 문서든 먼저 컨텍스트 패키지를 만들고 그 위에서 쓰기 시작하면 근거 없는 문장을 줄일 수 있다.
AI를 쓸 때도 그냥 “써줘”가 아니라 “이 맥락을 기준으로 써줘”가 가능해진다.

그래서 Express의 출발점은 개별 노트가 아니다.
조합된 맥락이다.


이 장의 결론

컨텍스트 패키지는 Express의 최소 단위다.
꺼내 쓰기의 출발점은 개별 노트가 아니라 조합된 맥락이다.

문제 정의, 관련 근거, 기존 결정, 관련 지식, 제약 조건이 한 덩어리로 묶여 있어야 사람도 빠르게 이해할 수 있고 AI에게도 좋은 입력이 된다.


중요한 것은 많이 모으는 것이 아니라 이 작업에 필요한 맥락만 적절히 고르는 것이다.
그리고 한 번 만든 패키지는 검색 가능하게 이름과 링크를 붙여야 다음 유사 작업에서도 다시 쓸 수 있다.

다음 글에서는 이 패키지를 재료로 실제 산출물을 어떻게 꺼내 쓰는지 이어서 보려 한다.

이전 22화PART 6. PKM 어떻게 Express 하는가