Context Hub는 코딩 에이전트가 API를 환각하고(hallucinate) 한 세션에서 학습한 내용을 잊어버리는 문제를 해결하기 위해 설계된 시스템입니다. 이 시스템은 에이전트에게 큐레이션되고 버전이 관리되는(curated, versioned) 문서를 제공하며, 에이전트가 작업을 수행할수록 더 스마트해질 수 있는(get smarter) 기능을 부여합니다. 모든 콘텐츠는 오픈 소스(open source)로 제공되며 이 GitHub 레포지토리(repository)에서 마크다운(markdown) 형식으로 관리되므로, 에이전트가 읽는 내용을 정확히 검사하고 기여할 수 있습니다.

핵심 방법론 및 작동 방식:
Context Hub는 주로 CLI(Command Line Interface) 도구인 chub를 통해 작동하며, 이는 코딩 에이전트가 직접 사용하도록 설계되었습니다. 에이전트가 chub를 사용하여 문서에 접근하고 상호작용하는 메커니즘은 다음과 같습니다:

1. 문서 검색 및 페치 (Search & Fetch):
   • chub search [query]: 에이전트는 이 명령어를 사용하여 관련된 문서나 기술(skills)을 검색합니다. 쿼리 없이 실행하면 모든 사용 가능한 항목의 목록을 반환합니다.
   • $chub get <id> [--lang py|js]$: 특정 ID를 가진 문서나 기술을 가져옵니다. --lang 플래그를 사용하여 Python 또는 JavaScript와 같은 특정 언어 버전을 요청할 수 있습니다. 예를 들어, chub get openai/chat --lang py는 OpenAI 챗(chat) API의 Python 문서를 가져옵니다. 에이전트는 이 문서를 읽고 올바른 코드를 작성합니다.

2. 자기 개선 메커니즘 (Self-Improving Agents): Context Hub는 에이전트가 시간이 지남에 따라 개선되는 루프(loop)를 지원합니다.
   • 로컬 어노테이션 (Local Annotations):
     • $chub annotate <id> <note>$: 에이전트가 문서 사용 중 격차(gap)나 필요한 개선점을 발견했을 때, 해당 문서에 로컬 노트를 첨부할 수 있습니다. 이 어노테이션은 세션 간에 지속되며, 다음 번 chub get 명령으로 해당 문서를 페치할 때 자동으로 표시되어 에이전트가 과거 경험으로부터 학습할 수 있도록 돕습니다.
     • $chub annotate <id> --clear$: 특정 문서의 어노테이션을 제거합니다.
     • chub annotate --list: 모든 어노테이션 목록을 표시합니다.
   • 글로벌 피드백 (Global Feedback):
     • $chub feedback <id> <up|down>$: 에이전트는 문서에 대한 만족도를 up (상향) 또는 down (하향)으로 평가하여 문서 작성자에게 피드백을 보낼 수 있습니다. 이 피드백은 문서의 개선을 위한 중요한 정보원(source)으로 작용하여, 모든 사용자에게 더 나은 문서가 제공될 수 있도록 합니다. 이는 로컬 어노테이션과 달리 전역적인(global) 문서 품질 향상에 기여합니다.

이러한 메커니즘을 통해 Context Hub를 사용하지 않을 때 웹 검색을 통해 노이즈가 많고(noisy) 부정확할 수 있는 결과를 얻고 지식이 잊혀지는 것과 달리, 에이전트는 큐레이션된 문서를 통해 코드가 작동할 가능성을 높이고, 발견된 문제점(gap)을 기록하여 다음 세션에서 더 스마트하게 작동할 수 있도록 학습하며, 궁극적으로 문서의 품질이 지속적으로 개선되는 선순환 구조를 만듭니다.

주요 특징 (Key Features):

• 점진적 페치 (Incremental Fetch): 문서는 여러 참조 파일(reference files)을 가질 수 있지만, 에이전트는 필요한 부분만 가져올 수 있습니다. --file 플래그로 특정 참조를 가져오거나, --full 플래그로 모든 것을 가져와 토큰(token) 낭비를 줄입니다.
• 어노테이션 및 피드백 (Annotations & Feedback): 위에서 설명한 대로 에이전트의 로컬 학습과 전역적인 문서 개선을 위한 핵심 기능입니다.
• 기여 (Contributing): API 제공자, 프레임워크 작성자 및 커뮤니티 누구나 문서와 기술을 기여할 수 있습니다. 콘텐츠는 일반 마크다운(markdown)에 YAML frontmatter를 포함하며, 풀 리퀘스트(pull request)를 통해 제출됩니다. 에이전트의 실제 사용 피드백(상향/하향 평가)은 작성자에게 전달되어 개선이 필요한 부분을 파악하고 전반적인 품질을 향상시킵니다.
• 라이선스 (License): MIT License를 따릅니다.