diff --git a/.agent/config/.env.agent.template b/.agent/config/.env.agent.template
new file mode 100644
index 0000000..75fbdde
--- /dev/null
+++ b/.agent/config/.env.agent.template
@@ -0,0 +1,17 @@
+# ==========================================
+# 에이전트 전용 프로젝트 환경변수 (AI Config)
+# ==========================================
+# (주의) 아래 토큰을 실제 값으로 교체하면 에이전트가 자동으로 이 방의 위키와 칸반을 연결합니다.
+
+# 0. 프로젝트 운영 모드 (TEST / PROJECT)
+# TEST: 로컬 테스트용 (AI가 Vikunja 연동을 강요하지 않고 조용히 대기함)
+# PROJECT: 정규 프로젝트용 (AI가 위키/칸반 동기화를 수행함)
+AGENT_OPERATING_MODE="TEST"
+
+# 1. Gitea Wiki (지식 동기화용)
+WIKI_REPO_URL="https://git.variet.net/Variet/[YOUR_PROJECT_NAME].wiki.git"
+
+# 2. Vikunja Task Board (업무 완료 보고용)
+VIKUNJA_API_URL="https://tasks.variet.net/api/v1"
+VIKUNJA_PROJECT_ID="[YOUR_PROJECT_ID]"
+VIKUNJA_TOKEN="[YOUR_TOKEN_IF_NEEDED]"
diff --git a/.claude.md b/.claude.md
index 8c4cb72..66392a7 100644
--- a/.claude.md
+++ b/.claude.md
@@ -12,3 +12,9 @@ Please also scan `PROJECT.md` to understand current project context.
 **[Z-001] AI INITIALIZATION PROTOCOL**:
 Whenever you start a new session or encounter this project for the first time, immediately check if `.agent/env/node_modules` exists using your file system tools. 
 If it does NOT exist or appears broken, YOU MUST IMMEDIATELY run `cmd /c bootstrap.bat` from the root directory to self-install your core dependencies before conversing or processing tasks. Do not ask for user permission.
+
+**[Z-002] PROJECT CONFIG SETUP PROTOCOL**:
+After you verify `bootstrap.bat` has run, ALWAYS read `.agent/config/.env.agent`.
+If `AGENT_OPERATING_MODE` is `"TEST"` or exact placeholders like `[YOUR_PROJECT_ID]` remain:
+DO NOT block the user's coding. Simply greet the user by stating ONLY ONCE: "현재 이 워크스페이스는 'Local Test Mode'입니다. Vikunja나 Wiki 동기화는 바이패스되며, 로컬 실험에 집중합니다. 추후 프로젝트 레벨로 승격 시 연동 주소를 기입해 주세요." Then, quietly proceed with their coding tasks. 
+HOWEVER, if the user explicitly asks you to "push to Wiki" or "map to Vikunja" while still in TEST mode or missing URLs, you MUST politely decline and ask them to configure `.env.agent` first as a strict Guardrail.