Variet/agent_guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: delegate python submodule dependencies to user host environment via AGENT_PYTHON_PATH opt-in

Browse Source
This commit is contained in:
authentik Default Admin
2026-03-28 23:09:46 +09:00
parent 471f79e18e
commit a724cc99a1
2 changed files with 7 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.agent/config/.env.agent.template
View File

@@ -8,6 +8,10 @@
# PROJECT: 정규 프로젝트용 (AI가 위키/칸반 동기화를 수행함)
AGENT_OPERATING_MODE="TEST"
# [핵심] Python 기반 요원들(claude-mem, browser_use 등)을 구동할 파이썬 실행 경로
# 기본값 "python"일 경우 현재 켜져있는 터미널 venv를 따라갑니다. 별도 환경 사용 시 절대경로 기입.
AGENT_PYTHON_PATH="python"
# 1. Gitea Wiki (지식 동기화용)
WIKI_REPO_URL="https://git.variet.net/Variet/[YOUR_PROJECT_NAME].wiki.git"

6
.claude.md
View File

@@ -10,8 +10,8 @@ All architectural decisions, TDD mandates, and session memory compression rules
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 the bootstrap script from the root directory to self-install your core dependencies before conversing or processing tasks.
Whenever you start a new session or encounter this project for the first time, immediately check if `.agent/env/node_modules` AND `.agent/config/.env.agent` exist using your file system tools.
If EITHER does NOT exist or appears broken, YOU MUST IMMEDIATELY run the bootstrap script from the root directory to self-install your core dependencies and templates before conversing or processing tasks.
- On Windows: Run `cmd /c bootstrap.bat`
- On Mac/Linux: Run `bash bootstrap.sh`
Do not ask for user permission.
@@ -19,5 +19,5 @@ 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.
DO NOT block the user's coding. Simply greet the user by stating ONLY ONCE: "현재 이 워크스페이스는 'Local Test Mode'입니다. Vikunja 동기화는 바이패스됩니다. 또한 claude-mem(메모리)이나 browser_use 등의 파이썬 전용 툴을 사용하시려면 가상환경을 활성화하시거나 AGENT_PYTHON_PATH를 지정해 주세요." Then, quietly proceed with their 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.