新しいプロジェクトを開始
クライアントのブリーフを受け取り、その日のうちに動作するスケルトンに仕上げることができるのが、高速なチームの証です。Sun Agent Kitを使えば、ブリーフをそのままツールチェーンに投入するだけで、アーキテクチャの意思決定、フォルダ構造、CI設定、そして開発計画が、ビジネスロジックを1行も書く前にすべて揃います。
概要
目標: クライアントのブリーフから、フィーチャー開発が即座に開始できる動作済みプロジェクトスケルトンを作成する
所要時間: 30〜60分（手動では4〜8時間）
使用エージェント: planner、reviewer
コマンド: /sk:bootstrap、/sk:plan、/sk:scout、/sk:docs
前提条件
- Sun Agent Kitがインストール済みであること（インストールガイド）
- Node.js 18以上またはBunランタイムが利用可能であること
- プロジェクトブリーフがあること（プレーンテキスト、PDF、または仕様書のURLで可）
- 対象ディレクトリでGitが初期化済みであること（
git init） - ブリーフに記載されているサードパーティサービスへのアクセス認証情報（後から追加することも可能）
ステップバイステップのワークフロー
ステップ1：プロジェクトスケルトンをブートストラップする
/sk:bootstrap "Node.js REST API for an e-commerce platform — PostgreSQL, Express, JWT auth, product catalog, cart, orders"実行内容: エージェントが以下を実行します：
- プロジェクトの説明を分析し、技術スタック、データベース、ドメイン領域を特定します
- ルート、コントローラー、サービス、モデルを含むフォルダ構造を生成します
- フレームワークと開発用依存パッケージをインストールします
- 設定ファイル（
.env.example、tsconfig.json、Dockerfile）を作成します - 初回の型チェックを実行し、スケルトンが正常にコンパイルされることを確認します
ステップ2：実装計画を生成する
/sk:plan "Three sprints: Sprint 1 auth + catalog, Sprint 2 cart + orders, Sprint 3 payments + admin panel"実行内容: エージェントが以下を実行します：
- 生成されたコードベース構造を読み取り、依存関係グラフを構築します
- 各スプリントのフェーズファイルを
plans/ディレクトリ以下に書き出します - 各フェーズをタスクに分解し、フェーズ間の依存関係を解決します
- クリティカルパスを特定し、概要を
plans/plan.mdに保存します
ステップ3：アーキテクチャをレビューする
/sk:scout "review the generated structure and flag any architectural concerns before development starts"実行内容: エージェントが以下を実行します：
- 生成されたスキャフォールドをスキャンし、プロジェクトファイルを読み込みます
- ミドルウェアの不足、空ディレクトリ、構造上のギャップを確認します
- 警告をフラグします（例：レート制限がない、マイグレーションディレクトリが空など）
- アーキテクチャレポートを
plans/reports/scout-report.mdに保存します
ステップ4：初期ドキュメントを生成する
/sk:docs "generate README, API overview, and local dev setup guide"実行内容: エージェントが以下を実行します：
- 設定ファイルを読み取り、プロジェクトのセットアップを理解します
- ルートスタブを探索し、想定されるリクエスト/レスポンスの形式をドキュメント化します
- README、APIの概要、ローカル開発セットアップガイドを書き出します
- ドキュメント内のクロスリファレンスが正しく解決されることを確認します
ステップ5：ベースラインをコミットする
/sk:git cm実行内容: エージェントが以下を実行します：
.gitignoreを尊重しながらすべてのプロジェクトファイルをステージングします（.envは自動的に除外）- スキャフォールドを説明するコンベンショナルコミットメッセージを作成します
- Sprint 1のベースラインとして初回コミットを作成します
完全な実例：クライアントがECアプリのブリーフを送付してきた場合
シナリオ: 火曜日の午後、クライアントから2ページのブリーフがメールで届きました。オンラインアパレルショップのMVPバックエンドが必要で、ユーザー登録、商品ブラウジング、カート、Stripeによる決済、在庫管理のための管理パネルが求められています。納期は6週間です。
月曜日の朝に実行するコマンド:
# 1. ブリーフのテキストからブートストラップ（ペーストまたはパイプで渡す）
/sk:bootstrap "E-commerce backend: user auth (email + Google OAuth), product catalog with categories and variants, shopping cart with session persistence, Stripe checkout, order history, admin CRUD for products and orders. Stack: Node.js, Express, PostgreSQL, Redis for sessions."
# 2. 6週間の納期に合わせて計画を立てる
/sk:plan "6 weeks, 2-week sprints. Sprint 1: auth + catalog. Sprint 2: cart + checkout. Sprint 3: orders + admin."
# 3. チームがチケットを拾う前に問題を洗い出す
/sk:scout "review generated scaffold for security gaps, missing middleware, and any structural issues"
# 4. クライアントがレビューできるドキュメントを作成する
/sk:docs "README with setup instructions, API contract stubs, deployment notes for the client's AWS environment"
# 5. コミットしてプッシュ
/sk:git cm結果: 月曜日の午前中には、チームはコンパイル可能なプロジェクトスケルトン、複数フェーズにわたるタスクを含む計画、警告を指摘するスカウトレポート、そしてクライアントが読めるクリーンなドキュメントを手に入れます。フィーチャー開発をすぐに開始できます。
時間の比較
| タスク | 手動 | Sun Agent Kit使用時 |
|---|---|---|
| フォルダ構造 + 設定ファイル | 1〜2時間 | 数分 |
| 依存関係の調査 + インストール | 30〜60分 | 数分 |
| スプリント計画 + タスク分解 | 1〜2時間 | 数分 |
| アーキテクチャレビュー | 30〜60分 | 数分 |
| README + 初期ドキュメント | 30〜60分 | 数分 |
| 合計 | 4〜8時間 | 30〜60分 |
ベストプラクティス
1. ブートストラッププロンプトにドメイン固有の言語を含める ✅
説明が具体的であればあるほど（データモデル、サードパーティサービス、チームの制約など）、スキャフォールドの精度が上がります。「Node.js API with Stripe and PostgreSQL」は「web backend」よりも優れた結果を生み出します。
2. 計画にコミットする前にスカウトを実行する ✅
スカウトエージェントは生成されたスケルトンを読み取り、構造上の問題が技術的負債になる前に検出します。ブートストラップと計画の間に実行してください。後からではなく。
3. 小規模なプロジェクトでも /sk:plan をスキップしない ✅
2週間のプロジェクトでも、書かれた計画から恩恵を受けられます。新しいチームメンバーへのオンボーディング資料となり、クライアントへのスコープ参照にもなります。
4. 曖昧な一文を /sk:bootstrap に渡す ❌
/sk:bootstrap "build a website" は汎用的なスケルトンを生成するため、大幅な修正が必要になります。まずクライアントのブリーフから具体的な情報を10分かけて抽出してください。
5. .env ファイルをコミットする ❌
Sun Agent Kitのコミットコマンドは .gitignore を自動的に尊重しますが、プッシュ前に必ず確認してください。プライベートリポジトリであっても、実際の認証情報を絶対にコミットしないでください。
トラブルシューティング
問題：ブートストラップが依存関係のインストールでハングする
解決策: ネットワークとnpm/bunレジストリへのアクセスを確認してください。インストールが失敗し続ける場合は、まずプロジェクトをスキャフォールドし、ブートストラップが完了した後で npm install を手動で実行してください。
問題：計画フェーズファイルの粒度が細かすぎる（1フェーズに100以上のタスク）
解決策: スプリントの説明が広すぎます。各スプリントを2〜3つの主要フィーチャーに絞り込んでください: /sk:plan "Sprint 1: user registration and JWT auth only"。
問題：スカウトレポートが空になる
解決策: スカウトエージェントは分析するためにある程度のソースファイルが必要です。/sk:bootstrap が完了した後に実行してください。
問題：生成されたスケルトンにTypeScriptエラーが発生する
解決策: /sk:fix "fix all TypeScript errors in the generated scaffold" を実行してください。デバッガーエージェントが生成ファイルのインポートエラーと型エラーを解決します。
次のステップ
- 既存コードベースの引き継ぎ — ゼロから始める代わりに別チームから引き継ぐ場合に使用
- 新機能を追加 — スキャフォールドが完成した後の次のステップ
- REST APIを構築 — APIの設計と実装をより深く掘り下げる
重要なポイント: クライアントのブリーフは1時間以上受信トレイに留めておくべきではありません。/sk:bootstrap はコーヒーを飲んでいる間に、それをコンパイル可能なプロジェクトスケルトンと書かれた計画に変換します。