From 729f3d615de7f779446f3c9691dba0ed3b616494 Mon Sep 17 00:00:00 2001 From: Jiyong Jung Date: Thu, 28 May 2026 22:49:32 +0900 Subject: [PATCH] =?UTF-8?q?chore:=20CodeGraph=20=ED=83=90=EC=83=89=20?= =?UTF-8?q?=EC=9B=8C=ED=81=AC=ED=94=8C=EB=A1=9C=EC=9A=B0=20=EC=84=A4?= =?UTF-8?q?=EC=A0=95=20-=20#322?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 3 +++ AGENTS.md | 20 ++++++++++++++++++++ 2 files changed, 23 insertions(+) diff --git a/.gitignore b/.gitignore index 6cf19827..cb424128 100644 --- a/.gitignore +++ b/.gitignore @@ -180,5 +180,8 @@ src/SupportingFiles/Booket/GoogleService-Info.plist # Performance traces and local probe workspace (large, generated) .perf/ +# CodeGraph local index (generated, per-working-tree SQLite data) +.codegraph/ + # Claude Code scheduled-task runtime lock (per-machine, not shared) .claude/scheduled_tasks.lock diff --git a/AGENTS.md b/AGENTS.md index 14885ed0..c7f208fb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -107,6 +107,26 @@ If a referenced doc is missing, ask before assuming its contents. --- +## Repository intelligence + +When CodeGraph is available, use it for broad repository exploration, symbol +relationship discovery, and impact analysis before falling back to wide +`rg`/file-reading sweeps. + +Use this workflow: + +- For architecture or unfamiliar-area questions, start with CodeGraph + `context`, `query`, `impact`, `callers`, or `callees`. +- For exact literal searches, narrow symbol lookups, and final evidence, use + `rg` and direct file reads. +- If CodeGraph reports stale or pending files, verify those files directly + before relying on the indexed result. +- Do not commit `.codegraph/`; it is a generated local SQLite index. Regenerate + it with `codegraph init -i` when missing, and use `codegraph sync` only when + working outside an active MCP watcher or after a branch switch / batch edit. + +--- + ## Architecture guardrails ### Feature structure