フロントエンドオーケストレータースキル は何をしますか?
ロール
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: ["すべてのビューポートサイズ", "ローディング状態"]
タスク処理フロー
- メインオーケストレーターから受信
{
"task_id": "task-001-auth",
"what": "パスワードリセットフォーム",
"where": "/src/components/auth/"
}
- コンテキストの準備
- 現在のコンポーネント状態の読み込み
- デザインシステムコンポーネントの確認
- 過去の類似実装のレビュー
- スキルへの割り当て
{
"skill": "react-component-skill",
"action": "create",
"context": "[準備されたコンテキスト]"
}
- 実行の監視
- operations.logの監視
- Playwrightによるビジュアルテストの実行
- アクセシビリティのチェック
- 結果の検証
checks:
✅ コンポーネントがレンダリングされる
✅ フォームバリデーションが機能する
✅ エラー状態が表示される
✅ モバイルでレスポンシブ
✅ キーボードでナビゲート可能
✅ スクリーンリーダー互換
フロントエンド固有の標準
コンポーネントチェックリスト
- TypeScript型が定義されている
- Propsがドキュメント化されている
- エラーバウンダリが実装されている
- ローディング状態が処理されている
- 必要な場所でメモ化されている
- 単体テストが記述されている
- ビジュアルテストが合格している
状態管理ルール
- 単一の真実源
- 不変更新のみ
- アクションはシリアル化可能
- セレクタ内の計算値
- コンポーネント内にビジネスロジックなし
統合ポイント
バックエンドオーケストレーターとの連携
- API契約のネゴシエーション
- エラーフォーマットの合意
- ローディング状態の調整
ヒューマンドキュメントとの連携
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エラーゼロ
- コンポーネント再利用 > 60%
一般的な問題と解決策
問題: 「コンポーネントが再レンダリングされすぎる」
解決策: メモ化を追加し、依存配列を確認する
問題: 「状態更新が反映されない」
解決策: 不変性を確認し、レデューサーロジックを検証する
問題: 「ビジュアルテストが不安定」
解決策: 待機条件を追加し、アニメーションを安定化する
避けるべきアンチパターン
❌ コンポーネント内のビジネスロジック ❌ 直接的なDOM操作 ❌ インラインスタイル(Tailwindを使用) ❌ エラーバウンダリのスキップ ❌ アクセシビリティの無視 ❌ 巨大コンポーネントの作成