Gemini Rules

추측 금지 및 근거 기반 처리: 패키지명, 설정 값 등을 추측하지 말고 반드시 검색이나 문서를 통해 확인 후 작업을 수행하십시오.

메뉴/사이드바 변경 시 필수 재로그인: UI 변경 사항 반영을 위해 반드시 로그아웃/재로그인을 수행하십시오.

작업 후 즉시 검증 및 보고: 코드 수정 후 즉시 검증하고 결과를 보고하십시오.

작업 전 서비스 구동 확인 (E2E 테스트 전 필수 체크리스트):

• 프론트엔드/백엔드 관련 작업 시작 전, 해당 서비스가 구동 중인지 반드시 확인하고 필요한 경우 구동하십시오.
• 브라우저 E2E 테스트(browser_subagent 호출) 직전에 다음 절차를 반드시 수행:
  1. netstat -ano | findstr ":5173 :8080" | findstr LISTENING 명령으로 두 포트가 모두 LISTENING 상태인지 확인
  2. 5173 포트 없음 → 데몬 모드로 기동: Start-Process -FilePath "cmd.exe" -ArgumentList "/c", "cd /d [frontend경로] && npm run dev > frontend_daemon.log 2>&1" -WindowStyle Hidden
  3. 8080 포트 없음 → 데몬 모드로 기동: Start-Process -FilePath "cmd.exe" -ArgumentList "/c", "cd /d [api경로] && gradlew.bat bootRun > api_daemon.log 2>&1" -WindowStyle Hidden
  4. 절대로 npm run dev나 gradlew.bat bootRun을 직접 터미널에서 포그라운드로 실행하지 말 것 (사용자 작업을 블로킹함)
  5. 기동 후 포트가 LISTENING 상태가 될 때까지 대기하고 확인 후에만 browser_subagent를 호출할 것
• 위 절차를 생략하거나 추측하여 browser_subagent를 호출하는 행위는 규칙 위반임

환경 및 구동 포트 확인 의무화 및 허위 보고 금지 (추측/조작 절대 금지):

• 브라우저 이동(E2E 메일 작성 테스트 등) 또는 로컬 서비스 호출 전, 반드시 매 턴 제공되는 ADDITIONAL_METADATA의 Running terminal commands 및 Browser State를 파싱하여, 실제 구동 중인 포트(예: 8080, 5173)를 명시적으로 획득하십시오.
• 가짜 성공 보고 절대 금지: 에이전트는 스크립트 실행 후 해당 결과의 진위(실제 서버와 통신했는지, 에러를 삼키지 않았는지)를 반드시 로그 데이터로 교차 검증해야 합니다. 서버가 닫혀있거나 통신이 이루어지지 않았음에도 "성공했다"고 허위 보고하는 행위는 시스템 파괴에 준하는 가장 엄중한 위반입니다. 문제가 있으면 즉시 사실대로 실패 원인을 보고하십시오.

작업 내용 기록 의무화 (Works & Todo 관리): 모든 작업의 시작 전과 종료 후에는 반드시 works-manager 스킬을 참조하여 new_mail_2026_v1/works/ 하위에 작업 이력과 Todo 목록을 업데이트하고 점검해야 합니다.

경로 오염 방지 및 하드코딩 추측 금지 (Path Integrity & No Hallucination):

• 절대 금지: LLM의 자동 완성이나 추측에 의존하여 임의의 특수 문자(예: 유니코드, 외국어 문자 등)가 섞인 가상의 파일 경로를 생성하거나 접근하려는 행위는 시스템을 파괴할 수 있는 중대한 위반입니다.
• 경로 참조 원칙: 모든 작업 디렉토리와 파일 경로는 반드시 매 턴 제공되는 <ADDITIONAL_METADATA>의 활성 도큐먼트 경로나, 시스템 명령어(find, ls 등)를 통해 실제 반환된 절대 경로 문자열만 복사하여 사용하십시오. 기억력에 의존한 경로 하드코딩을 절대 금지합니다.

문제 발생 시 임의 조치 금지 (무조건 검토 후 진행): 스크립트 에러, 테스트 실패, 예기치 않은 동작 오류 등 문제가 발생했을 경우, 임의로 다음 단계의 작업이나 코드 수정을 진행하지 마십시오. 발생한 상황과 원인을 분석하여 1차적으로 사용자에게 명확히 보고하고, 지시와 승인을 받은 후에만 후속 작업을 진행해야 합니다.

Git 파괴적 명령어 사용 금지 및 사전 확인 의무:

• git restore, git reset, git clean 등 사용자의 기존 작업 내용을 유실시킬 수 있는 파괴적인 명령어는 임의로 절대 사용하지 마십시오.
• 이러한 작업이 필요하다고 판단될 경우, 반드시 git status와 git diff를 통해 변경 사항을 철저히 확인하고, 사용자에게 해당 변경 사항을 폐기해도 되는지 명백한 승인을 구한 뒤에만 실행해야 합니다.

작업 완료 시 Git Commit 의무화: 하나의 단위 작업(Task)이나 버그 수정, 테스트 등을 성공적으로 완료했다고 판단한 시점에는, 반드시 그 시점까지의 모든 수정 사항을 Git에 업로드(git add ., git commit -m "feat/fix: 작업 내용")하여 작업 내역을 안전하게 저장하는 절차를 추가로 수행하십시오.

터미널 콘솔 내 긴 스크립트 직접 실행 금지: Powershell이나 Bash 등 터미널 콘솔 프롬프트에 길거나 복잡한 코드를 직접 입력하여 실행(예: powershell -Command "...")하지 마십시오. 반드시 목적에 맞는 독립적인 스크립트 파일(.ps1, .sh, .py, .java 등)을 작업 폴더에 먼저 작성 저장한 뒤, 해당 파일을 실행하는 방식으로 테스트나 동작을 수행해야 합니다.