문서로 돌아가기

메모리 명령어

CLI 레퍼런스

Diverga 메모리 시스템 관리를 위한 CLI 명령어

"정확한 명령으로 컨텍스트를 제어하세요"

인터랙티브 데모

라이브 터미널 시뮬레이터에서 메모리 명령어를 체험해보세요:

CLI 명령어 데모
터미널
$

주요 명령어

notepad_read메모리 읽기
notepad_write_priority우선순위 저장
notepad_write_working작업 메모리 저장
notepad_write_manual수동 아카이브 저장

명령어 카테고리

메모리 명령어는 5가지 카테고리로 구성됩니다:

세션 명령어

현재 세션 상태 관리

/diverga:memory status/diverga:memory context

저장 명령어

메모리 저장 및 유지

/diverga:memory decision add/note <텍스트>/remember <텍스트>

검색 명령어

메모리 검색 및 회상

/diverga:memory decision list/diverga:memory context

유지보수 명령어

메모리 정리 및 새로고침

/diverga:memory clear/diverga:memory refresh

아카이브 명령어

완료된 단계 아카이브

/diverga:memory archive [STAGE]/diverga:memory export

명령어 상세

모든 메모리 명령어에 대한 종합 레퍼런스:

/diverga:memory status세션

현재 프로젝트 상태 및 활성 메모리 표시

사용법:

/diverga:memory status

출력:

프로젝트 이름, 현재 단계, 체크포인트 진행률, 메모리 상태

💡 예시

표시: 프로젝트 "AI 교육" | 단계: 문헌 검토 | 체크포인트 3/7 | 메모리: 12개 컨텍스트 로드됨

/diverga:memory context세션

로드된 전체 메모리 컨텍스트 표시

사용법:

/diverga:memory context [--detailed]

출력:

타임스탬프 및 출처가 포함된 모든 로드된 메모리

💡 예시

결정 근거가 포함된 자세한 출력을 위해 --detailed 플래그 사용

/diverga:memory init세션

새 프로젝트 메모리 초기화

사용법:

/diverga:memory init

출력:

.research/ 디렉토리 구조 생성

💡 예시

메모리 시스템 설정을 위해 프로젝트 시작 시 한 번 실행

/diverga:memory decision list검색

모든 체크포인트 결정 나열

사용법:

/diverga:memory decision list [--stage STAGE]

출력:

타임스탬프가 포함된 결정의 시간순 목록

💡 예시

단계별 필터링: /diverga:memory decision list --stage A1

/diverga:memory decision add저장

로그에 결정을 수동으로 추가

사용법:

/diverga:memory decision add

출력:

결정 기록을 위한 대화형 프롬프트

💡 예시

체크포인트 외부에서 중요한 방법론적 선택을 할 때 사용

/note <텍스트>저장

작업 메모리에 빠른 노트 저장 (7일 후 자동 삭제)

사용법:

/note "X에 대한 흥미로운 논문 발견"

출력:

타임스탬프가 포함된 노트가 세션 메모리에 저장됨

💡 예시

/note "Y 이론을 더 탐구할 필요 있음"

/remember <텍스트>저장

영구 메모리에 저장 (압축 후에도 유지)

사용법:

/remember "방법론에 대한 중요한 인사이트"

출력:

영구 노트가 프로젝트 메모리에 저장됨

💡 예시

/remember "표본 크기 계산: G*Power with f² = 0.15"

/diverga:memory archive [STAGE]아카이브

완료된 단계를 베이스라인에 아카이브

사용법:

/diverga:memory archive A1

출력:

단계가 .research/baselines/로 이동됨

💡 예시

완료된 작업을 잠그고 불변 기록 생성

/diverga:memory clear유지보수

세션 메모리 지우기 (프로젝트 메모리 유지)

사용법:

/diverga:memory clear [--session|--notes]

출력:

지워진 메모리 확인

💡 예시

현재 세션만 지우려면 --session, 연구 노트는 --notes 사용

