---
name: kintex-wise-ui-orchestrator
description: 킨텍스 UI를 WISE(UIWS) 컨벤션에 문자 그대로 정렬하는 전담 오케스트레이터. "WISE처럼/WISE대로", "UI 정렬", "메뉴 재구성/아코디언 메뉴", "햄버거 메뉴", "셸/사이드바/푸터 수정", "캘린더 WISE", "대시보드 구성", "차트 넣어", "로고 교체", "반응형 깨짐", "화면 WISE 감사", "다시 실행", "특정 화면만", "업데이트", "보완" 요청 시 반드시 이 스킬을 사용하라. (신규 화면 신설 자체는 designer→Stitch 경유가 선행 — 이 하네스는 기존 화면의 WISE 정렬 전담.)
---

# kintex-wise-ui-orchestrator — WISE UI 정렬 오케스트레이터

킨텍스 프론트 전체를 **WISE(UIWS, `C:\GUARDiA\workspace\uiws\frontend`) 컨벤션에 문자 그대로** 정렬한다. 소유자 원칙(2026-07-12, 메모리 `ui-follow-wise-strictly`): **자체 재해석 금지 — UIWS 구조 이식**.

**실행 모드: 서브 에이전트** (감사→정렬→QA 파이프라인, 결과 전달만으로 충분). 모든 Agent 호출은 `model: "opus"`.

## 에이전트
| 에이전트 | 역할 |
|---|---|
| kintex-wise-ui-auditor | UIWS 대비 위반 매트릭스·정렬 백로그(`_workspace/wiseui_audit.md`) |
| kintex-wise-ui-dev | UIWS 구조 이식 구현(웨이브 단위) |
| kintex-qa (재사용) | 경계면·시각 대조(헤드리스 스크린샷 vs UIWS/Stitch 시안)·빌드 게이트 |
| kintex-frontend-dev (재사용) | 도메인 화면 내부 로직이 얽힌 정렬 시 협업 |
| kintex-menu-ia-dev | 카테고리별 메뉴 재구성·라우트↔메뉴 정합(전담 스킬 kintex-menu-recompose 준수) |

## Phase 0: 컨텍스트 확인
1. `_workspace/wiseui_audit.md`·`_workspace/impl_wiseui_*.md` 존재 확인 → 초기 / 부분 재실행(특정 화면·특정 지적만) / 델타 감사 판별.
2. 소유자 지적이 새로 들어온 경우, 감사 없이 해당 항목을 즉시 정렬 웨이브로 직행할 수 있다(지적 = blocker 확정).

## Phase 1: 감사
kintex-wise-ui-auditor 호출 — 전 화면(또는 지정 범위) UIWS 교차 대조 → 위반 매트릭스 + 웨이브 분할안. 소유자 기지적 항목은 blocker로 선반영.

## Phase 2: 정렬 (웨이브 반복)
kintex-wise-ui-dev를 웨이브 단위(셸→공통 컴포넌트→화면군)로 호출. 병렬 시 폴더 소유권 분리(layout/home vs 개별 screens 폴더군). 각 웨이브 게이트: `tsc -b --force`·`vite build` EXIT 0.
- App.tsx 라우트/메뉴 편입은 통합자(메인)가 dev 노트의 배선 요청으로 처리.
- UIWS에 대응물이 없는 kintex 고유 화면(플로어플랜 에디터 등)은 예외 목록으로 관리 — 셸·공통 컴포넌트 수준만 정렬.

## Phase 2.5: 메뉴 IA 정합
신규/이동 라우트가 있으면 kintex-menu-ia-dev 호출(kintex-menu-recompose 절차) — 메뉴 편입 누락 = 웨이브 미완.

## Phase 3: QA·마감
kintex-qa — ①빌드 게이트 ②헤드리스 렌더 스크린샷을 UIWS 실화면/Stitch 시안과 육안 대조(레이아웃 구조 동일성) ③기존 라우트·MDI·다크·i18n 회귀 0 확인. 통과 후 커밋·자동배포(push)·라이브 검증·WORK_STATUS 갱신은 메인 통합자.

## 데이터 전달
파일 기반(`_workspace/wiseui_audit.md`·`impl_wiseui_{wave}.md`) + Agent 반환값. 실패 시 1회 재시도, 재실패는 잔여 백로그로 명시하고 진행.

## 에러 핸들링
- 빌드 게이트 실패: 해당 dev에 반려(통과까지). 
- UIWS와 kintex 요구가 충돌(도메인 특수성): 삭제하지 않고 예외 후보로 기록 → 소유자 확인.

## 테스트 시나리오
- 정상: "메뉴 아코디언 WISE처럼 재구성" → Phase 0(지적 직행) → wise-ui-dev(셸 웨이브) → qa → 배포.
- 부분: "캘린더만 WISE로" → 부분 재실행(dev 캘린더 항목만) → qa.
- 에러: UIWS에 없는 화면 정렬 요청 → 예외 목록 보고 + 셸 수준만 정렬.
