build-mvp について
build-mvp は、製品ロードマップに沿ってアプリを実装する BuilderOS のスキルです。コーディングエージェントにタスクごとの検証とフェーズ確認を促し、完了後にバージョン管理を行います。
主な機能
- 01ロードマップ順の実装
- 02PRDとデザイン資料の参照
- 03タスクごとのテストと検証
- 04フェーズ終了時の一連の動作確認
- 05完了後のGit処理
活用シーン
- 01既存ロードマップからのMVP構築
- 02製品仕様の段階的な実装
- 03タスク完了前の機能検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ buildgreatproducts/ builder-os --skill build-mvpインストール後、Claude Code で/build-mvpを入力して読み込まれたか確認します。
詳細
MVP を構築する
すべてのタスクが完了になるまで、docs/product-roadmap.md の各タスクを順番に実行し、アプリ全体を構築します。
セットアップ
まず docs/product-roadmap.md を読みます。ここに、構築するものとその順序の基準となる情報が記載されています。docs/prd.md はその技術仕様、docs/design.md はビジュアルデザインのトークン、docs/product-vision.md はプロダクト戦略をまとめたドキュメントです。これらのドキュメントを最初から最後まで読み込まないでください。各フェーズには、読むべき Reference セクションと、タスクの Notes 行で指定された項目が記載されています。docs/product-roadmap.md または docs/prd.md が見つからない場合は作業を中止し、BuilderOS の Product Planner スキル(https://github.com/BuildGreatProducts/builder-os)を実行するようユーザーに伝えてください。
作業ループ
ロードマップのすべてのタスクが完了するまで、次の作業を繰り返します。
- 最初の未完了タスク(
- [ ])を見つけます。 タスクは意図的な順序で並んでいます。先のタスクに飛ばないでください。 - タスクに必要な情報を読みます。 Files 行と Notes 行、および今のセッションでまだ読んでいない場合は現在のフェーズの Reference セクションを確認します。
- 指定どおりにタスクを実装します。 ファイルパス、パッケージ名、設定値にはそれぞれ意図があります。リポジトリの
CLAUDE.md/AGENTS.mdのガイドラインに従い、タスクを満たす最もシンプルな実装にしてください。推測で機能を追加せず、変更は必要最小限にします。 - 次に進む前にテストと検証を行います。 タスクの Notes の末尾にある検証手順を実行し、アプリを起動し、既存のテストを実行して、新しいロジックにはテストを追加します。検証に失敗した場合は、まず修正してください。タスクを未完了のままにせず、アプリが壊れた状態で次のタスクを始めないでください。
- タスクを完了にします。
- [ ]を- [x]に変更し、ヘッダーのステータス行(**Status:** X/Y tasks complete、**Current Phase:** ...)も更新します。 - 各フェーズの区切りで、 アプリを最初から最後まで実行し、フェーズの Goal が達成され、デモ可能であることを確認してから次のフェーズを開始します。ここでは Git や GitHub の操作を行いません。バージョン管理はすべてのフェーズが完了した後、一度だけ行います。
ルール
- PRD で選定された技術スタックは確定事項です。別のものに置き換えず、そのとおりに実装してください。
- ビジュアルスタイルには
docs/design.mdのトークンを使用します。色、書体、余白を独自に決めないでください。docs/design.mdが存在しない場合は、ファンデーションフェーズのロードマップのガイダンスに従い、スタイリング作業を始める前に Design System スキルを実行するようユーザーに促してください。 - タスクが曖昧な場合、または PRD と矛盾する場合は、参照先の PRD セクションを確認してください。それでも不明な場合は、推測せず、具体的な質問を一つだけ尋ねてください。
- 必要な作業がどのタスクにも含まれていない場合は、その旨を伝え、タスクの追加を提案してください。黙ってスコープを広げないでください。
**Status:** Y/Y tasks completeになるまで作業を続けてください。すべてのタスクにチェックが入り、すべてのフェーズが検証され、マジックモーメントが最初から最後まで機能する状態にします。- すべてのフェーズが完了するまで、Git や GitHub の操作(初期化、コミット、ブランチ作成、プッシュ、プルリクエスト作成)は行わないでください。バージョン管理は作業ループの一部ではなく、最後の仕上げです。
仕上げ
すべてのタスクにチェックが入り、マジックモーメントが最初から最後まで機能することを確認したら、次の手順を実行します。
- Git を初期化し、最初のコミットを作成します。 まだ Git リポジトリでない場合は、
git initを実行し、スタックに適した.gitignore(依存関係、ビルド出力、.envファイルを対象とし、シークレットは絶対にコミットしない)を追加して、プロダクト名と MVP の構築が完了したことを示すメッセージで、すべてのファイルをコミットします。すでに Git リポジトリの場合は、現在のブランチにビルドをコミットします。 - リモートリポジトリに接続するか、ユーザーに確認します。 独断でリポジトリを作成したり、プッシュしたりしないでください。「リモートリポジトリに接続しますか? GitHub に新しいリポジトリ(公開または非公開)を作成するか、既存の URL に接続できます。」と尋ねます。ユーザーが希望する場合は
originとして設定してプッシュし、プッシュが成功したことを確認します。希望しない場合はローカルに残し、いつでもプッシュできる状態でコミットが用意できたことを伝えてください。
コメント
Markdown 対応