MemoryCustodian

1) MemoryCustodian 설치 (에이전트/워크플로우에 맞는 경로 선택): 하나의 설치 방법을 선택하세요: - 코딩 에이전트에게 리포지토리에서 기술을 설치하도록 요청: https://github.com/waittim/MemoryCustodian - Codex (로컬 마켓플레이스): 체크아웃에서 `codex plugin marketplace add .`를 실행한 다음, `codex plugin add memory-custodian@memory-custodian-dev`를 실행합니다. - Claude Code (플러그인): 로컬 테스트를 위해 `claude --plugin-dir .`를 실행하거나, `./install.sh claude`로 개인 기술에 설치합니다. - Gemini 스타일 에이전트: `./install.sh gemini` 또는 `gemini skills link ./skills/memory-custodian`으로 설치합니다. - CLI/소스 체크아웃: `scripts/memory-custodian ...`를 통해 리포지토리에서 실행하거나, `python3 -m pip install -e .`로 편집 가능한 상태로 설치하여 `memory-custodian` 명령을 얻습니다.

2) 프로젝트에 MemoryCustodian 초기화 (리포당 한 번): 각 대상 프로젝트에 대해 초기화를 한 번 실행합니다: - 콘솔 스크립트로 설치된 경우: `memory-custodian init --project-root /path/to/project --agent all` - 소스 체크아웃에서: `scripts/memory-custodian init --project-root /path/to/project --agent all` 에이전트가 읽는 얇은 부트스트랩 파일을 생성하려면 `--agent codex`, `--agent claude`, `--agent gemini` 또는 `--agent all`을 사용하세요.

3) 초기화가 생성하는 내용 이해 (메모리가 상주하는 곳): 초기화는 `docs/memory/` 아래에 기본 지속성 메모리 세트를 생성합니다: - `manifest.md` (로드할 내용을 라우팅) - `brief.md` (현재 프로젝트 형태) - `decisions.md` (주요 결정) - `constraints.md` (하드 요구 사항) - `do-not-use.md` (거부된 경로 / 툼스톤) - `inbox.md` (스테이징 영역) 플랫폼 부트스트랩 파일(예: `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`)은 얇게 유지되며 에이전트를 `docs/memory/`로 안내합니다.

4) 생성된 요약을 신뢰하기 전에 큐레이션: `init` 후, `brief.md`는 TODO가 있는 스캐폴드로 시작합니다. 메모리를 준비된 것으로 간주하기 전에 권위 있는 프로젝트 소스(README, 코드, 문서)에서 내용을 채우세요. `memory-custodian status --project-root /path/to/project` (또는 `scripts/memory-custodian status ...`)를 사용하여 요약이 아직 큐레이션되지 않았는지 확인하세요. `status` 및 `check`는 큐레이션되지 않은 요약을 보고합니다.

5) 작업에 적합한 메모리 로드 (매니페스트 우선 읽기): 에이전트의 의도된 워크플로우는 다음과 같습니다: 1) `docs/memory/manifest.md`를 읽습니다. 2) `docs/memory/brief.md`를 읽습니다. 3) 매니페스트가 현재 작업에 관련 있다고 표시한 파일만 로드합니다. 수동 검사를 위해 다음을 사용하여 컨텍스트 팩을 생성합니다: - `memory-custodian read --project-root /path/to/project --task planning` - `memory-custodian read --project-root /path/to/project --task implementation` - `memory-custodian read --project-root /path/to/project --task artifact`

6) 현재 채팅을 넘어 지속되어야 할 때 지속성 메모리 추가: CLI를 사용하여 결정/제약 조건/선호도/거부된 접근 방식을 기록합니다: - `memory-custodian add "우리는 매니페스트 우선 로딩을 선택했습니다." --type decision` - `memory-custodian add "동기화 재시도 백오프를 유지합니다." --type decision --area sync --reason "시작 전반에 걸쳐 재시도를 제한합니다."` 결정 항목을 짧게 유지하세요 (도구는 토큰 가이드를 적용하며 명시적으로 긴 항목을 허용하지 않는 한 너무 긴 쓰기를 거부합니다).

