project-scaffolder

プロジェクトスキャフォルダー

あらゆる技術スタック向けに、ベストプラクティスに沿った規約を備える、本番環境に対応したスターターリポジトリを生成します。

コアワークフロー

1. スタックを決定する：ユーザーに指定してもらうか、コンテキストから推測します（Next.js、Vite、Nest、FastAPI など）
2. テンプレートを選択する：references/templates.md を参照して、適切なプロジェクト構成を選びます
3. 構成を生成する：必要なファイルをすべて含むフォルダーツリーを作成します
4. ベースラインコードを追加する：概念実証として、動作する「Hello World」ルート／ページを含めます
5. ツールを設定する：package.json/requirements.txt、tsconfig、リンティング、フォーマット設定を追加します
6. スクリプトを作成する：dev、build、test、デプロイ用のスクリプトを含めます
7. セットアップを文書化する：セットアップ手順と次のアクションを記載した、包括的な README を生成します

主な成果物

スキャフォールドしたすべてのプロジェクトに、次の項目を含める必要があります。

• フォルダーツリー：適切に整理された src/、lib/、config/、tests/ の構成
• ベースラインコード：動作する Hello World エンドポイントまたはページ
• パッケージファイル：package.json、requirements.txt、Cargo.toml など
• 設定ファイル：TypeScript、ESLint、Prettier、環境ファイル（.env.example）
• スクリプト：一般的なタスク用の npm スクリプトまたは Makefile
• README：セットアップ手順、技術スタックの概要、次のステップ
• Git のセットアップ：スタックに合わせて設定した .gitignore

スタック固有のパターン

スタックごとの詳しいパターンについては、references/templates.md を参照してください。

• Next.js App Router
• Vite + React
• NestJS
• FastAPI
• Express + TypeScript
• Vue + Vite
• SvelteKit

ベストプラクティス

• 対応している場合は絶対インポート（@/ エイリアス）を使用します
• 環境変数のテンプレートを含めます
• 基本的なエラーハンドリングとロギングのセットアップを追加します
• tsconfig でパスマッピングを設定します
• コンテナ化用の Docker ファイルを含めます（任意）
• GitHub Actions または CI ワークフローのテンプレートを追加します（任意）

段階的な拡張

まず最小限の実用的な構成を用意し、次に以下を追加します。

• データベースのセットアップ（Prisma、TypeORM、SQLAlchemy）
• 認証のスキャフォールド（NextAuth、Passport、JWT）
• API クライアントのセットアップ（Axios、Fetch ラッパー）
• 状態管理（Zustand、Redux、Pinia）
• テストのセットアップ（Jest、Vitest、Pytest）

出力構成

最初に完全なプロジェクトツリーを提示し、次に適切な場所にすべてのファイルを作成します。作成した内容の概要と、プロジェクトの実行に必要な次のステップを必ず提示してください。