JamesShi96/project-butler

해결하는 문제

AI 코딩 어시스턴트는 서로 다른 세션 간에 '기억 상실' 현상이 자주 발생하여, 사용자가 프로젝트 아키텍처, 이름 규칙, 이전 결정 사항을 다시 설명해야 하는 문제가 있다. project-butler는 프로젝트 폴더를 공유된 진실의 원천으로 만드는 지속 가능한 메모리 계층을 제공하여, Claude Code, Cursor, Codex와 같은 다양한 AI 도구가 이전 세션에서 끝난 지점부터 정확히 이어갈 수 있도록 한다.

작동 방식

이 도구는 프로젝트 루트에 직접 저장된 일반 Markdown 파일과 JSON 설정을 사용하여 7개의 구성 요소로 이루어진 메모리 스택을 구현한다. 이 스택은 정보의 안정성에 따라 구성된다:

• 안정된 규칙: 인간이 검토한 원칙이 CLAUDE.md에 저장됨.
• 현재 상태: 프로젝트 위키(PROJECT.md), 파일 구조 규칙(STRUCTURE.md), 마일스톤 변경 로그(UPDATE_LOG.md).
• 원시적 사실: 세션 로그와 TODO.md 체크리스트.
• 양도: session-handoff.md 파일을 통해 다음 어시스턴트가 어떻게 재개할지 명시적으로 전달함.

Claude Code의 네이티브 기능으로 통합되며, 다른 어시스턴트를 위해 호환 파일(예: .cursor/rules/project-system.mdc 또는 AGENTS.md)을 생성하여 동일한 메모리 프로토콜을 따르도록 보장한다.

대상 사용자

AI 코딩 어시스턴트를 사용하고 반복적인 컨텍스트 설정을 피하고 싶은 개발자. 특히 다양한 AI 도구를 전환하거나 복잡한 아키텍처를 가진 장기 프로젝트를 진행하는 사람에게 적합하다.

주요 특징

• 다양한 도구 호환성: 파일 기반 메모리 시스템을 사용해 Claude Code, Cursor, Codex에서 모두 작동 가능.
• 코드 기반 양도: end session으로 진행 상황을 저장하고, continue로 컨텍스트를 재개하는 특정 트리거를 사용.
• 프로필 인식 기능: 프로젝트 프로필을 생성하여 문서 계층과 보호 구역을 관리해 더 강력한 아키텍처 일관성을 달성.
• 자동 유지보수: 파일 정리, 위키 동기화, 자체 업데이트 자동 확인 기능 포함.