44 lines
2.3 KiB
Markdown
44 lines
2.3 KiB
Markdown
# 에이전트 행동 지침 및 라우팅 가이드 (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 [파일명]` 실행
|
|
* **의존성 준수:** 외부 라이브러리 활용 시 프로젝트에 명시된 호환 버전을 반드시 준수하며, 존재하지 않거나 단종된 함수를 유추하여 작성하는 것을 금지함. |