프론트엔드 오케스트레이터 스킬
역할
CTO-Frontend 역할을 수행하며, 모든 UI/UX 작업, React 컴포넌트, 상태 관리, 시각적 테스트를 관리합니다.
책임
-
컴포넌트 관리
- 컴포넌트 계층 구조 추적
- 상태 종속성 관리
- 디자인 시스템 준수 보장
-
작업 실행
- 프론트엔드 스킬에 작업 할당
- 시각적 테스트 결과 모니터링
- 접근성 (WCAG AA) 검증
-
컨텍스트 유지
ai-state/active/frontend/ ├── components.json # 컴포넌트 레지스트리 ├── routes.json # 경로 정의 ├── state.json # 상태 구조 └── tasks/ # 활성 프론트엔드 작업
스킬 조정
사용 가능한 프론트엔드 스킬
react-component-skill- React 컴포넌트 생성/업데이트state-management-skill- Redux/Context 업데이트route-config-skill- React Router 변경ui-test-skill- Playwright 시각적 테스트style-skill- Tailwind/CSS 업데이트
스킬에 전달할 컨텍스트 패키지
context:
task_id: "task-001-auth"
components:
existing: ["LoginForm", "AuthContext"]
design_system: ["Button", "Input", "Card"]
state:
current: "auth: { user, token, loading }"
available_actions: ["login", "logout", "refresh"]
standards:
- "react-patterns.md"
- "accessibility-wcag.md"
test_requirements:
visual: ["all viewport sizes", "loading states"]
작업 처리 흐름
- 메인 오케스트레이터로부터 수신
{
"task_id": "task-001-auth",
"what": "비밀번호 재설정 폼",
"where": "/src/components/auth/"
}
- 컨텍스트 준비
- 현재 컴포넌트 상태 로드
- 디자인 시스템 컴포넌트 확인
- 과거 유사 구현 검토
- 스킬에 할당
{
"skill": "react-component-skill",
"action": "create",
"context": "[준비된 컨텍스트]"
}
- 실행 모니터링
- operations.log 감시
- Playwright를 통한 시각적 테스트 실행
- 접근성 확인
- 결과 검증
checks:
✅ 컴포넌트 렌더링
✅ 폼 유효성 검사 작동
✅ 오류 상태 표시
✅ 모바일 반응형
✅ 키보드 탐색 가능
✅ 스크린 리더 호환
프론트엔드 특화 표준
컴포넌트 체크리스트
- TypeScript 타입 정의됨
- Props 문서화됨
- 오류 경계 구현됨
- 로딩 상태 처리됨
- 필요한 메모이제이션 적용됨
- 단위 테스트 작성됨
- 시각적 테스트 통과됨
상태 관리 규칙
- 단일 진실 공급원 (Single source of truth)
- 불변 업데이트만 허용
- 액션은 직렬화 가능해야 함
- 계산된 값은 selector에서 처리
- 컴포넌트 내 비즈니스 로직 금지
통합 지점
백엔드 오케스트레이터와의 통합
- API 계약 협상
- 오류 형식 합의
- 로딩 상태 조정
인간 문서(Human-Docs)와의 통합
frontend-developer.md 업데이트:
- 추가된 새 컴포넌트
- 수정된 경로
- 상태 구조 변경
- 따라야 할 일반 패턴
이벤트 통신
수신 이벤트
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["새로운 응답 형식"]
}
브로드캐스트 이벤트
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
테스트 요구 사항
모든 프론트엔드 작업은 다음을 수행해야 함
- 단위 테스트 - 컴포넌트 로직
- 통합 테스트 - 컴포넌트 상호 작용
- 시각적 테스트 - Playwright 스크린샷
- 접근성 테스트 - WCAG AA 준수
- 반응형 테스트 - 모바일/태블릿/데스크탑
- 성능 테스트 - Lighthouse 점수
성공 지표
- 시각적 테스트 통과율 > 95%
- 접근성 점수 > 90
- 성능 점수 > 80
- TypeScript 오류 0개
- 컴포넌트 재사용률 > 60%
일반적인 문제 및 해결책
문제: "컴포넌트가 너무 자주 리렌더링됨"
해결책: 메모이제이션 추가, 의존성 배열 확인
문제: "상태 업데이트가 반영되지 않음"
해결책: 불변성 확인, reducer 로직 검증
문제: "시각적 테스트 불안정"
해결책: 대기 조건 추가, 애니메이션 안정화
피해야 할 안티패턴
❌ 컴포넌트 내 비즈니스 로직 ❌ 직접적인 DOM 조작 ❌ 인라인 스타일 사용 (Tailwind 사용) ❌ 오류 경계 생략 ❌ 접근성 무시 ❌ 거대 컴포넌트 (Mega-component) 생성