ゼロからプロジェクトのスキャフォールド

空のディレクトリから実行可能なプロジェクトへ。技術スタックと規約を説明すると、OpenCode はフォルダレイアウト、設定ファイル、初回でビルドできるスターターを生成します。

このレシピを使う場面

• 新しいプロジェクトを始め、理にかなったデフォルト構造が欲しいとき。
• チームの規約を一貫して適用したいとき。
• すぐにビルド・実行できるスターターが欲しいとき。

前提条件

• 空または初期化済みの git リポジトリ。
• OpenCode をインストール済み。

手順

1. スタックと目標を説明する

   技術、規約、「完成」の意味を具体的に伝えます。

   TypeScript の Node.js サービスを Fastify でスキャフォールドしてください。ルート、サービス、設定を分離した src/ レイアウトを含めてください。ESLint、Prettier、Vitest、ヘルスチェックルートを追加してください。プロジェクトは初回でビルドでき、ヘルスチェックが通る必要があります。

2. 提案構造を確認する

   OpenCode はまずツリーを示します。ファイルを書く前に調整します。

   src/
     routes/health.ts
     services/
     config/index.ts
     index.ts

3. ファイルを生成する

   OpenCode にレイアウト、設定、ボイラープレートを書かせます。

4. ビルドを検証する

   npm install
   npm run build
   npm test

5. ベースラインをコミットする

   git add -A && git commit -m "chore: initial scaffold"

主要なプロンプト

TypeScript の Fastify サービスを作成してください。レイアウトは src/routes、src/services、src/config を使用。ESLint + Prettier + Vitest、/health ルート、env ベースの設定ローダーを追加してください。npm install && npm run build がエラーなく成功するようにしてください。

よくある落とし穴

• 曖昧な仕様：「Web アプリを作って」では汎用的な結果になります——スタック、レイアウト、成功基準を明確にしてください。
• 成功確認の欠落：プロンプトに必ずビルド/テストコマンドを含め、スキャフォールドが書かれるだけでなく検証されるようにします。
• 規約の無視：チームが特定のパターン（機能フォルダなど）を使う場合は明示しないと、スキャフォールドが一致しません。

関連ドキュメント

• クイックスタート — 新しいプロジェクトで数分で OpenCode を実行
• 設定 — プロジェクトレイアウトに合わせた opencode.json のセットアップ

関連レシピ

• git-commit-workflow — reason.scaffold.to-git
• mcp-server — reason.scaffold.to-mcp
• custom-skill — reason.scaffold.to-skill

関連ドキュメント

• クイックスタート
• インストール
• 設定

次のステップ

• git-commit-workflow — next.scaffold.to-git