Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
TypeScript antigravity-skillsbusiness-knowledgeclaude-codeclaude-skillscodebase-analysiscodexcodex-skillsdeveloper-tools-ai-agentgemini-cli-skillskarpathy-llm-wikiknowledge-baseknowledge-graphmemoryopencode-skillspi-agentunderstandcodevibe-coding
docs(readme): document the .ua data directory across all translations
Lum1104335e6cf75e9f
diff --git a/README.md b/README.mdindex 7115a465..496a3e9a 100644--- a/README.md+++ b/README.md@@ -125,7 +125,7 @@ Point `/understand-knowledge` at a [Karpathy-pattern LLM wiki](https://gist.gith/understand```-A multi-agent pipeline scans your project, extracts every file, function, class, and dependency, then builds a knowledge graph saved to `.understand-anything/knowledge-graph.json`.+A multi-agent pipeline scans your project, extracts every file, function, class, and dependency, then builds a knowledge graph saved to `.ua/knowledge-graph.json`. (Projects that already have a `.understand-anything/` directory keep using it — it stays the data directory when present, so nothing needs migrating.)> **Heads up on token usage:** The initial `/understand` analyzes your whole codebase and can consume a significant number of tokens on large projects. We recommend running it on a token plan / subscription, or using a local model (see above) for initialization. Subsequent runs are incremental by default — only changed files are re-analyzed — so they use far fewer tokens.@@ -138,7 +138,7 @@ A multi-agent pipeline scans your project, extracts every file, function, class,# Supported languages: en (default), zh, zh-TW, ja, ko, ru```-On the **first run** in a project — when you don't pass `--language` and no language is stored yet — `/understand` detects the language you're conversing in. If it isn't English, it asks you to confirm (or override) before generating; English conversations are unaffected. Your choice is saved to `.understand-anything/config.json` and reused on every later run.+On the **first run** in a project — when you don't pass `--language` and no language is stored yet — `/understand` detects the language you're conversing in. If it isn't English, it asks you to confirm (or override) before generating; English conversations are unaffected. Your choice is saved to `.ua/config.json` and reused on every later run.The `--language` parameter affects:- Node summaries and descriptions in the knowledge graph@@ -280,11 +280,11 @@ The graph is just JSON — **commit it once, and teammates skip the pipeline**.> **Example:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — Go / Java / Python / Node reference with a committed graph.-**What to commit:** everything in `.understand-anything/` *except* `intermediate/` and `diff-overlay.json` (those are local scratch).+**What to commit:** everything in `.ua/` *except* `intermediate/` and `diff-overlay.json` (those are local scratch). (Legacy projects use `.understand-anything/` — substitute that directory name below if it's the one present.)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**Keep it fresh:** enable `/understand --auto-update` — a post-commit hook incrementally patches the graph so each commit lands with a matching graph. Or re-run `/understand` manually before releases.@@ -293,8 +293,8 @@ The graph is just JSON — **commit it once, and teammates skip the pipeline**.```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.mdindex 2ad27bf3..cca480d6 100644--- a/READMEs/README.es-ES.md+++ b/READMEs/README.es-ES.md@@ -115,7 +115,7 @@ Apunta `/understand-knowledge` a un [wiki LLM con patrón Karpathy](https://gist/understand```-Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, clase y dependencia, y construye un grafo de conocimiento guardado en `.understand-anything/knowledge-graph.json`.+Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, clase y dependencia, y construye un grafo de conocimiento guardado en `.ua/knowledge-graph.json`. (Los proyectos que ya tienen un directorio `.understand-anything/` lo siguen usando: sigue siendo el directorio de datos cuando está presente, así que no hay que migrar nada.)> **Aviso sobre el consumo de tokens:** El primer `/understand` analiza todo tu código y puede consumir una cantidad significativa de tokens en proyectos grandes. Recomendamos ejecutarlo con un plan / suscripción de tokens, o usar un modelo local (ver arriba) para la inicialización. Las ejecuciones posteriores son incrementales por defecto — solo se reanalizan los archivos modificados — por lo que usan muchos menos tokens.@@ -264,11 +264,11 @@ El grafo es solo JSON — **confírmalo una vez y tus compañeros se saltan el p> **Ejemplo:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — referencia políglota (Go / Java / Python / Node) con el grafo ya confirmado.-**Qué confirmar:** todo lo que hay en `.understand-anything/` *excepto* `intermediate/` y `diff-overlay.json` (archivos temporales locales).+**Qué confirmar:** todo lo que hay en `.ua/` *excepto* `intermediate/` y `diff-overlay.json` (archivos temporales locales). (Los proyectos heredados usan `.understand-anything/`: sustituye ese nombre de directorio abajo si es el que está presente.)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**Mantenlo al día:** activa `/understand --auto-update` — un hook post-commit parchea el grafo de forma incremental, así cada commit llega con su grafo correspondiente. O vuelve a ejecutar `/understand` manualmente antes de cada release.@@ -277,8 +277,8 @@ El grafo es solo JSON — **confírmalo una vez y tus compañeros se saltan el p```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.mdindex aba4de24..d2eba4b4 100644--- a/READMEs/README.ja-JP.md+++ b/READMEs/README.ja-JP.md@@ -116,7 +116,7 @@ Understand Anything は [Claude Code Plugin](https://code.claude.com/docs/en/plu/understand```-マルチエージェントパイプラインがプロジェクトをスキャンし、すべてのファイル・関数・クラス・依存関係を抽出して、`.understand-anything/knowledge-graph.json` にナレッジグラフを保存します。+マルチエージェントパイプラインがプロジェクトをスキャンし、すべてのファイル・関数・クラス・依存関係を抽出して、`.ua/knowledge-graph.json` にナレッジグラフを保存します。(すでに `.understand-anything/` ディレクトリがあるプロジェクトはそれを引き続き使用します。存在する場合はそれがデータディレクトリのままなので、移行は不要です。)> **トークン使用量にご注意:** 初回の `/understand` はコードベース全体を分析するため、大規模プロジェクトではかなりのトークンを消費することがあります。トークンプラン / サブスクリプションでの実行、または初期化にはローカルモデル(上記参照)の使用をおすすめします。以降の実行はデフォルトで増分処理され、変更されたファイルのみ再分析するため、消費トークンは大幅に少なくなります。@@ -265,11 +265,11 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/> **例:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) —— コミット済みのグラフを含む Go / Java / Python / Node のリファレンスプロジェクト。-**コミット対象:** `.understand-anything/` 内のすべてのファイル。ただし `intermediate/` と `diff-overlay.json` は除きます(これらはローカルの一時ファイルです)。+**コミット対象:** `.ua/` 内のすべてのファイル。ただし `intermediate/` と `diff-overlay.json` は除きます(これらはローカルの一時ファイルです)。(レガシープロジェクトは `.understand-anything/` を使用します。そのディレクトリが存在する場合は、以下のディレクトリ名をそれに置き換えてください。)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**最新状態を保つ:** `/understand --auto-update` を有効にすると、post-commit フックがグラフを増分的に更新し、各コミットに対応するグラフが揃います。またはリリース前に `/understand` を手動で再実行します。@@ -278,8 +278,8 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.mdindex 51d5c635..9c757aef 100644--- a/READMEs/README.ko-KR.md+++ b/READMEs/README.ko-KR.md@@ -115,7 +115,7 @@ Understand Anything은 [Claude Code Plugin](https://code.claude.com/docs/en/plug/understand```-멀티 에이전트 파이프라인이 프로젝트를 스캔하고, 모든 파일, 함수, 클래스, 의존성을 추출한 뒤, `.understand-anything/knowledge-graph.json`에 지식 그래프를 저장합니다.+멀티 에이전트 파이프라인이 프로젝트를 스캔하고, 모든 파일, 함수, 클래스, 의존성을 추출한 뒤, `.ua/knowledge-graph.json`에 지식 그래프를 저장합니다. (이미 `.understand-anything/` 디렉터리가 있는 프로젝트는 계속 그것을 사용합니다. 존재하는 경우 그것이 데이터 디렉터리로 유지되므로 마이그레이션이 필요 없습니다.)> **토큰 사용량 안내:** 최초 `/understand`는 전체 코드베이스를 분석하므로 대규모 프로젝트에서는 상당한 토큰을 소비할 수 있습니다. 토큰 요금제 / 구독으로 실행하거나, 초기화에는 로컬 모델(위 참조)을 사용하는 것을 권장합니다. 이후 실행은 기본적으로 증분 방식이라 변경된 파일만 다시 분석하므로 훨씬 적은 토큰을 사용합니다.@@ -264,11 +264,11 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/> **예시:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — 커밋된 그래프를 포함한 Go / Java / Python / Node 레퍼런스 프로젝트.-**커밋할 대상:** `.understand-anything/` 내부의 모든 파일. 단, `intermediate/` 와 `diff-overlay.json` 은 제외합니다 (이들은 로컬 임시 파일입니다).+**커밋할 대상:** `.ua/` 내부의 모든 파일. 단, `intermediate/` 와 `diff-overlay.json` 은 제외합니다 (이들은 로컬 임시 파일입니다). (레거시 프로젝트는 `.understand-anything/` 를 사용합니다. 해당 디렉터리가 있는 경우 아래의 디렉터리 이름을 그것으로 바꾸세요.)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**최신 상태 유지:** `/understand --auto-update` 를 활성화하면 post-commit 훅이 그래프를 증분 업데이트하여 각 커밋마다 일치하는 그래프가 유지됩니다. 또는 릴리스 전에 `/understand` 를 수동으로 다시 실행하세요.@@ -277,8 +277,8 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.mdindex 2601db8c..4e6a839c 100644--- a/READMEs/README.ru-RU.md+++ b/READMEs/README.ru-RU.md@@ -116,7 +116,7 @@ Understand Anything — это [плагин для Claude Code](https://code.cl/understand```-Мультиагентный пайплайн сканирует ваш проект, извлекает каждый файл, функцию, класс и зависимость, а затем строит граф знаний и сохраняет его в `.understand-anything/knowledge-graph.json`.+Мультиагентный пайплайн сканирует ваш проект, извлекает каждый файл, функцию, класс и зависимость, а затем строит граф знаний и сохраняет его в `.ua/knowledge-graph.json`. (Проекты, в которых уже есть каталог `.understand-anything/`, продолжают использовать его — при наличии он остаётся каталогом данных, поэтому ничего мигрировать не нужно.)> **Обратите внимание на расход токенов:** Первый запуск `/understand` анализирует всю кодовую базу и может потреблять значительное количество токенов на больших проектах. Рекомендуем запускать его с тарифным планом / подпиской на токены или использовать локальную модель (см. выше) для инициализации. Последующие запуски по умолчанию инкрементальны — повторно анализируются только изменённые файлы — поэтому расходуют гораздо меньше токенов.@@ -265,11 +265,11 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/> **Пример:** [GoogleCloudPlatform/microservices-demo (форк)](https://github.com/GoogleCloudPlatform/microservices-demo) — мультиязыковой проект (Go / Java / Python / Node) с уже зафиксированным графом.-**Что коммитить:** всё содержимое `.understand-anything/`, *кроме* `intermediate/` и `diff-overlay.json` (это локальные временные файлы).+**Что коммитить:** всё содержимое `.ua/`, *кроме* `intermediate/` и `diff-overlay.json` (это локальные временные файлы). (Устаревшие проекты используют `.understand-anything/` — подставьте это имя каталога ниже, если присутствует именно он.)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**Держите граф в актуальном состоянии:** включите `/understand --auto-update` — post-commit хук будет инкрементально обновлять граф, так что каждый коммит сопровождается соответствующим графом. Либо запускайте `/understand` вручную перед релизами.@@ -278,8 +278,8 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.mdindex 3a1f8ee1..f67dd495 100644--- a/READMEs/README.tr-TR.md+++ b/READMEs/README.tr-TR.md@@ -116,7 +116,7 @@ Alan görünümüne geçin ve kodunuzun gerçek iş süreçleriyle nasıl eşle/understand```-Çok-ajan hattı projenizi tarar, her dosya, fonksiyon, sınıf ve bağımlılığı çıkarır, ardından `.understand-anything/knowledge-graph.json` dosyasına kaydedilen bir bilgi grafiği oluşturur.+Çok-ajan hattı projenizi tarar, her dosya, fonksiyon, sınıf ve bağımlılığı çıkarır, ardından `.ua/knowledge-graph.json` dosyasına kaydedilen bir bilgi grafiği oluşturur. (Zaten bir `.understand-anything/` dizini olan projeler onu kullanmaya devam eder — mevcut olduğunda veri dizini olarak kalır, bu yüzden taşımaya gerek yoktur.)> **Token kullanımı hakkında uyarı:** İlk `/understand` çalıştırması tüm kod tabanınızı analiz eder ve büyük projelerde önemli miktarda token tüketebilir. Bunu bir token planı / aboneliği ile çalıştırmanızı veya başlatma için yerel bir model (yukarıya bakın) kullanmanızı öneririz. Sonraki çalıştırmalar varsayılan olarak artımlıdır — yalnızca değişen dosyalar yeniden analiz edilir — bu yüzden çok daha az token kullanır.@@ -265,11 +265,11 @@ Graf yalnızca bir JSON dosyasıdır — **bir kez commit'leyin, ekip arkadaşla> **Örnek:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) — commit'lenmiş grafı içeren Go / Java / Python / Node çok dilli referans projesi.-**Neyi commit'leyin:** `.understand-anything/` içindeki her şey, *ancak* `intermediate/` ve `diff-overlay.json` hariç (bunlar yerel geçici dosyalardır).+**Neyi commit'leyin:** `.ua/` içindeki her şey, *ancak* `intermediate/` ve `diff-overlay.json` hariç (bunlar yerel geçici dosyalardır). (Eski projeler `.understand-anything/` kullanır — mevcut olan buysa aşağıdaki dizin adını onunla değiştirin.)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**Güncel tutun:** `/understand --auto-update` etkinleştirin — bir post-commit kancası grafı artımlı olarak yamalar, böylece her commit eşleşen bir grafla birlikte gelir. Veya sürümden önce `/understand` komutunu elle yeniden çalıştırın.@@ -278,8 +278,8 @@ Graf yalnızca bir JSON dosyasıdır — **bir kez commit'leyin, ekip arkadaşla```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.mdindex 890db1d5..7fef2c72 100644--- a/READMEs/README.zh-CN.md+++ b/READMEs/README.zh-CN.md@@ -115,7 +115,7 @@ Understand Anything 是一个 [Claude Code Plugin](https://code.claude.com/docs//understand```-多智能体(multi-agent)架构会:扫描你的项目,提取函数 / 类 / 依赖,构建知识图谱保存至`.understand-anything/knowledge-graph.json`.+多智能体(multi-agent)架构会:扫描你的项目,提取函数 / 类 / 依赖,构建知识图谱保存至`.ua/knowledge-graph.json`。(已经有 `.understand-anything/` 目录的项目会继续使用它——存在时它仍是数据目录,因此无需迁移。)> **关于 Token 消耗的提醒:** 首次运行 `/understand` 会分析整个代码库,在大型项目上可能消耗大量 token。建议在有 token 套餐 / 订阅的情况下运行,或在初始化时使用本地模型(见上文)。后续运行默认是增量式的——只重新分析变更过的文件——因此消耗的 token 大幅减少。@@ -264,11 +264,11 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/> **示例:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) —— 包含已提交图谱的 Go / Java / Python / Node 多语言参考项目。-**需要提交的内容:** `.understand-anything/` 下的全部文件,*除了* `intermediate/` 和 `diff-overlay.json`(这些是本地临时文件)。+**需要提交的内容:** `.ua/` 下的全部文件,*除了* `intermediate/` 和 `diff-overlay.json`(这些是本地临时文件)。(旧项目使用 `.understand-anything/`——如果存在的是该目录,请将下方的目录名替换为它。)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**保持最新:** 启用 `/understand --auto-update` —— 一个 post-commit 钩子会增量更新图谱,每次提交都能得到匹配的图谱版本。也可以在发布前手动重跑 `/understand`。@@ -277,8 +277,8 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.mdindex 4925828a..ae7befbe 100644--- a/READMEs/README.zh-TW.md+++ b/READMEs/README.zh-TW.md@@ -115,7 +115,7 @@ Understand Anything 是一個 [Claude Code Plugin](https://code.claude.com/docs//understand```-多智能體(multi-agent)架構會:掃描你的專案,提取函式 / 類別 / 相依關係,建構知識圖譜並儲存至 `.understand-anything/knowledge-graph.json`。+多智能體(multi-agent)架構會:掃描你的專案,提取函式 / 類別 / 相依關係,建構知識圖譜並儲存至 `.ua/knowledge-graph.json`。(已經有 `.understand-anything/` 目錄的專案會繼續使用它——存在時它仍是資料目錄,因此無需遷移。)> **關於 Token 消耗的提醒:** 首次執行 `/understand` 會分析整個程式碼庫,在大型專案上可能消耗大量 token。建議在有 token 方案 / 訂閱的情況下執行,或在初始化時使用本地模型(見上文)。後續執行預設為增量式——只重新分析變更過的檔案——因此消耗的 token 大幅減少。@@ -264,11 +264,11 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/> **範例:** [GoogleCloudPlatform/microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo) —— 包含已提交圖譜的 Go / Java / Python / Node 多語言參考專案。-**需要提交的內容:** `.understand-anything/` 底下的全部檔案,*除了* `intermediate/` 與 `diff-overlay.json`(這些是本機暫存檔)。+**需要提交的內容:** `.ua/` 底下的全部檔案,*除了* `intermediate/` 與 `diff-overlay.json`(這些是本機暫存檔)。(舊專案使用 `.understand-anything/`——如果存在的是該目錄,請將下方的目錄名稱替換為它。)```gitignore-.understand-anything/intermediate/-.understand-anything/diff-overlay.json+.ua/intermediate/+.ua/diff-overlay.json```**保持最新:** 啟用 `/understand --auto-update` —— 一個 post-commit 掛鉤會增量更新圖譜,讓每次提交都有對應的圖譜版本。也可以在發布前手動重跑 `/understand`。@@ -277,8 +277,8 @@ curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/```bashgit lfs install-git lfs track ".understand-anything/*.json"-git add .gitattributes .understand-anything/+git lfs track ".ua/*.json"+git add .gitattributes .ua/```---