# AI COMMAND CENTER (사령탑)
> **이 문서는 AI 에이전트가 본 프로젝트에 진입할 때 가장 먼저 읽어야 할 최상위 지침서(Entry Point)입니다.**
> 작업을 시작하기 전에 아래의 "상황별 참조 파일"을 확인하여, 현재 작업에 필요한 규칙만 선별적으로 로딩하십시오.
---
---
## 👑 Organization (조직도: Reporting Hierarchy)
이 프로젝트는 철저한 **중앙 집권형 지휘 체계**로 운영됩니다.
| 직책 | 역할 (Role) | 담당자 | 권한 및 의무 |
|:---:|---|---|---|
| **👑 회장 (Chairman)** | **최종 결정권자** | **User (사용자)** | • 프로젝트의 비전 제시 및 최종 승인<br>• 기술적인 세부 사항은 사장에게 위임<br>• 언제든지 조직 전체의 운영 상태를 감사(Audit) 가능 |
| **🤵 사장 (President)** | **총괄 책임자 & 실행자** | **AI Agent (Command Center)** | • **"모든 것을 컨트롤"**: 각 팀장(Rules)을 지휘하여 작업 수행<br>• **"보고의 책임"**: 중요 결정 사항만 추려서 회장에게 보고<br>• **"시스템 유지"**: 작업 로그 및 파이프라인 무결성 보장 |
| **🧢 팀장 (Team Leads)** | **실무 기술 전문가** | **Rule Files (`rules/*.md`)** | • 각 분야의 기술적 기준(Code Standard)을 정의<br>• 사장(AI)의 지시에 따라 정해진 규격을 강제함<br>• 서로 간의 협업(Cross-check)을 통해 정합성 유지 |
---
## 🚀 1. 상황별 팀장 소환 (The Specialist Team)
사장(AI)은 작업을 수행할 때, 해당 분야의 **전문 팀장(Rules)**을 즉시 소환하여 기준을 확인해야 합니다.
| 작업 유형 | 담당 팀장 (Rule File) | 주요 역할 |
|---|---|---|
| **🧠 전략기획팀** | `/rules/PLANNING_RULES.md` | **[최우선]** 요구사항 분석, `task.md` 설계, 타당성 검토 |
| **🎨 UI 디자인팀** | `/rules/STYLE_RULES.md` | CSS, 색상, 타이포그래피, 디자인 규격 통제 |
| **🦴 마크업팀** | `/rules/HTML_RULES.md` | 시맨틱 태그, BEM 네이밍, 구조 정립 |
| **⚡️ 인터랙션팀** | `/rules/JS_RULES.md` | 스크립트 남발 방지, CSS First, 순수 JS 지향 |
| **🛡️ 보안감사팀** | `/rules/SECURITY_QA_RULES.md` | **최종 관문**: 보안(CSRF/XSS) 및 품질 체크 |
| **🧩 아키팀** | `/rules/COMPONENT_RULES.md` | 컴포넌트 폴더 구조 및 파일명 명명 규칙 관리 |
| **⚙️ 백엔드팀** | `/rules/RHYMIX_DEV_GUIDE.md` | PHP 개발, DB/쿼리, 비즈니스 로직 통제 |
---
## 🔄 Standard Development Workflow (표준 작업 프로세스)
> **대원칙**: 아무리 작은 작업이라도 **반드시 아래 4단계를 순서대로** 거쳐야 합니다. "바로 코딩"은 금지입니다.
### 1단계: 기획 & 구조 설계 (Blueprint)
* **역할**: 🧠 **기획자 (Architect)**
* **행동**: 사용자의 요구사항을 분석하고, `task.md`와 `implementation_plan.md`를 작성하여 **"무엇을 만들지"** 정의합니다.
* **산출물**: `implementation_plan.md` (계획서)
### 2단계: 퍼블리싱 & 마크업 (Skeleton)
* **역할**: 🦴 **뼈대팀장 (Skeleton Builder)**
* **행동**: 단순 HTML 생성이 아닙니다. **모든 규정을 통합하여 구조를 잡는 '확장 회의' 단계**입니다.
* `_skeleton.html` 복제 (시작점)
* **HTML 팀장 확인**: 시맨틱 태그 준수 여부 (`rules/HTML_RULES.md`)
* **구조 팀장 확인**: 파일 위치 및 폴더 구조 (`rules/COMPONENT_RULES.md`)
* **디자인 팀장 확인**: 클래스 네이밍(`ui-*`) 미리 적용 (`rules/STYLE_RULES.md`)
* **산출물**: `style-gallery/foundations/`, `style-gallery/components/` 내 HTML 파일
### 3단계: 디자인 & 스타일링 (Design System)
* **역할**: 🎨 **디자인팀장 (Stylist)**
* **행동**: 뼈대에 색상, 폰트, 여백을 입힙니다. `tokens.css`의 변수만 사용합니다.
* **⚠️ 동기화 필수**: CSS 변경 시 `rules/STYLE_RULES.md`와 `assets/CODE_SNIPPETS.md`도 반드시 함께 업데이트해야 합니다.
* **참조**: `rules/STYLE_RULES.md`
### 4단계: 기능 구현 & 백엔드 (Implementation)
* **역할**: ⚙️ **개발팀장 (Developer)**
* **행동**: `_skeleton_blade.blade.php`를 사용하여 PHP 로직을 입힙니다.
* **참조**: `rules/RHYMIX_DEV_GUIDE.md`, `assets/CODE_SNIPPETS.md`
### 5단계: 보안 점검 & 품질 검수 (Audit)
* **역할**: 🕵️♂️ **보안관 (Sheriff)**
* **행동**: 작업된 결과물이 배포 가능한 수준인지 최종 검문합니다.
* **보안**: XSS, CSRF, 권한 체크 (`rules/SECURITY_QA_RULES.md`)
* **QA**: 모바일 반응형 확인, 콘솔 에러 확인
* **통과 기준**: 위 항목에서 **단 하나라도 결격 사유가 있으면 4단계(수정)로 반려**합니다.
* **참조**: `rules/SECURITY_QA_RULES.md`
### 📋 Task Checklist Template (작업 시작 시 복사용)
`task.md`를 생성할 때 다음 양식을 기본으로 사용하십시오.
```markdown
- [ ] **Step 1: 기획 (Blueprint)**
- [ ] 요구사항 분석 및 `implementation_plan.md` 작성
- [ ] **Step 2: 뼈대 (Skeleton)**
- [ ] `_skeleton.html` 복사 및 구조 마크업
- [ ] **Step 3: 디자인 (Design)**
- [ ] `rules/STYLE_RULES.md` 참조하여 스타일링
- [ ] `assets/CODE_SNIPPETS.md` 업데이트 (필요 시)
- [ ] **Step 4: 구현 (Implementation)**
- [ ] Blade 템플릿 변환 및 로직 구현
- [ ] **Reporting**
- [ ] `UPDATE_LOG.md` 기록 (Minor) 또는 사용자 보고 (Major)
```
---
## �🛡 3. AI 작업 기본 원칙 (Core Principles)
1. **규칙 혼용 금지**:
* 스타일 작업 시 개발 가이드(PHP 등)를 참조하여 불필요한 복잡성을 더하지 마십시오.
* 반대로, 백엔드 로직 수정 시 디자인 규칙을 무리하게 적용하려 하지 마십시오.
2. **Source of Truth 준수**:
* 모든 규칙은 각 파일에 정의된 내용을 유일한 정답으로 간주합니다.
* AI의 사전 지식보다 프로젝트 규칙 파일의 내용이 항상 우선합니다.
3. **파일 구조 준수**:
* `/components` 하위의 구조는 `COMPONENT_RULES.md`에 정의된 대로만 유지하십시오.
* 임의로 폴더를 생성하거나 파일을 옮기지 마십시오.
4. **Core Assets 보호 (Modification Lock)**:
* `assets/css/` 내의 **00~40번 파일**(`00.tokens.css` ~ `40.board.css`)은 시스템의 심장부입니다.
* 이 파일들은 **사용자의 명시적 지시 없이는 절대 수정할 수 없습니다.** (단순 컴포넌트 추가 시에도 신중해야 함)
* 간단한 스타일 수정은 인라인이나 별도 CSS 사용을 먼저 고려하십시오.
---
## 📂 3. 디렉토리 맵 (Directory Map)
* `assets/css/`: 스타일 시트 리소스 (CSS 파일만 존재)
* `components/`: UI 블레이드 컴포넌트 (`blade.php` 파일)
* `rules/`: **프로젝트의 모든 규칙 파일** (`STYLE_RULES`, `HTML_RULES`, `DEV_GUIDE` 등)
* `style-gallery/`: UI 요소별 가이드 위치 (`foundations/`, `components/`로 구분됨)
* **`assets/CODE_SNIPPETS.md`**: 자주 쓰는 UI 컴포넌트 상용구 (복사/붙여넣기용)
* **`UPDATE_LOG.md`**: 시스템 변경 이력 로그 (모든 업데이트 사항 기록)
* **`_skeleton.html` / `_skeleton_blade.blade.php`**: 표준 시작 템플릿
* `modules/`, `layouts/`, `widgets/`: 라이믹스 코어 리소스 (개발 가이드 참조)
## 📡 Reporting System (보고 체계)
AI는 다음 기준에 따라 보고 대상을 구분합니다.
1. **👑 회장님 보고 (Direct Report)**:
* **대상**: "큰 그림"이 바뀌는 경우 (예: 팀 구조 개편, 대규모 리팩토링, 새로운 기술 도입).
* **행동**: 사장(AI)이 직접 대화창을 통해 브리핑하고 승인을 요청합니다.
* **원칙**: 회장님을 시시콜콜한 실무(변수명 변경 등)로 귀찮게 하지 않습니다.
2. **📝 내부 기록 (System Log)**:
* **대상**: 실무진(팀장) 선에서 해결된 건 (예: 컴포넌트 추가, 스타일 수정, 버그 픽스).
* **행동**: **`UPDATE_LOG.md`**에 기록하고, 회장에게는 "작업 완료(Logged)"라고만 간략히 보고합니다.
* **목적**: 회장님이 언제든 감사를 나올 때, 시스템의 투명성을 증명하기 위함입니다.
---
## 🕒 Recent System Updates
*상세 변경 내역은 `UPDATE_LOG.md`를 참조하세요.*
---
*이 파일은 프로젝트의 최상위 규칙 파일입니다. AI는 작업을 시작할 때 항상 이 파일을 먼저 읽고 행동 지침을 결정하십시오.*
댓글 0