# 🎓 Antigravity 完全攻略チートシート ＆ ワークスペース全体マップ

このドキュメントは、Google Antigravity（AGY）を120%使いこなし、エージェントとの共同開発で「指示の手間を最小化し、爆速で最高品質のアウトプットを出す」ための実践マスターガイドです。

---

## ⚡ 1. `/` スラッシュコマンド完全一覧 ＆ 使い分け術

チャット入力欄で `/` を入力すると呼び出せる特殊コマンドです。用途に合わせて使い分けることで、エージェントの挙動が劇的に変わります。

| コマンド | どのような機能か？ | いつ使うべきか？（ベストなタイミング） |
| :--- | :--- | :--- |
| **`/learn`** | **エージェントに「恒久ルール」を記憶させる**<br>（今回実施した超重要コマンド） | 「⚡️絵文字は二度と使うな」「このトーンで統一して」など、**今後の新規チャットでも絶対に忘れてほしくない指示・禁止事項・好み**が出た瞬間に打つ。 |
| **`/plan`** | **着手前に「段階的ステップ計画」を立案させる** | 大きな機能追加やリファクタリングなど、いきなりコードを書き始めると危険な時に打つ。AIが事前に安全な手順書を作成して確認を求めてくる。 |
| **`/grill-me`** | **AIがユーザーを「質問攻め（インタビュー）」して仕様を詰める** | 「こういう機能が欲しいけど、デザインや細かい仕様がまだ曖昧」という時に打つ。AIが「ボタンの色は？」「モバイルはどうする？」と質問してくれ、思考を整理してくれる。 |
| **`/goal`** | **自律継続モード（徹夜作業・完全自走）** | 「このエラーが直るまで絶対に諦めるな」「100ページ全部のリンク切れを検査して修正しきるまで止めないで」という長時間の大規模タスクで打つ。 |
| **`/schedule`** | **バックグラウンド定期実行（cron）・タイマー** | 「30分後にリマインドして」「毎朝9時にデプロイ状況を監視して」というスケジュール処理をバックグラウンドに仕込む時に打つ。 |

---

## 🧩 2. Antigravity カスタマイズ（Rules vs Workflows vs Skills）完全整理

画面左メニューの「Skills & Customizations」や `.agents/` フォルダで何を設定すべきかの基準です：

```
📁 .agents / Customizations
├── 📜 Rules (AGENTS.md / rules/*.md)  ─── 「絶対に守るべき法律・制約・禁止事項」
├── 🛠️ Skills (skills/*/SKILL.md)       ─── 「特定の専門作業をやるための手順書・道具」
├── 🔄 Workflows                        ─── 「定型化された一連のマルチステップ実行手順」
└── 🧠 Active Decisions                 ─── 「直近の変更履歴や文脈を忘れないための短期記憶」
```

### ① Rules（ルール）でやるべきこと：【憲法・禁止事項】
- **特徴**: 新規チャット起動時に**100%全自動で読み込まれる**。
- **書くべき内容**:
  - `⚡️` などの絵文字ベタ書き禁止
  - アイボリー背景上の白文字禁止（コントラスト100%維持）
  - 「30秒でわかる」禁止 ⇨ 「最短23秒で完了」などのトンマナ
  - NAP情報の一字一句完全一致
  - ファイル丸ごと上書きの禁止（差分置換の徹底）

### ② Skills / Workflows でやるべきこと：【作業マニュアル】
- **特徴**: 必要なタスクの時にだけAIが引き出して使う。
- **書くべき内容**:
  - `deploy_and_log`: ビルドしてNotionに戦略ログを送る公式手順
  - `a11y-debugging`: アクセシビリティ検証の手順
  - `chrome-devtools`: ブラウザ検証の手順

---

## 🗺️ 3. プロジェクト全体マップ（エクスプローラー迷子解消ガイド）

このプロジェクトには100ページ以上のHTMLや自動生成ファイルがあり、エクスプローラーで見ると膨大に見えます。  
しかし、**実際に人間やAIが触る「核心ファイル」は全体の1割だけ**です！

```
📂 topservice-prototype/
│
├── 🌟 【最重要】人間・AIが直接編集するエリア
│   ├── 📁 src_html/               ── 静的サイトの原本HTML（ここを編集する！）
│   │   ├── index.html             ── トップページ原本
│   │   ├── fuyouhin/index.html    ── 不用品回収トップ
│   │   └── ...                    ── 各サービストップ
│   ├── 📁 templates/              ── 全ページ共通の部品（ヘッダー、フッター、見積もり等）
│   ├── 📁 css/style.css           ── メインのスタイルシート
│   └── 📁 .agents/                ── AIの頭脳（AGENTS.md, ACTIVE_DECISIONS.md）
│
├── ⚙️ 【自動化ツール】Pythonスクリプト（叩くだけでOK）
│   ├── scripts/build.py           ── 全体ビルド＆画像EXIF注入＆SEO日付更新
│   ├── scripts/notion/log_to_notion.py ── Notionとローカルメモリへの同時記録
│   └── scripts/tools/             ── 絵文字自動排除、タスクボード等の便利ツール
│
└── 🚫 【触らなくてOK】自動生成・ビルド成果物（AIが自動生成・完全放置推奨）
    ├── 📁 dist/                   ── 公開用ビルド成果物（build.pyが上書き生成）
    ├── 📁 src_html/area/          ── 自動生成された55地域のLP（スクリプトが生成）
    ├── 📁 .snapshots/             ── ワンタッチ復元用の自動バックアップ
    └── 📁 assets/drive_media/     ── 画像・動画置き場（パス参照のみ）
```

💡 **迷ったらこれだけ覚えておけばOK！**:
- ページを直したい ⇨ **`src_html/`**
- 共通ヘッダー・フッター・フォームを直したい ⇨ **`templates/`**
- AIのルールを直したい ⇨ **`.agents/`**
- 完成したら ⇨ **`python3 scripts/build.py`** を叩く！
- `dist/` や `src_html/area/` は自動生成されるので見なくてOK！

---

## 🎯 4. 俺の勉強タスク（Antigravityマスターへの道）

- [ ] **Task 1: `/learn` の仕組みを理解する**（指示がAGENTS.mdとACTIVE_DECISIONS.mdにどう残るか確認）
- [ ] **Task 2: `/grill-me` を一度試してみる**（新機能のアイデアが出た時にインタビューを受ける）
- [ ] **Task 3: プロジェクトの3大エリア（`src_html/`, `templates/`, `scripts/`）の役割を把握する**
- [ ] **Task 4: `scripts/build.py` を実行して、何が自動で動いているか（絵文字排除・EXIF注入・JSON-LD検査）を理解する**
- [ ] **Task 5: タスクボード（HTML）を使って、プロジェクト進捗と勉強状況を楽しく可視化する**