diff --git a/.agent/references/conventions.md b/.agent/references/conventions.md index b97844e..aaa52a7 100644 --- a/.agent/references/conventions.md +++ b/.agent/references/conventions.md @@ -39,11 +39,29 @@ scope: (선택) - TODO 주석: `// TODO: 설명` 형식 - 복잡한 로직에는 반드시 WHY(왜) 주석 추가 -## 아키텍처 결정 사항 (NEVER 변경) +## 에이전트 철칙 (ABSOLUTE RULES) > [!CAUTION] -> 아래 결정은 사용자가 2026-03-14에 명시적으로 확정한 것입니다. -> 어떤 상황에서도 재논의하거나 대안을 제안하지 마세요. +> 아래 규칙은 **최우선 순위**입니다. 어떤 작업보다 먼저 준수하세요. +> 위반 시 작업 결과가 전부 무효화됩니다. + +### 1. 전체 구조 파악 의무 + +- **코드를 수정하기 전에 반드시 관련 소스 파일들을 모두 확인하세요.** +- 프로그램을 단편적으로 보지 마세요. 하나의 파일을 수정할 때, 그 파일을 호출하는 곳, 호출되는 곳, 설정 파일, 프롬프트 파일 등 **연관된 모든 파일을 먼저 읽으세요.** +- 특히 아래 파일들은 수정 전 반드시 참조: + - `prompts/` — 에이전트 프롬프트 (도구 목록, 실행 패턴) + - `core/gemini_caller.py` — 에이전트 호출 구조 + - `config.py` — 환경 변수 및 설정값 + - `.agent/references/` — 컨벤션, known-issues, tech-stack +- ❌ "이 파일만 보고 수정" 금지 +- ❌ "아마 이럴 것이다"라고 추측하여 수정 금지 +- ✅ 확실하지 않으면 반드시 소스를 열어서 확인 + +### 2. 아키텍처 결정 사항 (NEVER 변경) + +아래 결정은 사용자가 2026-03-14에 명시적으로 확정한 것입니다. +어떤 상황에서도 재논의하거나 대안을 제안하지 마세요. - **Gemini CLI subprocess 방식 유지**: `gemini_caller.py`는 Gemini CLI를 `asyncio.create_subprocess_exec`로 호출하는 현재 방식을 영구 유지합니다. - ❌ Gemini SDK (`google-generativeai`) 전환 금지