full-stack-orchestration-full-stack-feature

このスキルを使用する場面

• フルスタックオーケストレーションのフルスタック機能に関するタスクやワークフローに取り組む場合
• フルスタックオーケストレーションのフルスタック機能について、ガイダンス、ベストプラクティス、チェックリストが必要な場合

このスキルを使用しない場面

• タスクがフルスタックオーケストレーションのフルスタック機能に関係しない場合
• この範囲外の別のドメインやツールが必要な場合

手順

• 目標、制約、必要な入力を明確にします。
• 関連するベストプラクティスを適用し、成果を検証します。
• 実行可能な手順と検証方法を提示します。

最新の API ファーストアプローチを用いて、バックエンド、フロントエンド、インフラストラクチャの各レイヤーにわたるフルスタック機能開発をオーケストレーションします。

[Extended thinking: このワークフローでは、複数の専門エージェントを連携させ、アーキテクチャ設計からデプロイまで、フルスタック機能を完成させます。API ファースト開発の原則に従い、API 仕様をバックエンドの実装とフロントエンドでの利用の両方に活用する、コントラクト主導の開発を実現します。各フェーズは前のフェーズの成果を基盤として構築され、関心事を適切に分離し、包括的なテストと本番環境対応のデプロイを備えた、一貫性のあるシステムを作り上げます。このワークフローでは、コンポーネント主導の UI 開発、機能フラグ、オブザーバビリティ、段階的なロールアウト戦略といった最新のプラクティスを重視します。]

フェーズ 1：アーキテクチャと設計の基盤

1. データベースアーキテクチャの設計

• subagent_type="database-design::database-architect" を指定して Task ツールを使用します
• プロンプト：「次の内容について、データベーススキーマとデータモデルを設計してください：$ARGUMENTS。スケーラビリティ、クエリパターン、インデックス戦略、データ整合性の要件を考慮してください。既存のスキーマを変更する場合は、マイグレーション戦略も含めてください。論理データモデルと物理データモデルの両方を提示してください。」
• 期待される出力：エンティティ関連図、テーブルスキーマ、インデックス戦略、マイグレーションスクリプト、データアクセスパターン
• コンテキスト：初期要件とビジネスドメインモデル

2. バックエンドサービスアーキテクチャ

• subagent_type="backend-development::backend-architect" を指定して Task ツールを使用します
• プロンプト：「次の内容について、バックエンドサービスアーキテクチャを設計してください：$ARGUMENTS。前のステップで設計したデータベースを使用し、サービス境界を設定して、API コントラクト（OpenAPI/GraphQL）を定義し、認証／認可戦略を設計するとともに、サービス間の通信パターンを指定してください。サーキットブレーカーやリトライなどのレジリエンスパターンと、キャッシュ戦略も含めてください。」
• 期待される出力：サービスアーキテクチャ図、OpenAPI 仕様、認証フロー、キャッシュアーキテクチャ、メッセージキューの設計（該当する場合）
• コンテキスト：ステップ 1 のデータベーススキーマ、非機能要件

3. フロントエンドコンポーネントアーキテクチャ

• subagent_type="frontend-mobile-development::frontend-developer" を指定して Task ツールを使用します
• プロンプト：「次の内容について、フロントエンドアーキテクチャとコンポーネント構造を設計してください：$ARGUMENTS。前のステップで定義した API コントラクトに基づき、コンポーネント階層、状態管理方式（Redux/Zustand/Context）、ルーティング構造、データ取得パターンを設計してください。アクセシビリティ要件とレスポンシブデザイン戦略も含めてください。Storybook のコンポーネントドキュメントの計画も立ててください。」
• 期待される出力：コンポーネントツリー図、状態管理設計、ルーティング設定、デザインシステム統合計画、アクセシビリティチェックリスト
• コンテキスト：ステップ 2 の API 仕様、UI/UX 要件

フェーズ 2：並行実装

4. バックエンドサービスの実装

