wellread - 다른 개발자가 이미 검색한 내용입니다.

당신의 에이전트가 수행할 다음 연구 작업은 이미 해결되었을 가능성이 높습니다. Wellread는 에이전트가 토큰을 낭비하며 재발견하기 전에 이를 찾아내며, 찾지 못할 경우 다음 개발자가 동일한 비용을 지불하지 않도록 합니다.

의미론적 캐싱 연구에 따르면 에이전트 연구 쿼리의 60~68%가 이전 쿼리와 중복됩니다 (출처). 또한 AI 기반 실시간 웹 검색은 2025년에 15배 증가했습니다 (Cloudflare). Wellread는 그 계층에 꼭 필요한 캐시입니다.

복합 효과

세션이 깊어질수록 연구 비용은 비싸지며, wellread의 절약 효과는 더욱 커집니다.

문제점

• 에이전트는 모든 기술적 질문을 처음부터 다시 연구합니다. 그렇지 않으면 오래된 API, 잘못된 예제, 깨진 코드 등으로 인해 환각(hallucination) 현상이 발생합니다.

• 모든 회차마다 전체 대화 내용을 다시 보냅니다. 100회차쯤 되면 동일한 컨텍스트에 대해 백 번의 비용을 지불하게 됩니다.

해결책

에이전트가 웹을 검색하기 전에 wellread가 다른 개발자들이 이미 찾은 내용을 확인합니다.

• 적중(Hit) → 검증된 소스에서 즉시 답변을 제공합니다. 웹 검색 없음. 1회차로 완료.

• 부분 적중(Partial) → 기존 내용을 바탕으로 시작하여 부족한 부분만 연구합니다.

• 실패(Miss) → 일반적인 연구를 수행한 후, 다음 사람을 위해 요약본을 저장합니다.

에이전트는 토큰을 적게 소비할 뿐만 아니라 더 정확해집니다. 모든 답변은 오래된 학습 데이터의 추측이 아닌, 검증된 실제 소스입니다.

설치

npx wellread

에디터를 재시작하세요. 그것으로 끝입니다.

업데이트: npx wellread@latest - 삭제: npx wellread uninstall

첫날부터 싱글플레이어

wellread의 혜택을 누리기 위해 많은 사람이 필요하지 않습니다.

싱글플레이어 - 자신의 연구 결과가 다시 돌아옵니다. 세션 간 반복 검색이 없고, 오래된 학습 데이터로 인한 환각도 없습니다.

멀티플레이어 - 다른 개발자가 이미 Auth.js 마이그레이션이나 Bun + Drizzle의 복잡한 상호작용을 해결했다면, 당신은 바로 답변으로 건너뛸 수 있습니다. 한 사람이 연구하면 모두가 혜택을 받습니다.

초기 사용자들이 네트워크를 구축합니다. 그들의 기여는 기록되며 영구적으로 남습니다.

신선도

각 항목은 해당 주제가 얼마나 빨리 변하는지 알고 있습니다:

에이전트가 재검증하면 모두를 위해 타이머가 초기화됩니다.

개인정보 보호

개인 컨텍스트와 공유 네트워크 사이에는 6개의 보호 계층이 있습니다:

1. 훅 지침(Hook instruction) - 데이터가 기기를 떠나기 전, 훅이 에이전트에게 쿼리를 정제하도록 지시합니다: 프로젝트 이름, API 키, 파일 경로, 자격 증명을 제거합니다. 일반적인 기술 개념만 전송됩니다.

2. 검색 스키마(Search schema) - 검색 도구의 매개변수 설명이 "프로젝트 이름, API 키, 파일 경로, 자격 증명을 제거하십시오"라고 강조합니다.

3. 저장 스키마(Save schema) - 저장 도구는 명시적으로 "프로젝트/저장소/회사 이름, 내부 URL, 파일 경로, 자격 증명, 비즈니스 로직을 절대 포함하지 마십시오. 콘텐츠는 공개됩니다"라고 명시합니다.

4. URL 게이트(서버, 강제 거부) - 모든 소스는 https:// 또는 http://로 시작해야 합니다. 파일 경로, 라이브러리 식별자, 내부 URL은 거부됩니다. 기여가 저장되지 않습니다.

5. 경로 탐지(서버, 강제 거부) - 서버가 콘텐츠와 검색 표면에서 로컬 경로(/Users/..., /home/..., file://, C:\...)를 스캔합니다. 발견 시 거부됩니다.

6. 설계상 - 에이전트는 당신의 입력을 그대로 전달하지 않습니다. 공개 소스에서 합성합니다. 저장되는 것은 당신의 코드나 대화가 아니라 공개 문서의 요약본입니다.

개인적인 내용이 다른 사용자에게 도달하려면, 에이전트가 자체 지침, URL 게이트, 경로 정규식 등을 모두 우회하여 일반적인 요약본에 포함시켜야 하며, 누군가가 그것을 노출시킬 만큼 유사한 내용을 검색해야 합니다.

통계

에이전트에게 물어보세요:

"show me my wellread stats"

토큰 절약량, 주요 기여 내용, 그리고 당신이 저장한 연구를 얼마나 많은 개발자가 사용했는지 확인할 수 있습니다.

지원 도구

모든 MCP 클라이언트와 작동합니다. Claude Code에서 가장 좋은 경험을 제공합니다. Cursor, Windsurf, Gemini CLI, VS Code, OpenCode도 지원합니다.

링크

• 웹사이트

• npm

라이선스

AGPL-3.0