‘LLM 위키’를 팀 전체로: 손수 만든 맥락을 확장하기

한 줄 요약 — 요즘 많은 사람이 Claude Code 같은 코딩 에이전트를 위해 마크다운 폴더로 ‘LLM 위키’를 손수 만듭니다. 그 방식은 강력하지만 보통 한 사람에게서 멈춥니다. 개인이 손으로 모은 맥락을 팀 전체로 확장하는 방법을 살펴봅니다.

‘LLM 위키’란 무엇인가

최근 개발자들 사이에서 하나의 패턴이 퍼지고 있습니다. 제품·결정·규칙을 마크다운 파일 몇 개로 정리해 한 폴더에 모아 두고, Claude Code나 로컬 에이전트가 그 폴더를 읽게 하는 방식입니다. 사람들은 이걸 ‘LLM 위키’ 혹은 에이전트를 위한 ‘세컨드 브레인’이라 부릅니다.

방식은 단순합니다. 에이전트에게 매번 배경을 설명하는 대신, 배경을 파일로 적어 두고 “여기를 참고해서 해줘”라고 하면 됩니다. 그 뒤로 에이전트는 추측 대신 내가 적어 둔 맥락 위에서 답합니다.

왜 이 방식이 잘 통할까

핵심은 에이전트에게 정확한 맥락을 준다는 데 있습니다. 모델이 똑똑해서가 아니라, 내가 손수 고른 맥락이 있기 때문에 답이 우리 상황에 맞습니다. 손으로 정리하는 과정 자체가 무엇이 중요한지 골라내는 일이라, 결과물의 품질이 좋습니다.

손수 만든 위키가 강력한 이유가 여기 있습니다. 자동으로 긁어모은 잡동사니가 아니라, 사람이 판단해 고른 맥락이기 때문입니다. 이건 대체할 대상이 아니라 지켜야 할 강점입니다.

문제는 ‘한 사람’에서 멈춘다는 것

하지만 손으로 만든 위키는 대개 한 사람의 노트북 안에 있습니다. 그래서 몇 가지가 걸립니다.

• 다른 팀원은 그 맥락을 읽지 못합니다. 결국 각자 자기 위키를 따로 만듭니다.
• 내용은 손이 닿는 만큼만 최신입니다. 바쁘면 그대로 오래됩니다.
• 다른 사람의 에이전트, 다른 기기의 에이전트는 그 폴더에 접근하지 못합니다.

개인에게 잘 통하던 방식이 팀으로 넘어가는 순간 벽에 부딪힙니다. 맥락은 한곳에 모여야 힘을 쓰는데, 각자 폴더에 흩어지면 처음 문제로 되돌아갑니다.

팀 버전은 어떻게 다를까

Specify는 이 ‘LLM 위키’ 아이디어를 그대로 가져오되, 팀 규모로 키웁니다. 발상은 같습니다. 에이전트가 읽을 맥락을 한곳에 모으는 것. 다만 그 맥락이 한 사람의 폴더가 아니라 팀의 공용 워크스페이스에 있습니다.

• 자동으로 모입니다. 문서·결정뿐 아니라 Notion·Slack·GitHub를 연결하면 그쪽 맥락까지 함께 읽습니다. 손으로 옮겨 적지 않아도 됩니다.
• 함께 씁니다. 한 사람이 정리한 맥락을 모든 팀원과 그들의 에이전트가 동시에 읽습니다.
• 에이전트에 바로 연결됩니다. Specify는 MCP 서버로 동작해, Claude Code·Codex가 팀의 맥락을 직접 탐색합니다. 폴더를 복사해 돌릴 필요가 없습니다.

손으로 하던 일을 그대로, 팀 규모로 옮긴 셈입니다.

손으로 만든 걸 버리지 않아도 됩니다

이미 만들어 둔 위키가 있다면, 그건 좋은 출발점입니다. 버릴 이유가 없습니다. 쓰던 문서와 도구를 연결해 그대로 가져오고, 부족한 부분만 채우면 됩니다. 한 번에 다 옮길 필요도 없습니다.

작게 시작해도 됩니다. 팀이 자주 다시 묻는 것 하나를 맥락으로 모으고, 에이전트를 연결해 보세요. 개인 위키에서 얻던 그 느낌 — 매번 설명하지 않아도 되는 편안함 — 을 팀 전체가 함께 얻는 지점이 곧 옵니다.

자주 묻는 질문

기존 문서나 쓰던 도구를 연결할 수 있나요?

문서를 워크스페이스로 가져오거나, 쓰던 도구를 소스로 연결하면 그 맥락을 함께 읽습니다. 처음부터 다시 쓸 필요는 없습니다.

Claude Code에서 그대로 쓸 수 있나요?

네. Specify를 MCP 서버로 한 줄 연결하면, Claude Code가 팀의 문서·결정·코드 맥락을 직접 읽습니다. 쓰던 방식은 그대로 두고 맥락만 팀 것으로 바뀝니다.