kunchenguid/backpass

해결하는 문제

backpass는 AI 에이전트 메모리 파일(AGENTS.md 또는 CLAUDE.md 등)과 프로젝트 기술을 자동으로 개선하기 위해 설계된 도구입니다. 실패를 기억한 후 인간이 수동으로만 업데이트되는 '오래된' 에이전트 지침의 문제를 해결합니다. 실제 사용 트랜스크립트를 기반으로 에이전트 세션을 "손실 신호"로 간주하여, 지침이 무시된 곳, 해를 끼친 곳, 또는 현재 지침이 커버하지 못하는 공백이 있는지를 식별합니다.

작동 방식

이 도구는 메모리 최적화에 "경사 하강"의 비유를 사용합니다:

1. 수집: API를 사용하지 않고 데이터를 업로드하지 않고, 디스크에서 직접 다양한 에이전트 허슬(예: Claude Code, Codex, Cursor CLI)의 로컬 트랜스크립트를 읽습니다.
2. 정제: 원시 트랜스크립트는 도구 호출 노이즈를 제거하여 96-99% 축소되며, 핵심 사용자/어시스턴트 대화와 마스킹된 시크릿만 유지됩니다.
3. 손실 계산: 저비용 모델이 정제된 추적의 최근성 가중 샘플을 분석하여 어떤 지침이 도움이 되었는지, 어떤 지침이 위반되었는지, 그리고 현재 지침이 커버하지 못하는 실수가 발생했는지를 식별합니다.
4. 집계: 증거는 지침별로 그룹화됩니다. 제안된 모든 수정(추가, 재작성, 제거)은 노이즈로 인한 수정을 방지하기 위해 최소 두 개의 서로 다른 세션에서의 증거가 필요합니다.
5. 사람의 게이트: 이 도구는 파일에 자동으로 쓰지 않습니다. 사용자는 backpass apply를 실행하여 각 제안된 수정과 그 뒷받침되는 정확한 인용문을 검토한 후 수락하거나 거부해야 합니다.

대상 사용자

세션 간의 컨텍스트와 일관성을 유지하기 위해 프로젝트 고유의 메모리 파일이나 기술 세트에 의존하는 AI 코딩 에이전트를 사용하는 개발자들입니다.

주요 특징

• 로컬 우선: 트랜스크립트는 디스크에서 직접 읽힙니다. 도구 자체는 외부 API 키가 필요하지 않습니다(사용자의 기존 acpx 인증을 사용).
• 증거 기반: 모든 제안된 변경 사항은 실제 세션에서의 정확한 인용문으로 뒷받침됩니다.
• 사람이 루프에 참여: 모든 변경 사항은 수동 검토 프로세스를 통해 제어됩니다.
• 다중 허슬 지원: Claude Code와 Cursor CLI를 포함한 7개의 다른 에이전트 트랜스크립트 저장소와 호환됩니다.