Understand Anything 동반 워크플로

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Understand Anything와 Tesserae는 서로를 보완하는 프로젝트입니다.

• Understand Anything은 코드베이스 지식 그래프와 인터랙티브 대시보드를 생성하는 데 뛰어납니다.
• Tesserae는 오래 지속되는 에이전트 메모리에 초점을 둡니다: 문서, markdown/wiki 컴파일, 정적 게시, 세션 기록, 에이전트용 내보내기.

Tesserae는 Understand Anything을 벤더링하거나 흡수해서는 안 됩니다. 유용한 그래프 아티팩트를 생성할 수 있는 독립적인 동반 도구로 다루세요.

왜 둘 다 사용하나요?

Understand Anything은 다음을 쓸 수 있습니다:

.understand-anything/knowledge-graph.json

이 그래프는 파일, 함수, 클래스, 모듈, 개념, 의존성, 레이어, 투어 같은 코드 구조를 포착합니다.

Tesserae는 그런 다음 해당 아티팩트를 나머지 프로젝트 메모리와 함께 보존할 수 있습니다:

• 소스 문서와 markdown 페이지;
• 저장소 파일;
• 연구 노트;
• 로컬 Claude Code / Codex 세션 기록;
• 생성된 정적 wiki 페이지;
• 2D / 3D 그래프 웹사이트 보기;
• llms.txt, llms-full.txt, search-index.json, graph.json, 페이지별 에이전트 sibling.

현재의 저마찰 워크플로

권장 경로는 설정 마법사입니다:

tesserae project setup

동반 도구 단계에서 Understand Anything을 선택하세요. Tesserae는 요청 시 동반 skills를 설치/업데이트하고 관리형 새로고침 명령을 .tesserae/config.json에 기록합니다. 이후 tesserae project compile 호출은 UA 그래프가 없거나 오래된 경우 이 래퍼를 자동으로 실행합니다.

비대화형 자동화에는 다음을 사용하세요:

tesserae project setup \
  --yes \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex
tesserae project compile

저장된 명령은 사용자가 직접 만들어야 하는 것이 아니라 Tesserae가 소유합니다:

tesserae project refresh-understand-anything --platform codex

컴파일 중 Tesserae는:

1. .understand-anything/knowledge-graph.json이 존재하며, 메타데이터가 있을 때 현재 git 커밋과 일치하는지 확인합니다;
2. 그래프가 없거나 오래되었거나 새로고침이 강제된 경우에만 구성된 에이전트 플랫폼(codex, opencode, 또는 claude)을 실행합니다;
3. 그래프가 작성되었는지 검증합니다;
4. .tesserae/external/understand-anything.md를 구체화합니다;
5. 일반 메모리 컴파일을 계속합니다.

컴파일 전에 구성된 모든 외부 새로고침 명령을 강제로 실행할 수 있습니다:

tesserae project compile --refresh-external-tools

Cognee도 필요하신가요? 같은 setup 명령에 런타임 메모리 플래그를 추가하세요:

tesserae project setup \
  --yes \
  --with-understand-anything \
  --install-understand-anything \
  --understand-anything-platform codex \
  --run-cognee \
  --install-cognee

수동 등가 절차

관리형 설정 경로가 권장됩니다. 의도적으로 Tesserae 밖에서 UA를 사용하려면 먼저 에이전트 환경 안에서 Understand Anything을 실행하세요:

/understand

그런 다음 tesserae project setup --with-understand-anything을 실행하여 Tesserae가 markdown 투영 소스를 기록하게 하세요. 직접 JSON 파일은 수동 입력 소스 경로가 아니라 원시 동반 아티팩트로 유지됩니다.

tesserae project setup --with-understand-anything
tesserae project compile
tesserae project build-site

로컬 에이전트 세션 메모리도 원한다면:

tesserae project sessions discover --import
tesserae project build-site

네이티브 그래프 동기화

Tesserae는 읽기 쉬운 markdown projection을 계속 유지하면서, 설정된 도구가 sync_mode: native_graph를 사용할 때 compile 중 UA 그래프도 네이티브로 가져옵니다.

네이티브 어댑터는 .understand-anything/knowledge-graph.json을 읽고, UA 노드/에지를 Tesserae의 제어된 온톨로지로 매핑한 뒤 sync manifest를 씁니다:

.tesserae/external/understand-anything-sync.json

현재 매핑:

Concept synchronization은 무작정 중복 생성하지 않고 canonicalize합니다. UA가 Mermaid Rendering을 내보내고 Tesserae에 이미 Mermaid rendering이 있으면, compile은 하나의 concept node만 유지하고 metadata.external_refs에 UA provenance를 추가합니다.

Tesserae는 memory compiler로 남고, UA는 독립적인 companion graph generator로 남습니다.

협업 원칙

Tesserae를 Understand Anything의 대체물로 표현하지 마세요.

더 나은 표현:

• Understand Anything은 개발자가 지금 코드베이스를 이해하도록 돕습니다.
• Tesserae는 에이전트가 시간이 지나도 프로젝트 지식을 기억하고, 검색하고, 인용하고, 업데이트하고, 게시하도록 돕습니다.