# 에이전트 행동 지침 및 라우팅 가이드 (agent.md) ## 1. 개발 환경 및 기술 스택 기준 (Technical Stack Baseline) 에이전트는 코드를 작성, 수정 또는 검증할 때 환경 기준과 호환되도록 구현 ### A. 백엔드 및 연산 엔진 (Python) * **Runtime:** Python v3.12 or v3.13.7 * **Framework:** FastAPI / Pydantic * **Geometry/GIS Engine:** Trimesh, Whitebox, Geopandas, Shapely, Rasterio, Laspy ### B. 데이터베이스 (PostgreSQL) * **DBMS:** PostgreSQL v17 * **Spatial Extension:** PostGIS v3.4 (공간 쿼리 및 연산 활용) * **DB Driver:** 비동기 연동을 위한 `asyncpg` 기준 구동 ### C. 프론트엔드 및 인터페이스 (TypeScript & WebCAD) * **Language/Runtime:** TypeScript / Node.js * **인터페이스:** HTML5 Canvas 및 WebGL 기반의 WebCAD 시스템 연동 표준 준수 ### D. 데이터 및 파일 인코딩 표준 * **인코딩:** 텍스트 파일은 UTF-8 표준을 강제 적용 --- ## 2. 컨텍스트 라우팅 규칙 (Context Routing) 명령 수신 시 답변 작성 및 코드 수정 전 다음 단계에 따라 정의서(MD) 필수 로드. * **1단계 (필수):** `.agent/structure.md` 즉시 로드 및 현재 디렉토리 구조 분석. * **2단계 (조건 분기):** 프롬프트 성격에 따라 필요한 파일 선별 로드. * **조건 A (UI, 제어, 컴포넌트, WebCAD):** `.agent/frontend.md` 필수 추가 로드. * **조건 B (연산 수식, 설계 기준, DB, PostGIS):** `.agent/backend.md` 필수 추가 로드. --- ## 3. 코드 작성 제약 조건 (Constraints) * **구조 준수:** `.agent/structure.md` 트리 구조 강제 준수. * **700줄 제한:** 단일 파일 코드 생성/수정 후 700줄 이상 시 리팩토링 필수 제안. 유저 승인 후 분할 및 `structure.md` 동시 업데이트. * **영역 격리:** 지정된 작업 영역 외 디렉토리 파일 접근·수정 시 유저 사전 승인 필수. * **정합성 검증:** 이전 맥락 단절을 고려하여 현재 소스 코드와 분할 정의서(`frontend.md`, `backend.md`) 간 정합성 최우선 검토. * **정보 요구 필수:** 연관 파일의 실제 내부 코드가 프롬프트에 제공되지 않은 경우, 임의 추측 코딩을 절대 금지하며 유저에게 파일 내용 제시를 먼저 요구할 것. * **스타일 통합 (자율 포매팅):** 에이전트는 코드 작성을 완료한 후, 반드시 프로젝트 터미널에서 다음 명령어를 직접 실행하여 서식을 정렬한 뒤 최종 저장해야 한다. (유저에게 서식 교정 작업을 전가하지 말 것) * *Python 파일 수정 시:* `ruff format [파일명]` 및 `ruff check --fix [파일명]` 실행 * *TypeScript/CSS 파일 수정 시:* `npx prettier --write [파일명]` 실행 * **의존성 준수:** 외부 라이브러리 활용 시 프로젝트에 명시된 호환 버전을 반드시 준수하며, 존재하지 않거나 단종된 함수를 유추하여 작성하는 것을 금지함.