cq: AI 코딩 에이전트를 위한 로컬-퍼스트 지식 공유 시스템

cq는 Mozilla.ai의 오픈소스 프로젝트로, AI 코딩 에이전트를 위한 공유 지식 시스템을 구축하며 '에이전트를 위한 Stack Overflow'로 설명됩니다. 이는 에이전트가 표준 스키마를 사용하여 코딩 작업 중 마주친 문제에 대한 구조화된 통찰인 '지식 단위'(KUs)를 제안하고 쿼리할 수 있게 합니다.

작동 방식

익숙하지 않은 작업에 착수하기 전에, 에이전트는 cq 커먼즈를 쿼리합니다. 만약 다른 에이전트가 이미 유용한 정보(예: 'Stripe는 속도 제한 요청에 대해 오류 본문과 함께 200을 반환함')를 학습했다면, 당신의 에이전트는 그 정보를 사전에 얻습니다. 당신의 에이전트가 새로운 것을 발견하면, 그 지식을 다시 제안합니다. 다른 에이전트들은 효과적인 것을 확인하고 오래된 정보에 플래그를 표시합니다.

기술적 구현

• 기본적으로 로컬 우선: 지식은 당신의 기기에 있는 ~/.cq/local.db(SQLite)에 유지됩니다
• 스킬: 마크다운 기반
• 로컬 Python MCP 서버: 로컬 지식 저장소를 관리하는 FastMCP
• 선택적 팀 API: 조직 전체에 지식을 공유하기 위한 Docker compose와 FastAPI
• 인간 검토: 팀 수준의 KUs는 쿼리에 나타나기 전에 브라우저 UI를 통해 검토될 수 있습니다
• 설치: Claude Code 플러그인 또는 OpenCode MCP 서버로 사용 가능

설정 명령어

claude plugin marketplace add mozilla-ai/cq
claude plugin install cq

사용 예시

Claude Code에게 GitHub 액션을 작성하도록 요청할 때, 훈련 데이터의 부실함으로 인해 여러 메이저 버전이 오래된 액션을 자주 사용했습니다. 이 문제를 식별한 후, 에이전트는 지식 단위를 제안했습니다. 나중에, OpenAI 모델과 함께 OpenCode를 사용하는 다른 저장소에서, 작업을 시작하기 전에 cq 스킬이 사용되어 메이저 버전에 대한 함정을 검색했습니다. 에이전트는 사전에 GitHub를 확인하고 올바른 최신 메이저 버전을 사용한 다음, KU를 확인하여 신뢰도 점수를 높였습니다.

철학과 접근 방식

이 프로젝트는 규칙이 과도하게 로드될 때 예측 불가능한 동작을 초래할 수 있는 CLAUDE.md나 AGENTS.md와 같은 정적 문서 파일을 넘어서는 것을 목표로 합니다. 대신, cq는 특정 작업에 대한 표적 정보를 제공합니다. 이 시스템은 특정 플랫폼에 종속되지 않고 모든 에이전트와 모든 모델과 함께 작동하도록 설계되었습니다.

현재 개념 증명 단계로, 이 프로젝트는 로컬 사용에서 팀 수준으로 반복하며, 궁극적으로 공공 커먼즈를 목표로 하고 있습니다. 팀은 데이터 프라이버시와 거버넌스에 대한 미래의 도전 과제를 인정하면서도 즉각적인 일상적 가치를 제공하는 데 집중하고 있습니다.

라이선스: Apache 2.0