에이전트 행동 지침 및 라우팅 가이드 (agent.md)

1. 개발 환경 및 기술 스택 기준 (Technical Stack Baseline)

에이전트는 코드를 작성, 수정 또는 검증할 때 환경 기준과 호환되도록 구현

명령 수신 시 답변 작성 및 코드 수정 전 다음 단계에 따라 정의서(MD) 필수 로드.

1단계 (필수): .agent/structure.md 즉시 로드 및 현재 디렉토리 구조 분석.
2단계 (조건 분기): 프롬프트 성격에 따라 필요한 파일 선별 로드.
- 조건 A (UI, 제어, 컴포넌트, WebCAD): .agent/frontend.md 필수 추가 로드.
- 조건 B (연산 수식, 설계 기준, DB, PostGIS): .agent/backend.md 필수 추가 로드.

구조 준수: .agent/structure.md 트리 구조 강제 준수.
700줄 제한: 단일 파일 코드 생성/수정 후 700줄 이상 시 리팩토링 필수 제안. 유저 승인 후 분할 및 structure.md 동시 업데이트.
영역 격리: 지정된 작업 영역 외 디렉토리 파일 접근·수정 시 유저 사전 승인 필수.
정합성 검증: 이전 맥락 단절을 고려하여 현재 소스 코드와 분할 정의서(frontend.md, backend.md) 간 정합성 최우선 검토.
정보 요구 필수: 연관 파일의 실제 내부 코드가 프롬프트에 제공되지 않은 경우, 임의 추측 코딩을 절대 금지하며 유저에게 파일 내용 제시를 먼저 요구할 것.
스타일 통합 (자율 포매팅): 에이전트는 코드 작성을 완료한 후, 반드시 프로젝트 터미널에서 다음 명령어를 직접 실행하여 서식을 정렬한 뒤 최종 저장해야 한다. (유저에게 서식 교정 작업을 전가하지 말 것)
- Python 파일 수정 시: ruff format [파일명] 및 ruff check --fix [파일명] 실행
- TypeScript/CSS 파일 수정 시: npx prettier --write [파일명] 실행
의존성 준수: 외부 라이브러리 활용 시 프로젝트에 명시된 호환 버전을 반드시 준수하며, 존재하지 않거나 단종된 함수를 유추하여 작성하는 것을 금지함.