260706_0_회사싱크 후 커밋

.agent/test/01_Rules_and_Constraints.md

@@ -0,0 +1,20 @@
+---
+document_type: rules
+priority: CRITICAL
+---
+# 프로젝트 기본 규칙 및 제약 (Rules & Constraints)
+
+## 🚨 필수 행동 지침 (Do's)
+- **[MUST]** 코드 작성 전 반드시 `02_Architecture_and_Structure.md`의 구조를 확인하고 적절한 위치에 작성한다.
+- **[MUST]** 700줄 제한: 단일 파일이 700줄을 초과할 경우 사전 공지하고 기능별로 파일을 분할한다.
+- **[MUST]** 인코딩은 반드시 **UTF-8** 표준으로 통일한다.
+- **[MUST]** 코드 작성이 완료되면 다음 포맷터를 실행한다.
+  - Python: `ruff format [파일명]`, `ruff check --fix [파일명]`
+  - TypeScript/CSS: `npx prettier --write [파일명]`
+- **[MUST]** 외부 라이브러리 추가 시 프로젝트 호환성을 고려하고 무분별한 사용을 지양한다.
+
+## 🛑 금지 행동 지침 (Don'ts)
+- **[DON'T]** 하드코딩 금지: 제어 변수/파라미터는 `config/config_system.py`에서, UI 문자열은 `ui_template/ui_template_locale.ts`에서 가져와야 한다.
+- **[DON'T]** 임의 파일 경로 생성 금지: 모든 파일 입출력 및 저장은 `05_Workflow_and_Storage.md`에 정의된 6단계 워크플로우 폴더 경로를 준수해야 한다.
+- **[DON'T]** 백엔드에서 중간 산출물이나 임시 파일을 MariaDB에 직접 바이너리로 저장하지 않는다. 물리 파일로 저장 후 DB에는 경로(프로젝트 상대 경로)만 기록한다.
+- **[DON'T]** 삭제 및 덮어쓰기 금지: 다른 단계의 산출물을 직접 삭제하거나 덮어쓰지 않고 stale 상태를 통해 재계산 필요성을 전파한다.