senior-fullstack

シニアフルスタック

本番環境に対応したプロジェクト構成（Next.js、FastAPI+React、MERN、Django+React）を作成し、セキュリティ、複雑度、依存関係の健全性、テストカバレッジ、ドキュメントを対象に静的なコード品質分析を実行するフルスタック開発スキルです。アーキテクチャパターン、開発ワークフロー、技術スタックの選定に関するリファレンスガイドも備えています。

主な機能

• プロジェクトのスキャフォールディング — TypeScript、Docker/docker-compose、環境変数テンプレート、パッケージ設定を含む、Next.js、FastAPI+React、MERN、Django+Reactの完全な構成を生成します。
• コード品質分析 — セキュリティ問題、サイクロマティック複雑度、依存関係のCVE、テストカバレッジの推定、ドキュメントのスコアを静的にスキャンし、総合スコア／評価と、優先度順のP0/P1/P2の推奨事項を提示します。
• 技術スタックの選定 — ユースケース（MVP、SaaS、エンタープライズ）に応じた、フレームワーク、データベース、ORM、認証、デプロイプラットフォームの判断マトリクスとトレードオフのガイドを提供します。
• アーキテクチャパターン — フロントエンドのコンポーネント設計、バックエンドのクリーンアーキテクチャ、API設計（REST/GraphQL）、キャッシュ、認証を扱います。
• ライフサイクルのワークフロー — ローカル環境のセットアップ、git、CI/CD、テスト、コードレビュー、デプロイ、オブザーバビリティを扱います。

使用する場面

次のような依頼があった場合に、このスキルを使用します。

• 「新しいプロジェクトをスキャフォールディングして」／「フルスタックプロジェクトをセットアップして」／「プロジェクトのひな形を生成して」
• 「Next.jsアプリを作成して」／「FastAPIとReactをセットアップして」
• 「コード品質を分析して」／「コードベースにセキュリティ上の問題がないか確認して」
• 「どの技術スタックを使うべき？」

まず確認すること

スキャフォールディングを行う前に、以下の入力内容を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• 技術スタック — Next.js / FastAPI+React / MERN / Django+React（スキャフォールドのテンプレートとファイルツリー全体が決まります）
• アプリ名と出力先パス — プロジェクトの書き込み先（project_scaffolderの位置引数）
• タスク — 新規プロジェクトのスキャフォールディングか、既存コードベースの品質分析か（project_scaffolderとcode_quality_analyzerのどちらを使うかが決まります）

中断ルール：出力に最も大きく影響する2～3項目だけを質問してください。ユーザーが「とりあえず下書きして」と言った場合は作業を進め、成果物の冒頭に前提を記載してください。

ツール

ツール	目的	コマンド
project_scaffolder.py	ひな形、Docker、環境設定を含むフルスタックプロジェクトの構成をスキャフォールディングします	python scripts/project_scaffolder.py nextjs my-app --output ./projects
code_quality_analyzer.py	コードベースを静的に分析し、セキュリティ、複雑度、依存関係、カバレッジ、ドキュメントを確認します	python scripts/code_quality_analyzer.py . --verbose --json --output audit.json

リファレンス

タスクに合ったリファレンスを読み込んでください。このファイルは簡潔に保ち、必要に応じて詳細を参照します。

• references/tooling-workflows-and-quality.md — ツールの完全なドキュメント（テンプレート、フラグ、出力例、出力形式）、エンドツーエンドの3つのワークフロー、技術スタックの判断マトリクス／よくある問題、トラブルシューティング表、成功基準をまとめています。ツールを詳しく実行するときや、リリース前に生成物を確認するときに読みます。
• references/architecture_patterns.md — フロントエンドのコンポーネントアーキテクチャ、バックエンドのクリーンアーキテクチャ／リポジトリパターン、RESTおよびGraphQL APIの設計、データベースパターン、キャッシュ戦略、認証アーキテクチャをまとめています。システム構成を設計またはレビューするときに読みます。
• references/development_workflows.md — ローカル開発環境のセットアップ、gitワークフロー、CI/CDパイプライン、テスト戦略、コードレビュープロセス、デプロイ戦略、オブザーバビリティをまとめています。開発ライフサイクルを立ち上げるときに読みます。
• references/tech_stack_guide.md — フロントエンド／バックエンドのフレームワーク比較、データベースの選定、ORM、認証ソリューション、デプロイプラットフォーム、ユースケース別の技術スタックの推奨事項をまとめています。技術スタックを選ぶときに読みます。

対象範囲と制限事項

このスキルで対応する内容：

• Docker、TypeScript、環境設定を含む、Next.js、FastAPI+React、MERN、Django+React スタックのプロジェクトのひな形作成
• 複雑度メトリクス、セキュリティパターンの検出、依存関係の脆弱性チェック、テストカバレッジの推定、ドキュメントの評価を含む、静的なコード品質分析
• 技術スタックの意思決定マトリクスとリファレンスガイドを用いた、スタック選択のガイダンス
• フルスタックアーキテクチャのパターン（フロントエンドのコンポーネント設計、バックエンドのクリーンアーキテクチャ、API 設計、キャッシュ、認証）

このスキルで対応しない内容：

• ランタイムのパフォーマンスプロファイリング、負荷テスト、APM の計装 — 可観測性ツールについては senior-devops を参照してください
• インフラストラクチャのプロビジョニング、Terraform/Pulumi、クラウドデプロイの自動化 — aws-solution-architect および senior-devops を参照してください
• 最新の脆弱性データベースを使った包括的な CVE スキャン — 詳細なセキュリティ分析には npm audit、pip-audit、または senior-secops を使用してください
• モバイルアプリやネイティブデスクトップアプリのひな形作成 — このスキルの対象は Web ベースのフルスタックアーキテクチャのみです

統合ポイント

スキル	統合内容	データフロー
senior-devops	ひな形を作成したプロジェクトの CI/CD パイプライン設定	スキャフォルダーの出力ディレクトリを、DevOps パイプラインの設定および Docker デプロイのワークフローに取り込みます
senior-secops	初回の品質スキャン後の詳細なセキュリティ監査	コード品質アナライザーで検出された P0/P1 のセキュリティ問題を SecOps に引き継ぎ、修正状況の追跡とペネトレーションテストを行います
senior-qa	ひな形を作成したプロジェクトのテスト戦略	アナライザーによるテストカバレッジの推定結果から QA テスト計画の不足を把握し、ひな形に含まれるテスト基盤をテストハーネスとして使用します
code-reviewer	生成済みコードおよび既存コードの自動レビュー	品質アナライザーの JSON レポートを、コードレビューチェックリストと PR 承認基準の構造化された入力として使用します
senior-architect	スタック選択のアーキテクチャ検証	技術スタックガイドの推奨事項をアーキテクチャ決定記録に反映し、複雑度メトリクスで設計への準拠を検証します
aws-solution-architect	ひな形を作成したアプリケーションのクラウドデプロイ	スキャフォルダーの Docker Compose 設定を、ECS/EKS のタスク定義およびインフラストラクチャの設計図に変換します