Community라이팅 & 에디팅github.com

RecallLoom

장기 실행 AI 작업을 위한 프로젝트 메모리입니다. 컨텍스트, 결정, 진행 상황 및 다음 단계를 로컬 프로젝트 파일에 유지합니다.

RecallLoom란 무엇인가요?

RecallLoom은 세션 기반 AI 에이전트를 위한 휴대용 컨텍스트 관리 도구입니다. Python 3.10+ 환경에서 작동하며, 별도의 인프라 없이 프로젝트 파일 내에서 컨텍스트, 결정 사항, 진행 상황 및 다음 단계를 지속적으로 유지할 수 있습니다. `context_brief.md`, `rolling_summary.md`, `daily_logs/` 등의 파일을 통해 안정적인 프로젝트 프레임, 현재 상태 스냅샷 및 마일스톤 증거를 계층적으로 관리합니다. Claude, Gemini, GitHub Copilot 등 다양한 AI 에이전트와 모델을 지원하며, `rl-init`, `rl-resume`, `rl-status`, `rl-validate` 등의 명령어로 쉽게 프로젝트 컨텍스트를 복원하고 관리할 수 있습니다. 패키지 지원 상태에 따라 읽기 전용, 진단 전용, 또는 전체 작업이 가능하며, 변조나 오류가 발견되면 작업을 차단하여 데이터 무결성을 보장합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add Frappucc1no/recall-loom

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

RecallLoom은(는) 무엇을 하나요?

RecallLoom은 세션 기반 에이전트를 위한 휴대용 컨텍스트 관리 도구입니다.

무거운 인프라 없이 세션 간 프로젝트 연속성을 유지할 수 있는 가벼운 파일 모델을 제공합니다.

목표는 모든 것을 기억하는 것이 아닙니다. 목표는 올바른 프로젝트 상태를 세션 간에 지속 가능하고, 읽기 가능하며, 복구 가능하게 유지하는 것입니다.

패키지 범위

이 파일은 설치 가능한 recallloom/ 스킬 패키지의 에이전트 진입점입니다.

호스트 에이전트의 일반적인 스킬 검색 흐름을 통해 이 패키지를 설치하고 트리거하십시오. RecallLoom 자체는 패키지 내부에 호스트별 런처가 필요하지 않습니다. 패키지에는 지원되는 호스트를 위한 선택적 네이티브 래퍼 템플릿이 포함될 수 있습니다.

이 설치 가능한 패키지는 의도적으로 최소한으로 유지됩니다. 사용자 대상 리포지토리 랜딩 페이지 및 마케팅 문서는 상위에 존재할 수 있지만, 설치된 스킬 디렉토리에는 포함되지 않습니다.

소스 리포지토리에서 README.md와 README.en.md는 간결한 공용 진입점이고, README.zh-CN.md는 호환성 진입점이며, INDEX.md는 전체 맵이고, USAGE.md는 운영자 가이드입니다. 이 파일들은 설치된 패키지 진입점과 동일한 도우미 계약을 설명하며, 두 번째 로직 세트를 정의하지 않습니다.

패키지 인벤토리, 프로토콜 세부 정보 및 도우미 스크립트 동작에 대해서는 패키지 내부에 포함된 파일을 참조하십시오:

  • managed-assets.json
  • package-metadata.json
  • references/file-contracts.md
  • references/operation-playbooks.md
  • references/package-support-policy.md
  • references/recording-workflow.md
  • references/protocol.md

패키지 정보

  • 패키지 버전: 0.4.6.1
  • 프로토콜 버전: 1.0
  • 지원 프로토콜 버전:
    • 1.0

런타임 가정

  • Python 3.10 이상
  • 지원 작업 공간 언어:
    • en
    • zh-CN
  • 지원 브리지 대상:
    • AGENTS.md
    • CLAUDE.md
    • GEMINI.md
    • .github/copilot-instructions.md

패키지 지원 게이트

