kleosr/cursorkleosr

해결하는 문제

Cursor와 같은 AI 기반 IDE에서 에이전트가 매번 초기 상태에서 시작하거나 사용자가 수동으로 컨텍스트와 상태 파일을 제공해야 하는 '에이전트의 망각' 문제를 해결합니다.

작동 방식

이 프로젝트는 .cursor/rules/workflow-memory.mdc라는 특정 Cursor 규칙을 alwaysApply: true로 설정하여, AI 에이전트가 모든 세션에서 엄격한 운영 루프를 따라가도록 강제합니다. 에이전트는 작업을 수행하기 전에 workflow_state.md (현재 진행 상황, 계획, 장애 요인)와 project_config.md (목표 및 기술 스택)라는 두 개의 루트 Markdown 파일을 자동으로 읽습니다. 작업이 완료되면 업데이트된 상태를 Markdown 파일에 다시 씁니다. 이로써 리포지토리 내부에 지속적이고 차이 비교 가능한 메모리가 유지됩니다.

대상 사용자

AI 에이전트가 수동 프롬프트 없이 프로젝트 목표와 현재 진행 상황을 일관되게 장기적으로 기억할 수 있도록 하고 싶은 Cursor IDE 사용자.

주요 특징

• 항상 활성화된 메모리: Cursor 규칙을 사용해 상태 조회 및 업데이트를 자동화합니다.
• 의존성 없음: 순수한 Markdown 파일만 사용하므로 에디터에 독립적이며, 버전 관리가 쉽습니다.
• 구조화된 워크플로우: 명확한 ANALYZE → PREPARE → IMPLEMENT → VALIDATE 루프를 구현합니다.
• 투명한 상태: 프로젝트 진행 상황과 설정은 인간이 읽을 수 있고, grep으로 검색 가능한 텍스트 파일에 저장됩니다.