테마
Memory
목표
Kiro의 Memory가 세션 사이로 어떤 맥락을 이어가는지, 학습·회상을 어떻게 제어하고 저장된 memory를 어떻게 검토하는지 이해합니다.
개념
Memory는 Kiro가 한 채팅 세션의 맥락을 다음 세션으로 이어가게 합니다. 저장소 명령과 컨벤션, 교정, 디버깅 인사이트, 이미 배제한 접근, 선호하는 작업 방식을 기억했다가, 다시 필요할 때 이후 작업에 씁니다.
- Memory는 Kiro 에이전트 harness의 일부입니다. "무엇을 남길 만큼 유용한가"와 "지금 작업에 맞는 memory를 어떻게 찾는가"라는 두 문제를 함께 풉니다.
- 각 memory는 과거 대화의 복사본이 아니라 title, description, content를 가진 레코드입니다.
- memory는 워크스페이스별이 아니라 사용자 계정별로 로컬 저장됩니다. 같은 컴퓨터의 Kiro IDE와 Kiro CLI는 저장된 memory를 공유하지만, 앱마다 자체 Memory 설정을 가집니다.
Memory의 동작
Memory는 Kiro가 이미 쓰는 맥락에 학습과 회상을 더합니다.
- 현재 작업에서 시작 — 요청, 현재 대화, Steering이 현재 컨텍스트로 harness에 들어갑니다.
- 작업에서 학습 — harness가 유용한 맥락을 식별해 memory를 만들거나 다듬습니다.
- 관련될 때 회상 — 이후 세션에서 요청에 맞는 memory를 꺼내 작업에 씁니다.
다른 맥락과의 관계
| 맥락 | 설명 |
|---|---|
| Memory | Kiro가 작업에서 학습해 이후 세션에서 회상할 수 있는 맥락 |
| Steering | 명시적으로 통제하고 싶을 때 직접 쓰는 규칙·지침 |
| Session history | 같은 세션을 이어갈 때 이미 진행 중인 대화·작업 |
| Compaction | 긴 세션을 컨텍스트 한도 안에 두기 위한 오래된 기록 요약 |
| Knowledge bases (CLI) | 직접 고르고 색인해 Kiro가 검색하는 참고 자료 |
어떤 규칙이 항상 일관되게 적용되어야 한다면 Memory에 맡기지 말고 Steering에 직접 쓰세요.
학습·회상 제어 (IDE)
Kiro IDE는 하나의 사용자 설정으로 Memory를 제어합니다. 기본값은 Off입니다. 활동 표시줄의 Memories 아이콘 → Memory settings 기어에서 접근 수준을 고릅니다.
| 접근 수준 | 동작 |
|---|---|
| Use and learn | memory를 쓰고, 권한 범위에서 변경·자동 생성·갱신 |
| Use but don't learn | memory를 쓰고 요청 시 변경하나, 자동 생성·갱신은 안 함 |
| Use only | 기존 memory만 읽고, 요청해도 생성·갱신·삭제 안 함(읽기 전용) |
| Off | memory를 쓰지도 바꾸지도 않음(기본값) |
Memory를 켜고 끄거나 Use only로 전환하는 변경은 새 세션에 적용됩니다. Use and learn ↔ Use but don't learn 전환은 열린 로컬 세션에 즉시 반영됩니다. Memory 설정은 사용자 설정이며, 워크스페이스 설정의 값은 효과가 없습니다.
학습·회상 제어 (CLI)
Kiro CLI의 Memory는 V3가 필요합니다. 로컬 V3 세션에서 /memories → config로 접근 수준을 고릅니다.
| 접근 | 동작 |
|---|---|
read & write | memory를 쓰고 권한 범위에서 변경. 추가·갱신·삭제가 가능한 유일한 수준 |
read only | 기존 memory만 쓰고 변경·자동 갱신 안 함 |
off | memory를 쓰지도 바꾸지도 않음 |
Automatic memory updates는 read & write에서만 켤 수 있고, 켜면 세션 종료 후를 포함해 memory를 자동 생성·refine합니다. 이 설정 변경은 즉시 적용되지만, 접근 수준 변경은 새 CLI 세션부터 적용됩니다.
ℹ️ Workspace trust: Use and learn이나 Use but don't learn이어도, 신뢰하지 않은 워크스페이스에서는 채팅으로 memory를 추가·변경·삭제할 수 없고 읽기만 됩니다. Workspace trust 참고.
저장된 memory 검토
- IDE: Memories 뷰에서 Global memory와 현재 창에 열린 저장소 범위 memory가 나열됩니다. 각 행은 title, 생성 경과, 한 줄 요약, type(Preference/Fact/Other), location(Global 또는 저장소명)을 보여줍니다. 행을 열면 편집 탭에서 Refresh·Delete를 쓸 수 있습니다. Use only에서도 삭제는 가능하지만, 내용 수정은 신뢰된 워크스페이스에서 Use and learn/Use but don't learn일 때만 채팅으로 요청할 수 있습니다.
- CLI:
/memories→list로 탐색·미리보기합니다. 저장소 범위 memory는repo:github/<owner>/<repository>같은 scope를 보여줍니다. Kiro CLI 2.34 이상에서는 목록·상세에서Ctrl+D로 삭제할 수 있습니다.
세션에서 보이는 Memory
예를 들어 "통합 테스트는 로컬 DB를 seed해야 통과한다"는 사실을 디버깅 중 학습하면 memory로 기록되고, 이후 세션에서 회상해 테스트 전에 DB를 먼저 seed합니다.
- IDE: 채팅이 Memory accessed (1), Memory created (1), Memory updated (1) 같은 접을 수 있는 항목으로 묶어 보여줍니다. 실패하거나 확인 못 한 호출은 Couldn't save memory·Memory not saved 카드로 나타납니다.
- CLI: Kiro가 memory를 쓰면
command=get, title=...형태의 Memory 항목이 표시됩니다.
더 알아보기
- Memory
- Kiro 동작 원리 — Memory가 붙는 harness 흐름
- Compaction — 긴 세션의 자동 요약
- Context Engineering — 맥락을 다루는 전반 전략
- Steering — 항상 일관되게 적용할 규칙 작성
출처: kiro.dev 공식 문서 "Memory" (2026-10-26 확인).