| name | frontend-task-orchestrator |
| description | 프론트엔드 작업을 유형별 작업 흐름으로 라우팅하고, 필요한 입력/문서/검증 범위를 결정할 때 사용합니다. |
프론트엔드 작업 오케스트레이터
목적
프론트엔드 작업을 시작하기 전에 작업 유형, 필요한 입력, 사용할 문서, 검증 범위를 결정합니다.
Jira, Figma, 사진, 스크린샷을 근거로 작업을 만들거나 시작하는 요청은 먼저 jira-design-implementation-workflow로 요구사항과 순서 게이트를 확인한 뒤 이 skill로 작업 유형을 세분화합니다.
입력 점검
필수 입력
- 작업 목표와 성공 기준
- 작업 유형: 공통 컴포넌트, 페이지/라우트, API 연동, 폼, 리팩터링, 검증
- 대상 workspace 또는 변경 예상 위치
있으면 좋은 입력
- Jira/기능명세/디자인 링크
- API 문서 또는 Swagger/OpenAPI 링크
- 기대 산출물: 코드, spec, 문서, 테스트, PR 준비
필수 입력이 없고 repo 탐색으로도 확인할 수 없으면 구현 전에 질문합니다.
읽기 전략
- 항상 읽기: 없음
- 조건부 읽기:
- 선택한 작업 흐름 skill의
SKILL.md
- 선택한 작업 흐름에 연결된 recipe
docs/workflows/spec-writing.md: 새 spec 작성 또는 갱신이 필요할 때
docs/code-quality/frontend-fundamentals.md: 페이지, 컴포넌트, hook, API, form 등 프론트엔드 구현 품질 self-check 허브가 필요할 때
docs/code-quality/frontend-readability.md, docs/code-quality/frontend-predictability.md, docs/code-quality/frontend-cohesion.md, docs/code-quality/frontend-coupling.md: 구현 중 특정 품질 기준만 확인할 때
docs/code-quality/frontend-logic-composition.md: 컴포넌트 내부 로직, custom hook 추출, orchestration hook 기준이 필요할 때
docs/architecture/repo-structure.md: app/package 위치가 불명확할 때
문서는 많이 읽기보다 먼저 rg, find, 가까운 기존 코드로 현재 패턴을 확인합니다.
작업 흐름 선택
| 작업 유형 | 사용할 skill | 기준 문서 |
|---|
| Jira/Figma/사진 기반 작업 생성 또는 착수 | jira-design-implementation-workflow | recipes/jira-design-to-implementation.md |
| 앱 shared 컴포넌트 | app-shared-component-workflow | recipes/add-app-shared-component.md |
| 공통 컴포넌트 | design-system-component-workflow | recipes/add-design-system-component.md |
| 페이지/라우트 | page-feature-workflow | recipes/add-page.md |
| API query/mutation | api-integration-workflow | recipes/add-api-query.md |
| 폼/검증/submit | form-flow-workflow | recipes/add-form.md |
| Turbo generator 추가/수정 | turbo-generator-workflow | docs/workflows/turbo-generators.md |
| 컴포넌트/hook 로직 구성 | frontend-logic-composition-workflow | docs/code-quality/frontend-logic-composition.md |
| 리팩터링 판단 | refactor-evaluator | recipes/refactor-component.md |
| 성능 이슈 | performance-diagnosis | docs/code-quality/index.md |
| 구현 후 검증 | frontend-quality-verification | docs/workflows/local-development.md |
| 코드 품질 리뷰 | frontend-fundamentals-review 또는 frontend-*-check | docs/code-quality/frontend-fundamentals.md |
| 커밋 분해 또는 PR 준비 | commit-planning-workflow | recipes/commit-plan.md |
여러 유형이 섞인 작업은 핵심 구현 작업 흐름을 먼저 선택하고, 마지막 검증은 frontend-quality-verification으로 마무리합니다.
페이지, 컴포넌트, hook, API, form 구현은 각 작업 흐름 안에서 docs/code-quality/frontend-fundamentals.md와 개별 기준 문서를 self-check 기준으로 포함합니다. 구현 중 특정 기준만 빠르게 확인해야 하면 frontend-readability-check, frontend-predictability-check, frontend-cohesion-check, frontend-coupling-check를 사용합니다. 컴포넌트 내부 로직이나 custom hook 추출 단위를 판단해야 하면 frontend-logic-composition-workflow를 사용합니다. 비자명한 변경, shared/public API 변경, PR 전 점검은 frontend-fundamentals-review를 별도 리뷰 단계로 추가합니다.
출력 형식
## Frontend Work Plan
- 작업 유형:
- 대상 workspace:
- 부족한 입력:
- 사용할 작업 흐름 skill:
- 사용할 문서:
- 필요한 spec:
- 품질 self-check:
- 검증:
예외
- 단순 copy, import 정리, 한 줄 문서 변경은 이 skill을 강제하지 않습니다.
- 작은 변경에는 별도 계획을 길게 만들지 않습니다.