RecallLoom 패키지 지원은 프로젝트 사이드카 프로토콜 호환성과 별개입니다.

  • 도우미는 패키지 지원 검사를 수행해야 하며 지원 상태를 프로젝트 .recallloom/에 기록해서는 안 됩니다.
  • 지원이 readonly_only인 경우, 변경 도우미는 차단되어야 하며 진단 및 읽기 전용 도우미는 계속 진행할 수 있습니다.
  • 지원이 diagnostic_only인 경우, 진단 도우미만 계속 진행해야 합니다.
  • 지원이 unknown_offline인 경우, 진단 및 읽기 전용 작업은 계속될 수 있지만, 변경 작업은 지원을 확인할 수 있을 때까지 차단되어야 합니다.
  • 차단된 작업은 blocked_reason: package_support_blocked 및 package_support 객체와 함께 공유 실패 계약을 반환해야 합니다. references/package-support-policy.md를 참조하십시오.

공개 표면 및 필수 검사

  • 공개 패키지 및 릴리스 표면은 사용자가 패키지를 설치, 이해 및 운영하는 데 필요한 파일로 제한되어야 합니다.
  • 공개 표면에는 복사된 프로젝트 메모리, 생성된 런타임 출력, 머신 로컬 데이터, 관리자 전용 작업 파일 또는 설치 가능한 패키지에 필요하지 않은 자료가 포함되어서는 안 됩니다.
  • 공개 CI 및 필수 검사는 리포지토리 내용 및 메타데이터를 검증할 수 있습니다.
  • 필수 검사 문구는 리포지토리 검사를 사용자의 로컬 작업 공간 상태, 호스트 동작 또는 사이드카 신뢰 상태의 증거로 제시해서는 안 됩니다.

비침해적 기본값 및 UX 게이트

  • 핵심 설치 및 일상적인 사용은 훅, 데몬, 감시자, MCP/플러그인 강제, 호스트 어댑터, 텔레메트리/메트릭 또는 원격 페이로드 전송을 요구하거나 자동 설치해서는 안 됩니다.
  • 네이티브 명령 래퍼는 동일한 디스패처에 대한 선택적 편의 진입점일 뿐이며 필수 적용 계층이 아닙니다.
  • 관리되는 사이드카 외부의 일반 문서/소스/계획 편집은 출처에 민감한 RecallLoom 상태에 영향을 미치지 않는 한 자동 허용 또는 낮은 마찰을 유지합니다.
  • 관리되는 사이드카 또는 출처에 영향을 미치는 작업은 출처 상태가 관련이 있는 경우 도우미 준비 출력에 allow, warn, ask 또는 block 중 하나를 표시합니다.
  • warn은 위험이 낮은 구조 전용 또는 읽기 가능한 레거시 상태를 위한 것이며 간결해야 하며, 동일한 세션의 반복적인 저위험 경고는 쿨다운 친화적이어야 합니다.
  • ask는 레거시 검토/복구 가져오기 또는 검토된 가져오기 기준 작업을 위한 것이며, 위험이 더 높은 쓰기 전에 명시적인 운영자 확인이 필요합니다.
  • block은 위조 마커, 감지된 수신/저장 불일치, 직접 state.json/config.json 편집, 개인 정보 보호 위반 및 inconsistent_or_tampered_evidence로 분류된 모든 상태에 대해 양보할 수 없습니다.
  • 원격 서비스, 호스트 메모리, 플러그인, MCP, 훅 또는 래퍼를 로컬 도우미 증거의 권위자로 제시하지 마십시오.
  • 영수증 기반 변형은 디스패처가 발행한 관리 파일 쓰기, 최신 커서에 대한 일일 로그 추가, 추가 후 요약 동기화로 제한됩니다. 보관 적용 및 브리지 적용은 해당 표면이 자체 영수증 지원을 얻을 때까지 미리보기 전용으로 유지됩니다.

