- 課題: 初心者向けチュートリアル通りにAIへプロンプトを投げるだけでは、制作が少し複雑化した途端にコードが崩壊したり、指示ブレで迷走したりしやすくなります。
- 必須機能の理解: `@ファイル指定` によるコンテキスト汚染防止や、AIから逆質問させる「`/grill-me`」などの標準機能をまず押さえることが第一歩です。
- 現場のブレイクスルー: 毎回コマンドを手動入力する段階を卒業し、`AGENTS.md`（行動規範ファイル）とMCP連携による「二層防御」を組むことで、AIは本当の実務パートナーへと進化します。
1. 「15分でアプリ完成」の先にある現実
YouTubeやSNSでは、「初心者でも15分でAIがアプリを完成させてくれる」といった魅力的なチュートリアルが多く発信されています。確かに、Antigravityなどの最新AIエージェント環境を使えば、画面の見た目を作ったり、シンプルな単体アプリを立ち上げたりすることは一瞬で可能です。
しかし、実際の業務や本格的な制作現場で使おうとすると、多くの方が次のような壁に直面します。
- 指示を重ねるごとに、さっきまで動いていたコードが壊れる
- 修正を指示するたびに、前回の前提やルールを忘れてアドリブで書き換えてくる
- エラーログや長文のやり取りでコンテキストが埋まり、AIの思考速度や精度が急激に落ちる
これはAIの能力不足ではなく、「AIへの丸投げ運用」そのものに原因があります。19分のチュートリアル動画を眺めているだけでは見えてこない、現場で本当に必要な「制御と設計のロードマップ」を整理して解説します。
2. Antigravity実践習得の全体ロードマップ
| 段階 | 主な操作・機能 | 解決できる課題 |
|---|---|---|
| Level 1: 標準機能の活用 | @ファイル参照 / /grill-me / /plan |
コンテキストの過熱防止、曖昧な指示による手戻りの削減 |
| Level 2: ルールファイルの固定 | AGENTS.md / カスタムスキル定義 |
毎回プロンプトを書く手間をゼロにし、AIのアドリブ暴走を封じる |
| Level 3: 外部連携と二層防御 | MCP（Obsidian連携等）/ 自動検証スクリプト | AIの下準備と人間の承認を分離し、実務で破綻しない品質ゲートを作る |
3. Level 1：まず押さえるべきAntigravityの標準便利機能
初心者が最初に覚えるべきなのは、チャット欄にただ要望を打ち込むのではなく、Antigravityに備わっている標準の制御コマンドを活用することです。
1. `@` によるファイル・シンボルのピンポイント指定
チャット欄で @app.js や @UserCard のようにファイルや関数を直接指定することで、AIはそのファイルだけをピンポイントで読み込みます。プロジェクト全体の無駄なファイルを読み込ませないため、AIの脳疲労（コンテキスト汚染）を物理的に防ぐ基本テクニックです。
2. 曖昧さを潰す逆質問コマンド「`/grill-me`」
「To-Doアプリを作って」とだけ指示すると、AIは自分の推測で勝手に仕様を決めてしまい、後から「そうじゃない」という手戻りが頻発します。
そこで便利なのが /grill-me というスラッシュコマンドです。
# /grill-me を使った指示の例
/grill-me ユーザーのログイン機能とタスク統計パネルを持つWebアプリを作りたいです。
必要な仕様や設計の不明点を質問してください。
このコマンドを使うと、AIはすぐにコードを書き始めるのではなく、「データベースは何を使いますか？」「認証方法はメールですか、OAuthですか？」といった逆質問（インタビュー）を投げかけてきます。仕様の曖昧さを事前に潰してから制作に入れるため、初心者が陥りがちな「思っていたのと違う」を劇的に減らすことができます。
3. 設計書を先に作らせる「`/plan`」
いきなりファイルを書き換えるのではなく、まずは実装計画（ステップ一覧）をマークダウンで出力させて確認するコマンドです。途中で計画の修正ができるため、大きな破綻を防ぐことができます。
4. Level 2：手動コマンドから「AGENTS.md」による自律制御へ
/grill-me や /plan は非常に便利ですが、制作のたびに毎回手動でコマンドを打ったり、同じような注意書きをプロンプトに書いたりするのは非効率です。
そこで次のステップとして、ワークスペース内に AGENTS.md（行動規範ファイル）を配置します。
# AGENTS.md（ルール定義）の設計例
1. 【仕様固定の義務】: 実装前に必ず要件・文字数・デザインルールを確定させる（後からのアドリブ変更を禁止）。
2. 【5ステップ直線進行】: 「仕様確認 ➔ 下書き ➔ 冷徹査読 ➔ 実体保存 ➔ 整合性検証」の1回通しで完結させる。
3. 【誇大表現の禁止】: 「AIが全自動で完結」等の表現を排除し、「AIの下準備 ＋ 人間の承認」を明記する。
このようにプロジェクトの根本ルールをファイルとして固定しておくことで、AIは指示を受けるたびに自律的にルールを読み込みます。わざわざ /grill-me と打たなくても、最初から「仕様の確認と構成案の提示」から入るようにAI自身を調教することができます。
5. Level 3：外部連携（MCP）と「二層防御」の現場運用
最高レベルの運用は、AIに「手足（外部ツール）」を持たせつつ、最終的な品質を人間が担保する「二層防御」の仕組みです。
1. MCP（Model Context Protocol）による知能の拡張
外部ナレッジやローカル環境とAntigravityを直結することで、AIは閉じたチャット欄から飛び出し、実務の現場で自律的に動くようになります。
- 知識管理（Obsidian Vault連携）: 過去のメモや仕様書をAIが直接検索・参照。過去の意思決定や哲学を引き継いで作業するため、ゼロから説明し直すコストが完全に消滅します。
- ローカルツールの実行・検証: 生成したコードやブログ記事を、ローカルのPythonスクリプトやDevToolsで即座に構文チェック・自動テストさせます。
2. 「AIの下準備 ＋ 人間の承認ゲート」
すべてを全自動で公開・デプロイまで任せると、予期せぬ不具合やハルシネーションが起きた際のリスクが跳ね上がります。
現場で絶対に破綻しない境界線は、以下の二層防御（Two-Layer Defense）を敷くことです。
- 第1層（AIの下準備・自動検証）: 高速なドラフト作成、コード生成、構文チェック、単体テストまでをAIが100%自律実行する。
- 第2層（人間の承認ゲート・品質保証）: 思想の整合性、文脈のニュアンス、最終的な公開・デプロイボタンの押下は必ず人間（オーナー）が担当する。
この「役割分担の黄金比率」を守ることで、事故を防ぎながら最高速度で実務を加速させることができます。
6. まとめ
Antigravityを使いこなす本質は、プロンプトのテクニックを競うことではなく、「AIが迷わず、手戻りなく動ける環境を人間が設計すること」にあります。
- 基本機能（
@参照や/grill-me）で曖昧さとコンテキスト汚染を潰す AGENTS.mdで毎回指示しなくても動くルールを固定化する- MCP連携と二層防御（AI下準備＋人間承認）で実務の品質を守る
まずは次の制作で、指示文の先頭に @ファイル名 を添えることや、/grill-me で仕様をすり合わせることから始めてみてください。AIとの共同作業が劇的にスムーズになるはずです。
💡 あわせて読みたい：APIキーの料金と安全仕様
「APIキーを発行すると勝手に課金されないか心配…」という方は、無料枠の安全装置とGCP予算アラートの仕組みを解説した初めてのGoogle API利用で知るべき「無料のカラクリ」を先にご確認ください。
💡 あわせて読みたい：AIエージェントの判断設計論
プロンプトに判断を丸投げせず、決定論的ルールで手綱を握る設計思想については【AIエージェント設計】Jevの登場で見えた「判断の切り出し」と、個人開発者が取るべき現実解をご覧ください。