/diverga:memory refresh유지보수

파일에서 메모리 다시 로드

사용법:

/diverga:memory refresh

출력:

디스크에서 메모리 새로고침됨

💡 예시

.research/ 파일을 수동으로 편집한 후 사용

/diverga:memory export아카이브

메모리를 마크다운 보고서로 내보내기

사용법:

/diverga:memory export [--format markdown|json]

출력:

형식화된 메모리 보고서

💡 예시

방법론 섹션을 위한 감사 준비 문서 생성

/diverga:memory migrate유지보수

v6.8에서 v7.0 메모리 구조로 마이그레이션

사용법:

/diverga:memory migrate

출력:

마이그레이션 상태 및 백업 위치

💡 예시

v6.8에서 업그레이드할 때 한 번만 필요

사용 예시

메모리 명령어를 사용한 일반적인 워크플로우:

새 연구 세션 시작

1

/diverga:memory status → 현재 프로젝트 상태 확인

2

/diverga:memory context → 이전 결정 검토

3

전체 컨텍스트가 로드된 상태로 작업 계속

결과:

재설명 없이 원활한 연속

중요한 인사이트 기록

1

/note "X와 Y 사이의 예상치 못한 상관관계" → 빠른 노트

2

/remember "주요 방법론적 결정: 회귀 대신 SEM 사용" → 영구 기록

3

/diverga:memory decision add → 근거와 함께 공식 결정 기록

결과:

다른 목적을 위한 다층 메모리 캡처

연구 단계 완료

1

/diverga:memory decision list --stage A1 → 단계 결정 검토

2

/diverga:memory archive A1 → 완료된 작업 잠금

3

/diverga:memory export --format markdown → 문서 생성

결과:

원고를 위한 감사 추적과 함께 단계 아카이브됨

메모리 문제 해결

1

/diverga:memory status → 메모리 상태 확인

2

/diverga:memory refresh → 디스크에서 다시 로드

3

/diverga:memory clear --session → 손상된 세션 데이터 지우기

결과:

메모리 시스템이 깨끗한 상태로 복원됨

명령어 플래그

명령어 동작을 수정하는 선택적 플래그:

--detailed

전체 결정 근거가 포함된 자세한 출력 표시

적용 대상: context

--stage <ID>

에이전트 단계별 결과 필터링 (예: A1, B2)

적용 대상: decision list

--format <type>

출력 형식: markdown, json, yaml

적용 대상: export

--session

세션 메모리만 지우고 프로젝트 메모리 유지

적용 대상: clear

--notes

연구 노트만 지우고 결정 유지

적용 대상: clear

--force

확인 프롬프트 건너뛰기

적용 대상: clear, archive

모범 사례

효과적인 메모리 관리를 위한 권장사항:

일시적 인사이트에는 /note 사용

장기적으로 관련이 없을 수 있는 빠른 관찰 (7일 후 자동 삭제)

중요한 결정에는 /remember 사용

방법론적 선택, 주요 발견, 지속되어야 하는 중요한 제약

완료 시 단계 아카이브

/diverga:memory archive로 완료된 작업의 불변 기록 생성

주요 변경 전 내보내기

연구 재구성 전 백업으로 마크다운 보고서 생성

정기적으로 상태 확인

/diverga:memory status를 사용하여 메모리 상태 및 로드된 컨텍스트 모니터링

메모리 저장소

다른 메모리 타입이 저장되는 위치:

.research/project-state.yaml

프로젝트 컨텍스트, 연구 질문, 패러다임

.research/decision-log.yaml

타임스탬프가 포함된 모든 체크포인트 결정

.research/sessions/

세션별 메모리 (작업 노트, /note 명령)

.research/baselines/

아카이브된 완료 단계 (불변)

.research/preferences.yaml

도구 선호도, 출력 형식

.research/checkpoints.yaml

체크포인트 상태 및 진행률

메모리 관리 마스터하기

고급 메모리 기능 및 통합 패턴을 탐색하세요.