쓰기 프로토콜 레드라인

  • 관리되는 사이드카 쓰기는 도우미 스크립트를 사용해야 합니다. 블라인드 파일 교체, 블라인드 패치 또는 수동 사이드카 파일로 이를 우회하지 마십시오.
  • 일일 로그 쓰기는 append_daily_log_entry.py 또는 디스패처 append를 사용해야 합니다. daily-log-entry 마커를 수동으로 작성하지 마십시오.
  • 일일 로그 커서 복구는 repair_daily_log_cursor.py 또는 디스패처 repair-daily-log-cursor를 사용해야 합니다. state.json.daily_logs를 수동으로 편집하지 마십시오.
  • 덮어쓰기 스타일 관리 파일은 개정 인식 도우미 커밋을 사용해야 합니다. file-state 마커를 수동으로 작성하지 마십시오.
  • STORAGE_ROOT/state.json 및 STORAGE_ROOT/config.json은 정상 작동 중에 수동으로 편집해서는 안 됩니다.
  • 프로토콜 1.0 일일 로그 카운터는 파일 로컬입니다. entry-seq는 단일 일일 로그 내에서 1..N이며, 표준 entry-id는 entry-{entry_seq}입니다. 둘 중 어느 것도 전역적으로 고유한 것으로 취급하지 마십시오.
  • state.json.daily_logs.entry_count를 entry_count로 유지하십시오. 이는 최신 활성 일일 로그의 항목 마커 수를 의미하며, 전역 누적 수가 아닙니다.
  • 도우미 쓰기가 실패하면 진단, 수정, 재시도한 다음 그래도 완료할 수 없으면 도우미 실패 계약을 표시하십시오.
  • 손상된 사이드카 복구는 표준 복구 제안/검토/승격 도우미와 validate_context.py를 사용해야 합니다. 관리 마커, state.json, config.json, 영수증 또는 도우미 증거 저장소를 수동으로 편집하지 마십시오.

사용 시기

다음과 같은 경우 RecallLoom을 사용하십시오:

  • 일시 중지 후 기존 프로젝트를 계속할 때
  • 유지 관리되는 파일에서 프로젝트 컨텍스트를 복원할 때
  • 현재 상태 프로젝트 메모리를 유지할 때
  • 의미 있는 마일스톤 진행 상황을 기록할 때
  • 세션 또는 도구 간 컨텍스트 드리프트를 줄일 때

일반적인 트리거는 다음과 같습니다:

  • 이 프로젝트 계속
  • 프로젝트 컨텍스트 복원
  • 중단한 곳에서 계속
  • rl-init
  • 프로젝트 메모리 업데이트
  • 오늘의 진행 상황 기록
  • 유지 관리되는 프로젝트 파일 내에서 깔끔한 다음 단계 핸드오프 준비

최초 연결 동작

프로젝트에서 처음으로 명시적으로 호출될 때 RecallLoom은 작업 공간이 이미 초기화되었다고 가정해서는 안 됩니다.

올바른 흐름은 다음과 같습니다:

  1. 유효한 RecallLoom 사이드카가 이미 있는지 감지합니다.
  2. 존재하는 경우 초기화를 별도의 절차로 만들지 않고 정상적으로 계속합니다.
  3. 존재하지 않는 경우 프로젝트가 아직 초기화되지 않았음을 설명하고 초기화를 수행할지 묻습니다.
  4. 사용자가 명시적으로 확인하거나 직접 rl-init이라고 말하면 표준 초기화 작업을 실행합니다.
  5. 환경이 Python 3.10+을 제공할 수 없는 경우 수동으로 사이드카를 빌드하는 대신 차단된 런타임 결과로 중지합니다.

rl-init은 다음을 의미해야 합니다: 사이드카 초기화, 작업 공간 검증, 다음 권장 작업 반환. 호스트가 네이티브 슬래시 명령을 노출하지 않는 경우에도 안정적인 상위 수준 작업 이름으로 취급하십시오.

현재 작업 표면

현재 패키지 라인의 경우 안정적인 운영자 대상 래퍼 대상은 다음과 같습니다:

  • rl-init
  • rl-resume
  • rl-status
  • rl-validate

rl-init은 운영자 친화적인 최초 연결 작업 이름입니다. 나머지는 호스트 에이전트가 해석하거나 호스트가 해당 표면을 지원하는 경우 네이티브 사용자 지정 명령에 매핑할 수 있는 운영자 대상 안정적인 작업 이름입니다. rl-bridge는 브리지 작업에 대한 표준 디스패처/도우미 작업 레이블로 유지되지만, 이 패키지 라인은 해당 레이블에 대한 보편적인 네이티브 래퍼 또는 결정론적 첫 번째 홉 라우팅을 약속하지 않습니다. 자연어는 이러한 작업에 대한 기본 공용 표현으로 유지됩니다.