• スタックに応じて subagent_type="python-development::python-pro"（または "golang-pro"/"nodejs-expert"）を指定して Task ツールを使用します
• プロンプト: 「$ARGUMENTS のバックエンドサービスを実装してください。フェーズ 1 のアーキテクチャと API 仕様を使用して、適切なバリデーション、エラーハンドリング、ロギングを備えた RESTful/GraphQL エンドポイントを構築してください。ビジネスロジック、データアクセス層、認証ミドルウェア、外部サービスとの統合を実装してください。オブザーバビリティ（構造化ロギング、メトリクス、トレーシング）を含めてください。」
• 期待される成果物: バックエンドサービスコード、API エンドポイント、ミドルウェア、バックグラウンドジョブ、単体テスト、統合テスト
• コンテキスト: フェーズ 1 のアーキテクチャ設計、データベーススキーマ

5. フロントエンドの実装

• subagent_type="frontend-mobile-development::frontend-developer" を指定して Task ツールを使用します
• プロンプト: 「$ARGUMENTS のフロントエンドアプリケーションを実装してください。フェーズ 1 のコンポーネントアーキテクチャを使用して React/Next.js コンポーネントを構築してください。状態管理、適切なエラーハンドリングとローディング状態を備えた API 統合、フォームバリデーション、レスポンシブレイアウトを実装してください。コンポーネントの Storybook ストーリーを作成してください。アクセシビリティ（WCAG 2.1 AA 準拠）を確保してください。」
• 期待される成果物: React コンポーネント、状態管理の実装、API クライアントコード、Storybook ストーリー、レスポンシブスタイル、アクセシビリティの実装
• コンテキスト: ステップ 3 のコンポーネントアーキテクチャ、API コントラクト

6. データベースの実装と最適化

• subagent_type="database-design::sql-pro" を指定して Task ツールを使用します
• プロンプト: 「$ARGUMENTS のデータベース層を実装および最適化してください。マイグレーションスクリプト、ストアドプロシージャ（必要な場合）を作成し、バックエンド実装で特定されたクエリを最適化し、適切なインデックスを設定し、データバリデーション制約を実装してください。データベースレベルのセキュリティ対策とバックアップ戦略を含めてください。」
• 期待される成果物: マイグレーションスクリプト、最適化されたクエリ、ストアドプロシージャ、インデックス定義、データベースセキュリティ設定
• コンテキスト: ステップ 1 のデータベース設計、バックエンド実装のクエリパターン

フェーズ 3: 統合とテスト

7. API コントラクトテスト

• subagent_type="test-automator" を指定して Task ツールを使用します
• プロンプト: 「$ARGUMENTS のコントラクトテストを作成してください。バックエンドとフロントエンド間の API コントラクトを検証する Pact/Dredd テストを実装してください。すべての API エンドポイントの統合テストを作成し、認証フローをテストし、エラーレスポンスを検証し、適切な CORS 設定を確保してください。負荷テストシナリオを含めてください。」
• 期待される成果物: コントラクトテストスイート、統合テスト、負荷テストシナリオ、API ドキュメントの検証
• コンテキスト: フェーズ 2 の API 実装

8. エンドツーエンドテスト

• subagent_type="test-automator" を指定して Task ツールを使用します
• プロンプト: 「$ARGUMENTS の E2E テストを実装してください。重要なユーザージャーニー、クロスブラウザ互換性、モバイルレスポンシブ対応、エラーシナリオをカバーする Playwright/Cypress テストを作成してください。フィーチャーフラグの統合、分析トラッキング、パフォーマンスメトリクスをテストしてください。ビジュアルリグレッションテストを含めてください。」
• 期待される成果物: E2E テストスイート、ビジュアルリグレッションのベースライン、パフォーマンスベンチマーク、テストレポート
• コンテキスト: フェーズ 2 のフロントエンドおよびバックエンドの実装

9. セキュリティ監査とハードニング

• subagent_type="security-auditor" を指定して Task ツールを使用します
• プロンプト: 「$ARGUMENTS のセキュリティ監査を実施してください。API セキュリティ（認証、認可、レート制限）をレビューし、OWASP Top 10 の脆弱性をチェックし、フロントエンドの XSS/CSRF リスクを監査し、入力サニタイズを検証し、シークレット管理をレビューしてください。ペネトレーションテストの結果と修正手順を提供してください。」
• 期待される成果物: セキュリティ監査レポート、脆弱性評価、修正の推奨事項、セキュリティヘッダー設定
• コンテキスト: フェーズ 2 のすべての実装

