kintex/CLAUDE.md

KINTEX AI 시스템 (킨텍스 전시관리 AI)

킨텍스(KINTEX, 한국국제전시장) 전시 운영 전 과정을 AI로 자동화하는 시스템 프로젝트. 부스 배치 설계 → 인테리어/장치 공사 → 네트워크 배선 → 전기/조명 설계 → 나노바나나(Gemini 이미지 생성)로 시공 후 결과 사진 시각화까지를 하나의 파이프라인으로 다룬다.

프로젝트 구조

kintex/
├── CLAUDE.md                  # 이 파일 — 프로젝트 규칙과 에이전트 오케스트레이션
├── .claude/
│   ├── agents/                # 서브에이전트 정의 (기획/디자인/개발/시각화/검증)
│   └── skills/                # 스킬 (나노바나나 연동 등)
├── docs/
│   ├── analysis/              # 킨텍스 웹사이트 분석, ReRoomAI 소스 분석
│   ├── PLANNING.md            # 시스템 기획서 (기획 에이전트 산출물)
│   └── design.md              # UI 디자인 스펙 — Google Stitch 전달용 (디자인 에이전트 산출물)
├── tools/
│   └── nanobanana/            # Gemini 이미지 생성(나노바나나) 연동 모듈
└── src/                       # 서비스 구현 (백엔드/프론트) — 이후 단계

에이전트 워크플로

작업은 아래 순서의 서브에이전트 체인으로 진행한다. 각 에이전트는 .claude/agents/에 정의되어 있다.

1. planner (기획 에이전트) — docs/analysis/의 리서치를 근거로 docs/PLANNING.md 작성/갱신
2. designer (디자인 에이전트) — PLANNING.md를 근거로 docs/design.md 작성 (Stitch에 바로 붙여넣을 화면별 프롬프트 포함)
3. developer (개발 에이전트) — PLANNING.md/design.md를 근거로 src/ 구현
4. visualizer (시각화 에이전트) — 나노바나나 스킬로 부스/공사 결과 이미지 생성 파이프라인 담당
5. reviewer (검증 에이전트) — 산출물 교차 검증 (기획-디자인-구현 정합성)

새 기능 요청이 오면: planner로 기획 반영 → designer로 화면 반영 → developer 구현 → reviewer 검증 순으로 진행할 것.

규칙

• 모든 문서는 한국어로 작성한다. 코드 식별자/커밋 메시지는 영어.
• 기획/디자인 문서를 수정할 때는 반드시 해당 에이전트를 통해 수정한다 (직접 수정 금지).
• 나노바나나 호출은 tools/nanobanana/ 모듈만 사용한다. API 키는 환경변수 GEMINI_API_KEY.
• 파일 삭제 전에는 반드시 사용자에게 확인받는다.
• 도메인 용어: 부스(booth), 장치공사(booth construction), 반입/반출(move-in/move-out), 주최자(organizer), 참가업체(exhibitor), 관람객(visitor).

참조 자산

• docs/analysis/kintex-website.md — kintex.com 전체 페이지 분석
• docs/analysis/reroomai-source.md — (예정) ReRoomAI 소스 분석. 소스 폴더(C:\GUARDiA\workspace\ReRoomAI) 연결 후 생성된다. 이 파일이 없으면 ReRoomAI 관련 기획은 "연계 예정"으로만 다룰 것.
• docs/BACKLOG.md — 검증 에이전트 지적사항 티켓 목록