디스패처 명령 표면에는 quick-summary, record --plan, append, write, sync-current-state-after-append 및 repair-daily-log-cursor도 포함됩니다. quick-summary는 현재 상태 스냅샷에, record --plan은 기록 의도를 분류하고 다음 안전한 도우미 단계를 얻는 데, append --entry-json은 마일스톤 로깅에, write --type ... --source-file <prepared-file> --dry-run 또는 write --type ... --stdin --dry-run은 유형화된 관리 파일 쓰기 전에, sync-current-state-after-append --reuse-current-summary --semantic-unchanged-assertion-json <json>은 사전 점검에서 메타데이터 전용 post_append_summary_sync를 허용한 후에만 사용하십시오. 바인딩된 어설션 JSON 스켈레톤은 references/recording-workflow.md를 참조하십시오. repair-daily-log-cursor는 state.json.daily_logs가 구문 분석된 최신 활성 일일 로그와 더 이상 일치하지 않는 경우 먼저 미리보기 모드로 사용하십시오. 적용 모드에는 --apply --yes가 필요하며, 새 미리보기/상태 확인 후 --expected-workspace-revision을 포함해야 하고, 변경으로 지원 게이트되며, 도우미 영수증을 작성하거나 일일 로그 내용을 다시 쓰지 않고 커서 필드를 복구합니다. 이러한 디스패처 추가 사항은 기존 v0.3.4 프로젝트에 대해 선택 사항이며 사이드카 프로토콜 1.0을 변경하지 않습니다.

rl-init, rl-resume, rl-status 및 rl-validate에 대한 네이티브 래퍼는 편의 진입점일 뿐입니다. 동일한 디스패처에 위임해야 하며 자연어 복원 요청을 대체하거나, 도우미를 우회하거나, 호스트별 제품 로직 복사본을 생성해서는 안 됩니다.

초기화된 프로젝트 복원 계약

호스트 또는 에이전트가 일반적인 초기화된 프로젝트 복원 요청을 볼 때:

  1. 광범위한 스킬 확장 전에 유효한 RecallLoom 사이드카를 확인합니다.
  2. 사이드카가 유효하면 일반적인 RecallLoom 빠른 경로로 라우팅합니다.
  3. 사이드카가 없거나, 충돌하거나, 명백히 불충분하거나, 사용자가 명시적으로 더 깊은 검토를 요청하는 경우에만 더 넓은 메모리 또는 워크플로 시스템이 참여하도록 합니다.

현재 패키지 라인의 경우 rl-resume은 초기화된 프로젝트 복원 체크포인트에 대한 단일 안정적인 운영자 대상 작업 이름입니다. 자연어 복원 요청은 여전히 기본 공용 경로입니다. 패키지 계약에 의해 지원되지 않는 수동 사이드카 폴백 또는 호스트 로컬 복원 별칭을 발명하지 마십시오.

공개 상호 작용 규칙

RecallLoom은 구현 언어가 아닌 사용자 작업 언어를 기본값으로 사용해야 합니다.

  • "초기화", "복원", "기존 프로젝트 현실 가져오기", "계속", "진행 상황 기록"을 선호합니다.
  • 사용자가 명시적으로 운영자/디버그 작업을 수행하지 않는 한 도우미 이름, 섹션 키 또는 coldstart 레이블로 시작하지 마십시오.
  • 첫 번째 응답은 결과 우선, 작업 최소로 유지하십시오: 라우팅 세부 정보를 노출하는 것보다 명확한 다음 단계 하나가 더 좋습니다.
  • 런타임 요구 사항이 누락된 경우 수동 사이드카 폴백을 발명하지 말고 차단된 상태를 표시하고 중지하십시오.
  • 이것은 수동으로 사이드카를 빌드하는 것이 아니라 패키징된 복원 및 도우미 계약입니다.

빠른 경로 및 심층 경로

RecallLoom은 빠른 경로를 기본 상호 작용 모드로 처리해야 합니다.

  • 빠른 경로: 가장 작은 신뢰할 수 있는 소스 세트, 가장 짧은 상호 작용, 가장 낮은 중단 비용.
  • 심층 경로: 소스가 충돌하거나, 소스 범위가 충분하지 않거나, 직접 권장 사항에 대한 위험이 너무 높거나, 사용자가 명시적으로 더 깊은 검토를 요청하는 경우에만.
  • 호스트 메모리 입력은 옵트인 및 힌트 전용으로 유지됩니다. 그 존재는 에이전트가 자동 승격 대신 명시적 검토를 하도록 편향되어야 합니다.