フェーズ 4: デプロイと運用

10. インフラストラクチャと CI/CD のセットアップ

• subagent_type="deployment-engineer" を指定して Task ツールを使用します
• プロンプト: 「次の内容についてデプロイ用インフラストラクチャをセットアップしてください: $ARGUMENTS。Docker コンテナと Kubernetes マニフェスト（またはクラウド固有の設定）を作成し、自動テストゲートを備えた CI/CD パイプラインを実装し、フィーチャーフラグ（LaunchDarkly/Unleash）をセットアップして、監視とアラートを設定してください。ブルーグリーンデプロイ戦略とロールバック手順も含めてください。」
• 期待される出力: Dockerfile、K8s マニフェスト、CI/CD パイプライン設定、フィーチャーフラグのセットアップ、IaC テンプレート（Terraform/CloudFormation）
• コンテキスト: 前のフェーズでのすべての実装とテスト

11. オブザーバビリティと監視

• subagent_type="deployment-engineer" を指定して Task ツールを使用します
• プロンプト: 「次の内容についてオブザーバビリティスタックを実装してください: $ARGUMENTS。分散トレーシング（OpenTelemetry）をセットアップし、アプリケーションメトリクス（Prometheus/DataDog）を設定し、ログを一元管理（ELK/Splunk）し、主要なメトリクスのダッシュボードを作成して、SLI/SLO を定義してください。アラートルールとオンコール手順も含めてください。」
• 期待される出力: オブザーバビリティ設定、ダッシュボード定義、アラートルール、ランブック、SLI/SLO 定義
• コンテキスト: ステップ 10 のインフラストラクチャ設定

12. パフォーマンスの最適化

• subagent_type="performance-engineer" を指定して Task ツールを使用します
• プロンプト: 「次の内容について、スタック全体のパフォーマンスを最適化してください: $ARGUMENTS。データベースクエリを分析して最適化し、キャッシュ戦略（Redis/CDN）を実装し、フロントエンドのバンドルサイズと読み込みパフォーマンスを最適化し、遅延読み込みとコード分割をセットアップして、バックエンドサービスのパフォーマンスを調整してください。最適化前後のメトリクスも含めてください。」
• 期待される出力: パフォーマンス改善、キャッシュ設定、CDN セットアップ、最適化済みバンドル、パフォーマンスメトリクスレポート
• コンテキスト: ステップ 11 の監視データ、負荷テストの結果

設定オプション

• stack: 技術スタックを指定します（例: 「React/FastAPI/PostgreSQL」、「Next.js/Django/MongoDB」）
• deployment_target: クラウドプラットフォーム（AWS/GCP/Azure）またはオンプレミス
• feature_flags: フィーチャーフラグ連携を有効化／無効化します
• api_style: REST または GraphQL
• testing_depth: 包括的または必須項目のみ
• compliance: 特定のコンプライアンス要件（GDPR、HIPAA、SOC2）

成功基準

• すべての API 契約が契約テストで検証されている
• フロントエンドとバックエンドの統合テストに合格している
• 重要なユーザージャーニーをカバーする E2E テストがある
• セキュリティ監査に合格し、重大な脆弱性がない
• パフォーマンスメトリクスが定義済みの SLO を満たしている
• オブザーバビリティスタックがすべての主要なメトリクスを収集している
• 段階的なロールアウトに向けてフィーチャーフラグが設定されている
• すべてのコンポーネントのドキュメントが完成している
• 自動化された品質ゲートを備えた CI/CD パイプラインがある
• ゼロダウンタイムデプロイが可能であることを検証済み

連携に関する注意事項

• 各フェーズは前のフェーズの成果物を基に進めます
• フェーズ 2 の並行タスクは同時に実行できますが、フェーズ 3 に進む前に統合する必要があります
• 要件と実装のトレーサビリティを維持します
• 分散トレーシングのため、すべてのサービスで相関 ID を使用します
• すべてのアーキテクチャ上の意思決定を ADR に記録します
• サービス間で一貫したエラー処理と API レスポンスを確保します

実装する機能: $ARGUMENTS