번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 기계 번역이 생성된 뒤 영어 원문이 변경되었습니다. 최신 지침은 영어 페이지를 확인하세요.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
코딩 에이전트를 위한 코드 연결 메모리
Loom은 코딩 에이전트의 메모리를 그 메모리가 언급하는 함수, 클래스, 파일에 연결하고, 리팩터링을 거쳐도 연결을 따라가며, 코드가 바뀌면 해당 메모리에 표시를 남깁니다. 기본적으로 검색은 코드가 모두 사라진 메모리를 결과에서 제외합니다. 다만 사람이 고정(pin)하거나 잠그거나 검증한 메모리는 제외하지 않으며, 교훈을 제공하는 모든 읽기는 해당 코드가 언제 바뀌었는지, 또는 사라졌는지를 함께 알려 줍니다. 이 기능은 자체 호스팅 Loom이 인덱싱하는 저장소(코드 인덱스, LOOM_CODE_INGEST_ENABLED=true)에서 MCP, HTTP, SDK를 통해 동작하며, 연결을 유지하는 memory_code_links 워커는 기본적으로 켜져 있습니다.
제공 기능
- 교훈을 해당 코드에 연결합니다.
repo:<id>태그가 붙은 메모리(Claude Code와 Codex 플러그인은 훅이 캡처한 내용에 이 태그를 붙입니다)나 저장소의 코드 네임스페이스에 기록된 메모리는 다음에 연결됩니다. 백틱으로 언급했거나 본문 어디서든A::b또는 호출(a.b(),name()) 형태로 언급했고 정확히 한 곳으로 확인되는 각 정의(함수, 클래스 등 심볼), 메모리가 나열한 파일 중 camelCase나 snake_case 단어 그대로 언급한 정의, 그리고 나열한 파일 중 이런 정의가 하나도 없는 각 파일입니다. 한정 이름이 아닌 이름은 4자 이상이어야 합니다. 아직 trunk에 없는 한정 이름은LOOM_MEMORY_CODE_LINKS_PENDING_DAYS(14일) 안에 병합되면 연결됩니다. 코드에 연결된 메모리 - 리팩터링을 따라가는 연결. 인덱싱된 커밋마다 각 연결은
fresh,moved,changed(변경한 커밋을 명시),unresolved,missing중 하나로 표시됩니다. 연결은 정의의 토큰을 기록하므로 공백, 주석, 대부분의 포매터 변경은fresh상태를 유지합니다. 연결 상태 - 오래된 메모리를 원하는 방식으로 처리합니다. 네임스페이스의
code_change_policy가 이를 결정합니다.retire_removed(기본값)는 코드가 모두 사라진 메모리를 검색에서 제외하고 변경된 코드에 표시를 남기며,flag는 표시만 합니다.revise는 코드가 사라진 메모리를 마찬가지로 제외하고, 변경된 메모리의 주장을 모델이 이전 코드와 새 코드에 대조해 확인하도록 합니다. 여전히 유효하면 다시 연결(re-anchor)하고, 모순되면 수정 제안을 만듭니다. 사람이 고정하거나 잠그거나 검증한 메모리는 제외되지 않습니다. 모든 정책에서 검색은 대체로 코드가 바뀐 메모리를 숨기지 않고 다음 세 개 결과보다 아래에 순위를 매깁니다. 유지된 메모리와 이름으로 찾은 행은 순위를 유지합니다. Loom은 메모리 자체를 다시 쓰지 않습니다. 정책 - 에이전트가 코드를 읽는 모든 곳에서 교훈을 제공합니다.
code.symbol은 정의에 연결된 메모리를lessons로 반환합니다.code.search,code.callers,code.callees,code.impact,code.outline, 그리고 작업의code.context_pack은 반환하는 파일의 교훈을 첨부하며, 각 교훈에는 연결 상태가 담깁니다. Claude Code와 Codex 훅은 에이전트가 파일을 편집하기 전에 해당 파일의 메모리(memory.for_file)를 보여 주고, Cline 훅은 파일을 읽거나 편집할 때 보여 줍니다.code.symbol· Claude Code 플러그인 · Codex 플러그인 · Cline 훅 (실험적) - 팀과 공유합니다. 교훈은 저장소의 코드 네임스페이스와 호출에서 지정한 네임스페이스에서 읽습니다(MCP에서는 기본적으로 호출자 본인의 네임스페이스). 따라서 저장소의 코드 네임스페이스에 저장한 교훈은 그 네임스페이스를 읽을 수 있는 모든 에이전트에 전달됩니다(자신의 사용자나 세션으로 범위가 좁혀진 토큰은 교훈을 읽지 못합니다). 코드에 연결된 메모리
- 브랜치는 자체 코드를 읽습니다. 다른 브랜치에서는 교훈을 해당 브랜치의 정의와 대조하므로, 예전 텍스트가 남아 있는 릴리스 브랜치에서는
fresh로 표시됩니다(git 미러가 없는LOOM_GIT_HISTORY=none호스트에서는 교훈이 trunk의 상태를 갖습니다). 코드에 연결된 메모리 - 코드 옆의 문서. 저장소의 코드 네임스페이스(trunk의 네임스페이스)에 등록된 소스의 문서에는 저장소 태그가 붙으므로, 저장소에 대한 검색이 코드와 함께 문서를 읽습니다(동기화 워커에는
LOOM_KNOWLEDGE_SOURCE_SYNC_ENABLED가 필요합니다). 문서 소스 - 검토 목록.
namespace.validate는 코드가 바뀌었거나, 다시 찾지 못했거나, 사라진 메모리를 나열하며, 대시보드는 각 메모리의 연결과 그 상태를 보여 줍니다.

시작하기
빠른 시작에서 Loom을 부팅하고, 저장소 추가에서 저장소의 코드 인덱스를 켭니다. 플러그인이나 MCP로 코딩 에이전트를 연결합니다(코딩 에이전트 연결). 4자 이상인 정의를 백틱이나 호출(`name()`) 형태로 언급하거나, `Reader.run`처럼 한정된 이름으로 언급한 교훈을 저장합니다. Claude Code와 Codex 플러그인은 훅이 캡처한 내용에 repo:<id> 태그를 붙이고, 세션 프라이머에 해당 id가 나옵니다(id가 만들어지는 방식). 에이전트가 loom_memory_set으로 직접 저장한 교훈은 그 태그(tags: ["repo:<id>"])를 갖고 있거나 저장소의 코드 네임스페이스에 기록되면 연결되며, 어떤 클라이언트든 둘 중 하나를 할 수 있습니다. HTTP(또는 Python SDK의 agent.call)에서는 자신의 네임스페이스에 저장한 교훈을 호출이 lesson_namespaces에 그 네임스페이스를 지정할 때만 읽습니다. 각 연결 패스는 생성된 지 60초 이상 된 쓰기를 연결하고 패스는 60초마다 실행되므로, trunk가 인덱싱되면 해당 정의에 대한 code.symbol이 약 2분 안에 lessons로 교훈을 반환합니다.
이 페이지의 일부 op는 상태 페이지에서 실험적으로 표시되어 있습니다.