재개 모드 선택:

  • 다음 에이전트가 읽을 항목을 결정하기 전에 일반적인 계층화된 읽기 계획 지침이 필요한 경우 기본 resume 또는 status를 사용하십시오.
  • 현재 상태 지향성으로 충분하고 state.json 및 rolling_summary.md에서 다음 안전한 작업을 선택할 수 있는 경우 resume --fast를 사용하십시오.
  • 작업 전에 안정적인 프레임, 진실 공급원 라우팅 또는 프로젝트 로컬 update_protocol.md 지침이 필요한 경우 resume --full을 사용하십시오.
  • query_continuity.py를 통해 주문형으로 일일 로그 증거를 유지하십시오. 빠른 재개 및 전체 재개 모드는 기본적으로 일일 로그로 확장되어서는 안 됩니다.

핵심 파일 모델

RecallLoom은 세 가지 기본 메모리 계층을 사용합니다:

  • STORAGE_ROOT/context_brief.md: 안정적인 프로젝트 프레이밍
  • STORAGE_ROOT/rolling_summary.md: 덮어쓰기 스타일 현재 상태 스냅샷
  • STORAGE_ROOT/daily_logs/YYYY-MM-DD.md: 추가 전용 마일스톤 증거
  • STORAGE_ROOT/config.json: 머신이 읽을 수 있는 작업 공간 설정
  • STORAGE_ROOT/state.json: 동시성 인식 도우미를 위한 머신이 읽을 수 있는 사이드카 상태
  • STORAGE_ROOT/update_protocol.md: 읽기 및 쓰기 동작에 대한 권장 프로젝트 로컬 재정의 계층

파일 책임을 한 문장으로 요약:

  • context_brief.md는 이 프로젝트가 무엇이며 어떻게 접근해야 하는지 설명합니다.
  • rolling_summary.md는 지금 사실인 것이 무엇인지 설명합니다.
  • daily_logs/는 마일스톤 수준에서 무슨 일이 일어났는지 설명합니다.
  • config.json은 스토리지 및 언어 설정을 안정적으로 유지합니다.
  • state.json은 작업 공간 개정 및 도우미가 볼 수 있는 사이드카 상태를 추적합니다.
  • update_protocol.md가 있는 경우 이 특정 프로젝트에 대한 기본 읽기/쓰기 규칙을 좁히거나 강화할 수 있습니다.

STORAGE_ROOT는 PROJECT_ROOT/.recallloom/ 또는 PROJECT_ROOT/recallloom/입니다. 정확히 하나의 유효한 저장소 루트가 존재할 수 있습니다. 둘 다 존재하면 추측하는 대신 중지하십시오.

헤딩 레이블이 아닌 머신이 읽을 수 있는 마커가 규범적인 파일 계약입니다. 프로토콜 1.0은 작업 공간 언어 en 및 zh-CN을 지원합니다. references/file-contracts.md를 참조하십시오.

최소 콜드 스타트 흐름

  1. 프로젝트 루트를 찾습니다.
  2. STORAGE_ROOT/config.json을 읽습니다.
  3. STORAGE_ROOT/state.json을 읽습니다.
  4. STORAGE_ROOT/rolling_summary.md를 읽습니다.
  5. STORAGE_ROOT/update_protocol.md가 있는 경우 읽습니다.
  6. 빠른 재개가 요청되었거나 현재 상태 지향성이 충분한 경우 빠른 경로를 사용합니다.
  7. 빠른 경로가 적용되지 않거나 심층 검토가 필요한 경우 context_brief.md 및 소스 파일을 검토합니다.
  8. 일일 로그 증거는 query_continuity.py를 통해 주문형으로 유지됩니다.
  9. 재개 계획을 준비합니다.

운영자 가이드 참조

rl-init을 실행한 후:

  • rl-resume은 안정적인 복원 단계로, 빠른 경로와 심층 경로를 모두 처리합니다.
  • rl-status는 현재 사이드카 상태와 마지막으로 기록된 진행 상황을 보여줍니다.
  • rl-validate는 사이드카 무결성과 런타임 요구 사항을 확인합니다.

고급 사용 및 문제 해결은 설치된 패키지의 references/ 아래에 있는 참조 파일을 참조하십시오.

관련 스킬