full-stack-orchestration-full-stack-feature

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

• フルスタック オーケストレーション フルスタック機能のタスクやワークフローに取り組んでいる
• フルスタック オーケストレーション フルスタック機能に関するガイダンス、ベストプラクティス、またはチェックリストが必要である

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

• タスクがフルスタック オーケストレーション フルスタック機能と無関係である
• このスコープ外の異なるドメインまたはツールが必要である

指示

• 目標、制約、必要な入力を明確にする
• 関連するベストプラクティスを適用し、結果を検証する
• 実行可能なステップと検証を提供する
• 詳細な例が必要な場合は、resources/implementation-playbook.md を開く

モダンな API-first アプローチを使用して、バックエンド、フロントエンド、インフラストラクチャレイヤー全体でフルスタック機能開発をオーケストレートします:

[Extended thinking: このワークフローは、複数の専門エージェントを調整して、アーキテクチャからデプロイメントまでの完全なフルスタック機能を実現します。API-first 開発原則に従い、API 仕様がバックエンド実装とフロントエンド消費の両方を駆動する契約駆動型開発を保証します。各フェーズは前のフェーズの出力に基づいており、懸念事項の適切な分離、包括的なテスト、本番環境対応のデプロイメントで構成された一貫性のあるシステムを作成します。ワークフローはコンポーネント駆動型 UI 開発、フィーチャーフラグ、可観測性、段階的なロールアウト戦略などのモダンプラクティスを強調しています。]

フェーズ 1: アーキテクチャ & 設計の基礎

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

• Task ツールを使用し、subagent_type="database-design::database-architect"
• プロンプト: "以下のデータベーススキーマとデータモデルを設計してください: $ARGUMENTS。スケーラビリティ、クエリパターン、インデックス戦略、データ整合性の要件を検討してください。既存のスキーマを変更する場合はマイグレーション戦略を含めてください。論理的および物理的データモデルの両方を提供してください。"
• 期待される出力: エンティティ関係図、テーブルスキーマ、インデックス戦略、マイグレーションスクリプト、データアクセスパターン
• コンテキスト: 初期要件とビジネスドメインモデル

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

• Task ツールを使用し、subagent_type="backend-development::backend-architect"
• プロンプト: "以下のバックエンドサービスアーキテクチャを設計してください: $ARGUMENTS。前のステップのデータベース設計を使用して、サービス境界を作成し、API コントラクト (OpenAPI/GraphQL) を定義し、認証/認可戦略を設計し、サービス間通信パターンを指定してください。レジリエンスパターン (サーキットブレーカー、再試行) とキャッシング戦略を含めてください。"
• 期待される出力: サービスアーキテクチャ図、OpenAPI 仕様、認証フロー、キャッシングアーキテクチャ、メッセージキュー設計 (必要に応じて)
• コンテキスト: ステップ 1 のデータベーススキーマ、非機能要件

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

• Task ツールを使用し、subagent_type="frontend-mobile-development::frontend-developer"
• プロンプト: "以下のフロントエンドアーキテクチャとコンポーネント構造を設計してください: $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"
• プロンプト: "以下の API コントラクトテストを作成してください: $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 セットアップ

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

11. 可観測性 & 監視

• Task ツールを使用し、subagent_type="deployment-engineer"
• プロンプト: "以下の可観測性スタックを実装してください: $ARGUMENTS。分散トレーシング (OpenTelemetry) をセットアップし、アプリケーションメトリクス (Prometheus/DataDog) を構成し、集約ログ (ELK/Splunk) を実装し、主要メトリクスのダッシュボードを作成し、SLI/SLO を定義してください。アラートルールとオンコール手順を含めてください。"
• 期待される出力: 可観測性構成、ダッシュボード定義、アラートルール、ランブック、SLI/SLO 定義
• コンテキスト: ステップ 10 のインフラストラクチャセットアップ

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

• Task ツールを使用し、subagent_type="performance-engineer"
• プロンプト: "以下のスタック全体のパフォーマンスを最適化してください: $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

制限事項

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