✅ 개발 규칙 – AI 에이전트 엄격 준수

🔒 기본 제약 사항 (FUNDAMENTAL CONSTRAINTS)

1. 언어 요구사항
   모든 입력 및 응답은 반드시 한국어로 작성되어야 합니다.

2. 기존 구조 절대 금지
   database.sql 및 architecture 문서에 정의된 코드 구조, 함수명, DB 스키마는 절대로 수정하지 마십시오.

3. 주석 보존
   코드 내 기존 주석은 반드시 유지해야 하며, 삭제하거나 수정하지 말 것.
   주석의 지시사항을 반드시 따르십시오.

4. 추정 금지 정책
   명확한 지시 없이 정보를 단순화하거나 생략하지 마십시오.
   문서에 명시된 내용을 그대로 따르십시오.

5. 일관성 엄격 유지
   코드 및 응답의 표현, 명명, 로직 구조 등 모든 면에서 일관성을 유지해야 합니다.

6. 환경 고정
   타겟 서버 환경은 다음으로 고정되어 있습니다:

   • PHP 8.0.30

   • MariaDB 10.4
     → 이외의 버전이나 대안을 사용하지 마십시오.

7. 스키마 기반 구현만 허용
   database.sql에 정의된 테이블/필드/관계만 사용하십시오.
   추가하거나 제거하거나 변경하지 말 것.

8. 함수 아키텍처 완전 일치
   모든 함수는 Core Architecture 문서에 정의된 이름, 매개변수, 반환형과 정확히 일치해야 합니다.

9. 참조 문서 우선권
   work, design, architecture, schema 가 포함된 .txt, .md 파일은 최우선 참조 문서입니다.
   구현 전 항상 확인해야 합니다.

10. 업무 맥락 검증 필수
    업무 맥락이 문서에 정의되어 있다면, 반드시 확인 후 그 내용을 구현에 반영해야 합니다.

11. 코드 실행 금지
    SQL 또는 PHP 코드를 직접 실행하지 마십시오.
    코드 조각, 구조, 구현 지침만 제공합니다.

12. 외부 프레임워크 금지
    표준 PHP 8.0.30 확장 외에 모든 외부 라이브러리, UI 프레임워크 사용 금지.

13. 다중 파일 개발 프로토콜
    여러 .php 파일을 다룰 경우, 반드시 다음을 따르십시오:

• 이전/다음 파일을 확인하여 파일 흐름을 이해

• 아키텍처 문서를 참조하여 현재 단계 식별

• 체크리스트가 있다면 반드시 순서대로 이행

• 작업 간 논리적 흐름과 연결성 유지

• 호출 함수는 Core Architecture 문서와 대조하여 정확히 일치해야 함

⛔ 절대 금지사항 (ABSOLUTE PROHIBITIONS)

• 🔴 DB 스키마 변경 금지: 테이블, 필드, 관계를 추가/삭제/변경하지 말 것

• 🔴 함수 정의 변경 금지: 함수 시그니처를 절대 변경하지 말 것

• 🔴 창의적 해결책 금지: 문서에 없는 "더 나은 방법"은 제안하지 말 것

• 🔴 외부 종속 금지: 외부 API, 프레임워크, 라이브러리 도입 금지

• 🔴 보안 우회 금지: 보안 검사 및 검증을 삭제하거나 수정하지 말 것

• 🔴 성능 최적화 시도 금지: 문서에 없는 캐시, 세션, 쿼리 최적화 하지 말 것

📋 구현 전 체크리스트 (MANDATORY PRE-IMPLEMENTATION CHECKLIST)

코드를 작성하기 전 다음 항목을 반드시 확인하십시오:

• database.sql에 대상 테이블이 존재하는가?

• 참조된 모든 필드가 스키마에 정의되어 있으며 데이터 타입이 정확한가?

• 함수명이 Core Architecture 문서와 정확히 일치하는가?

• 매개변수가 아키텍처 문서와 완전히 일치하는가?

• 반환값 타입이 정확히 일치하는가?

• 필요한 권한/검증 로직이 포함되어 있는가?

• 호출된 관련 함수가 존재하며 아키텍처와 일치하는가?

✅ 구현 검증 규칙 (IMPLEMENTATION VERIFICATION)

모든 구현은 다음을 충족해야 합니다:

1. database.sql에서 참조된 CREATE TABLE 문장을 정확히 인용

2. Core Architecture에서 해당 함수 정의를 그대로 인용

3. 모든 필드가 스키마와 일치하는지 검증

4. 해당 기능이 다른 컴포넌트와 어떻게 연결되는지 정확히 확인

5. 보안 검증이 문서 기준에 맞게 정확히 포함되었는지 확인

🚫 에러 예방 원칙 (ERROR PREVENTION)

• ❌ 요구사항이 명확하지 않으면 추정하지 말고 질문할 것

• ❌ 문서에 없는 기능은 절대 구현하지 말 것

• ❌ 기존 정상 동작 코드 수정은 명시적 지시 없이는 하지 말 것

• ❌ 문서와 다른 방식의 “더 좋은 방법”은 제안하지 말 것

• ✅ 항상 문서 기준에 따라 작업할 것

🏁 성공 기준 (SUCCESS CRITERIA)

성공적인 구현이 되려면 다음 조건을 모두 충족해야 합니다:

• 코드가 문서에 정확히 일치

• 데이터베이스 참조가 스키마에 존재

• 함수 정의가 아키텍처 문서와 동일

• 보안 및 검증 규칙 포함

• 다른 컴포넌트와의 연계가 문서대로 이루어짐

• 어떠한 편의적 변경도 없이 문서 기준을 100% 준수