CausalInferenceLab · seyoung4503 · May 30, 2026 · May 30, 2026 · May 30, 2026 · May 30, 2026
diff --git a/README.md b/README.md
@@ -21,7 +21,9 @@
 > *separate* set of definitions per team → it answers questions over an
 > incomplete database → it remembers every definition and conversation.
 
-This is the **v4.1 rebuild** (see [`docs/discord_first_redesign_v4_1.md`](docs/discord_first_redesign_v4_1.md)).
+👉 **프로젝트 전체 그림(단일 SSOT)**: [`docs/PROJECT.md`](docs/PROJECT.md) · **컨트리뷰터 한눈 가이드**: [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
+
+This is the **v4.1 rebuild** (배경/설계 의도: [`docs/discord_first_redesign_v4_1.md`](docs/discord_first_redesign_v4_1.md)).
 Where most text-to-SQL projects compete on *"generate better SQL,"* Lang2SQL
 competes on everything *around* the query: business-context learning, per-team
 semantics, robustness to messy databases, and memory. **Discord is the Phase 1
@@ -143,6 +145,8 @@ for the full architecture write-up.
 
 ## 🤝 기여하기
 
+**처음 보시는 분은 [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)** — 디렉토리·레이어 책임, 한 메시지의 lifecycle, *어디를 수정하면 좋을지* 가 한곳에 정리돼 있습니다.
+
 ```bash
 git clone https://github.com/CausalInferenceLab/lang2sql.git
 cd lang2sql

diff --git a/dev/create_faiss.py b/dev/create_faiss.py
diff --git a/dev/create_pgvector.py b/dev/create_pgvector.py
diff --git a/docker/Dockerfile b/docker/Dockerfile
diff --git a/docker/Dockerfile.dockerignore b/docker/Dockerfile.dockerignore
diff --git a/docker/docker-compose-pgvector.yml b/docker/docker-compose-pgvector.yml
diff --git a/docker/docker-compose-postgres.yml b/docker/docker-compose-postgres.yml
diff --git a/docker/docker-compose.yml b/docker/docker-compose.yml
diff --git a/docker/pgvector/init/001_create_database.sql b/docker/pgvector/init/001_create_database.sql
diff --git a/docker/pgvector/init/002_create_user_and_grant.sql b/docker/pgvector/init/002_create_user_and_grant.sql
diff --git a/docker/postgres/init/001_create_database.sql b/docker/postgres/init/001_create_database.sql
diff --git a/docker/postgres/init/002_create_user_and_grant.sql b/docker/postgres/init/002_create_user_and_grant.sql