# .agents/ フォルダについて

このフォルダには、Antigravity のワークスペースルールが入っています。

**本日のハンズオンで、その場で効くのはこちらです。** Antigravity で `0826_handson` フォルダを開いた時点で、このフォルダのルールが読み込まれます。受講者の皆さまが Antigravity へ修正や機能追加を指示すると、ここに書かれた内容が前提として毎回適用されます。

---

## 中身

| ファイル | 書いている内容 |
| --- | --- |
| `rules/01_単一HTMLの制約.md` | 外部ライブラリを足さない、1ファイルで完結させる、既存のコードを壊さない |
| `rules/02_日本語で答える.md` | 応答・コメント・UI文言をすべて日本語にする、専門用語に補足を付ける |
| `rules/03_変更の進め方.md` | まとめて直す、直す前に一言述べる、最後に動作確認の手順を示す |

---

## なぜ効くのか

Antigravity には、毎回の指示に先立って読み込まれるルールの仕組みがあります。ワークスペースのルールは `.agents/rules/` フォルダの Markdown ファイルとして置きます。1ファイルあたり12,000文字までという上限があるため、内容をテーマごとに3つに分けています。

このルールがないと、たとえば「表の見た目を整えて」と頼んだだけで外部のCSSライブラリを読み込む提案が返ってくることがあります。単一HTMLで完結させたい今回の題材では困ります。あらかじめ制約を書いておくことで、毎回の指示に「外部ライブラリは使わないでください」と書き添える手間がなくなります。

---

## 有効化の方式

各ルールファイルの1行目に、想定している有効化方式を書いています。Antigravity では次の4つから選べます。

| 方式 | 動き |
| --- | --- |
| Always On | 常に適用されます |
| Manual | チャット入力欄でそのルールを指定したときだけ適用されます |
| Model Decision | ルールの説明文を読んで、適用するかどうかをモデルが判断します |
| Glob | 指定したファイルのパターンに当てはまるファイルを扱うときだけ適用されます |

本フォルダの3ファイルは、01と02を Always On、03を Model Decision として想定しています。

---

## 持ち帰って使うときに

ご自身の業務で Antigravity を使う場合は、次のように置き換えると効果が出やすくなります。

1. 自分が毎回同じことを指示していると気づいたら、その一文をルールに移します。指示のたびに書いている注意書きが、ルールに移す最初の候補です。
2. ルールは1ファイルに詰め込まず、テーマで分けます。あとから探しやすく、不要になったときに外しやすくなります。
3. 会社ごと・案件ごとにルールを変える場合は、ワークスペース（プロジェクトのフォルダ）ごとに `.agents/rules/` を置きます。どの案件でも共通の内容は、個人設定のグローバルルール `~/.gemini/GEMINI.md` に置きます。
4. うまくいかないときは、ルールを増やす前に既存のルールが長すぎないかを見てください。全部が重要だと書かれていると、どれも効かなくなります。

---

## 補足

`.agents/rules/` は現在の書き方です。以前の `.agent/rules`（フォルダ名が単数形）も引き続き読み込まれます。他の資料で単数形の記載を見かけた場合は、同じものを指していると考えてください。