7) 관련성이 있을 때만 선택적 메모리 모듈 활성화: 선택적 모듈(예: 규칙, 프로필, 영역)은 옵트인이며 매니페스트에 의해 활성화되고 라우팅되지 않는 한 로드되지 않습니다. 필요에 따라 활성화하세요: - `memory-custodian enable preferences` - `memory-custodian enable rules/output` - `memory-custodian enable profile/git` - `memory-custodian enable area/frontend` 활성화는 기존 모듈 파일을 덮어쓰지 않습니다.

8) 거부된 접근 방식을 보존하고 회귀를 방지하기 위해 'do-not-use' 사용: 접근 방식(예: 저장소 백엔드 또는 아키텍처)을 의도적으로 거부할 때, `docs/memory/do-not-use.md`에 기록하여 (편집 또는 적절한 추가/삭제 워크플로우를 통해) 향후 세션에서 다시 제안하지 않도록 합니다.

9) 상태 및 프로토콜 호환성 정기적으로 확인: 구조, 예산 및 프로토콜 메타데이터가 올바른지 확인하기 위해 결정론적 유효성 검사를 실행합니다: - `memory-custodian check --project-root /path/to/project` 빠른 개요 및 큐레이션되지 않은 요약을 감지하려면 `memory-custodian status`를 사용하세요.

10) 메모리 압축 및 유지 관리 (미리보기 우선, 안전한 변경): 메모리를 작고 최신 상태로 유지하려면 유지 관리 명령을 사용하세요: - `memory-custodian compact --project-root /path/to/project` 압축은 보호되며 미리보기 우선입니다. 계획을 검토한 후에만 변경 사항을 적용하세요. 받은 편지함 압축은 보수적이며 (예: 정확히 중복되는 최상위 글머리 기호 단위 제거 및 툼스톤 필터링) 에이전트/사람이 결정/제약 조건으로 의미론적 승격을 수행할 것으로 예상합니다.

11) 오래된 정보 안전하게 삭제 (미리보기 우선): 미리보기 우선 삭제를 통해 오래된 주제를 제거하거나 수정합니다: - 미리보기: `memory-custodian forget "오래된 배포 노트" --mode soft --project-root /path/to/project` - 검토 후 적용: `memory-custodian forget "오래된 배포 노트" --mode soft --apply --project-root /path/to/project` 광범위한 일치는 명시적 확인이 필요합니다 (예: `--allow-broad-match`). 일부 경우에는 수동 재작성이 필요합니다. 도구는 안전하지 않은 전체 삭제를 거부합니다.

12) 필요할 때 기존 설정 복구 또는 교체: 파일이 누락되었거나 큐레이션된 콘텐츠를 덮어쓰지 않고 메타데이터를 업데이트해야 하는 경우: - 복구: `memory-custodian init --project-root /path/to/project --repair` 의도적으로 전체 교체를 원한다면 미리보기 우선 교체를 사용하고 올바른 경우에만 적용하세요: - `memory-custodian init --project-root /path/to/project --replace-existing` - 그런 다음 나열된 파일을 교체해야 하는 경우에만 `--apply`를 추가합니다.

13) 도구가 업데이트될 때 프로토콜/프로젝트 메모리 버전 마이그레이션: `check`가 오래되었거나 누락된 프로토콜 메타데이터를 보고할 때, 프로젝트 매니페스트를 오프라인으로 마이그레이션합니다: - 미리보기: `memory-custodian migrate --project-root /path/to/project` - 검토 후 적용: `memory-custodian migrate --apply --project-root /path/to/project`

14) Windows와 소스 체크아웃에서 올바른 호출 사용: Windows에서는 콘솔 명령을 설치하고 `memory-custodian ...`를 사용합니다. 모든 플랫폼의 리포지토리 체크아웃에서 래퍼로 `scripts/memory-custodian ...`를 실행할 수 있습니다.