kintex/.claude/skills/kintex-wise-ui-orchestrator/SKILL.md
zio 5ddd7136a9 feat(ux,system,identity): waves 10-12 + renewal-1 — WISE shell (hamburger/accordion IA), system-mgmt basics (V37), email channel (V36), product identity, home AI hub, demo seed (V38), menu IA, app-QR, product rename
- W10 email: self-hosted Postfix channel (owner-approved) — auction-open contractor notice
  (in-app + email), EDM send (opt-in, cap 500), password-reset mail, mail_log (V36)
- W11 WISE shell: hamburger toggle, single-open accordion, 6-group IA restructure,
  system-mgmt group, KINTEX CI wordmark logo, home charts x3, responsive bottom user area,
  calendar alignment; fixed goScoped links (no /login bounce, hall parsing)
- W12 system-mgmt basics (UIWS parity): dept/company, program registry, role-menu map,
  auth policy, login history, error log, system health, mail/notify config (V37, 10 routes)
- product identity: public landing hero + role value cards + AI pipeline steps; login
  tagline; root gate (unauth -> /public product intro, auth -> /home)
- home AI hub: 5 AI tool cards + NL quick-ask strip (AI visibility)
- menu IA: 13 orphan routes folded in, system-mgmt 5 sub-sections, dead-links 0
- app-QR install page (/app-qr, WISE AppQrCode pattern); EAS build G3-approved
- product rename -> "KINTEX AI 전시·행사시스템" across 4 locales + title
- V38 demo closed-loop seed: codes/programs/depts/companies + booths/leads/approvals/
  invoices/notices, 4 demo accounts — activates home todos/KPIs
- new harnesses: wise-ui alignment (+menu-ia), full renewal (testdata), benchmark (analyst/crawler)
- SPA cache: index.html no-store (instant deploy reflection)
- verified: compileJava, test, tsc -b --force, vite build all EXIT 0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-12 15:57:34 +09:00

50 lines
3.9 KiB
Markdown

---
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에 없는 화면 정렬 요청 → 예외 목록 보고 + 셸 수준만 정렬.