full-stack-orchestration-full-stack-feature

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

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

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

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

手順

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

モダンな API ファーストのアプローチで、バックエンド、フロントエンド、インフラストラクチャの各層にわたるフルスタック機能の開発をオーケストレーションします。

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

スコープとエビデンスの取り決め

機能、受け入れ例、技術スタック、許可されたデプロイ先を確認します。Task ツールとサブエージェントの名前は環境固有のプレースホルダーです。利用可能なツールと、担当範囲および統合に関する契約が明確な、許可された委任先を使用してください。レビューや設計の成果物は、実行済みテスト、ペネトレーションテストの結果、WCAG 準拠、本番環境の認定を意味するものではありません。実際に実行したコマンドと結果、未解決のリスクを記録してください。移行はバックアップと互換性を確保して段階的に行い、テナントと認証の境界を検証してください。公開、インフラストラクチャ、外部テレメトリ、有料サービスの利用には許可を得てください。関連するフェーズのみを選択してください。ゼロダウンタイムやコンプライアンスに関する主張には、デプロイ先固有のエビデンスが必要です。

フェーズ 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. バックエンドサービスの実装

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

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

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

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

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

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

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

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

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

• Task ツールを使用し、subagent_type="test-automator" を指定します
• プロンプト："以下の E2E テストを実装してください：$ARGUMENTS。重要なユーザージャーニー、クロスブラウザー互換性、モバイルでの応答性、エラーシナリオを網羅する Playwright/Cypress テストを作成します。フィーチャーフラグの連携、アナリティクスのトラッキング、パフォーマンス指標をテストします。ビジュアルリグレッションテストも含めます。"
• 期待される出力：E2E テストスイート、ビジュアルリグレッションのベースライン、パフォーマンスベンチマーク、テストレポート
• コンテキスト：フェーズ 2 のフロントエンドとバックエンドの実装

9. セキュリティ監査と強化

• Task ツールを使用し、subagent_type="security-auditor" を指定します
• プロンプト："以下のセキュリティ監査を実施してください：$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

例

ユーザーリクエスト:

この機能をバックエンド、フロントエンド、データレイヤーにまたがって実装し、エンドツーエンドの動作を検証してください。

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が欠けている場合は、停止して確認を求めてください。