agents-remember-md은(는) 무엇을 하나요?
복잡한 코드베이스에서 코딩 에이전트를 위한 드리프트 인식 저장소 메모리입니다. 코드만으로는 전달할 수 없는 정보를 캡처합니다! 벡터 검색, 컨텍스트 팽창, 또는 오래된 문서가 필요 없습니다.
개요
이 프로젝트는 AI 코딩 에이전트(예: Claude Code, Cursor, Codex)가 작업 중인 코드베이스에 대한 '메모리'를 유지할 수 있도록 설계된 경량 시스템입니다. 코드 자체는 무엇을 하는지 알려주지만, 왜 그렇게 했는지, 어떤 트레이드오프가 있었는지, 또는 어떤 가정이 숨겨져 있는지는 설명하지 못합니다. 이 스킬은 이러한 정보를 마크다운 파일로 체계화하고, 시간이 지남에 따라 발생하는 정보의 '드리프트'(변경으로 인한 불일치)를 관리합니다.
주요 기능
- 드리프트 감지: 저장된 메모리가 현재 코드베이스 상태와 일치하지 않을 때 자동으로 감지하고 표시합니다.
- 가벼움: 벡터 데이터베이스나 외부 검색 서비스 없이 마크다운 파일 기반으로 작동합니다.
- 컨텍스트 효율성: 불필요한 컨텍스트 팽창 없이 에이전트가 필요한 정보만 정확히 참조할 수 있습니다.
- 플랫폼 독립적: Claude Code, Cursor, Codex, Windsurf 등 주요 코딩 에이전트와 호환됩니다.
사용 방법
설치
# 저장소에 메모리 디렉토리 생성
mkdir -p .agent-memory
# 스킬 설정 파일 복사
cp path/to/skill.md .claude/skills/remember.md
메모리 작성
메모리는 일반 마크다운 파일로 .agent-memory/ 디렉토리에 저장합니다. 각 파일은 특정 주제나 영역에 대한 정보를 담습니다.
예시: .agent-memory/architecture-decisions.md
# 아키텍처 결정
## 2024-03-15: 마이크로서비스 분할 전략
**결정**: 사용자 서비스를 인증 서비스와 프로필 서비스로 분할.
**이유**:
- 인증 실패율이 전체 시스템 장애로 이어지는 것을 방지하기 위해 격리 필요
- 프로필 데이터 조회 시 인증 토큰 검증 병목 제거
**영향**:
- 인증 서비스는 stateless하게 유지 (세션 미사용)
- 프로필 서비스는 읽기 전용 복제본으로 확장 가능
드리프트 감지 및 업데이트
시간이 지나 코드가 변경되면, 에이전트는 drift-check 명령어를 사용하여 저장된 메모리가 여전히 유효한지 확인할 수 있습니다.
# 드리프트 검사 실행
drift-check .agent-memory/
# 검사 결과 예시
[WARN] architecture-decisions.md: 사용자 서비스가 더 이상 존재하지 않음
[INFO] deployment.md: 여전히 유효함
드리프트가 감지되면 에이전트는 메모리를 업데이트하거나 사용자에게 문의하여 최신 상태로 복원합니다.
지원 플랫폼
| 플랫폼 | 상태 | 비고 |
|---|---|---|
| Claude Code | ✅ 지원 | .claude/skills/에 배치 |
| Cursor | ✅ 지원 | .cursor/rules/에 배치 |
| Codex CLI | ✅ 지원 | SKILL.md로 직접 사용 |
| Windsurf | ✅ 지원 | .windsurf/skills/에 배치 |
라이선스
MIT License
기여
버그 리포트, 기능 제안, 풀 리퀘스트를 환영합니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요.