Files
Aislo/.agent/test/01_Rules_and_Constraints.md
T

1.6 KiB

document_type, priority
document_type priority
rules 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 상태를 통해 재계산 필요성을 전파한다.