# Antigravity IDE – Rules specifikace

**Datum**: 2026-04-12
**Zdroje**: antigravity.google, ověřené příklady z codebase, community best practices

## Co jsou Rules

Pasivní omezení a standardy pro agenta. Markdown soubory v `.agent/rules/` s YAML frontmatter. Agent je načítá podle aktivačního režimu.

## YAML Frontmatter

Povinné pole: `description`
Volitelné pole: `trigger`, `globs`

## 4 aktivační režimy

### Always On (default – BEZ trigger)
```yaml
---
description: Popis pravidla
---
```
Načte se do KAŽDÉHO promptu. Nejvyšší token cost. Použít jen pro fundamentální zásady (bezpečnost, jazyk, kritické cesty). Musí být krátké.

### Model Decision
```yaml
---
trigger: model_decision
description: Přesný popis KDY se pravidlo aplikuje
---
```
Agent přečte `description` a sám rozhodne jestli načíst. Střední token cost. Použít pro kontextové rules nepotřebné v každém tasku.

### Manual
```yaml
---
trigger: manual
description: Popis pravidla
---
```
Načte se JEN když uživatel zmíní přes @mention. Žádný token cost dokud nezavoláno. Použít pro dlouhé reference, řídce potřebné instrukce.

### Glob
```yaml
---
trigger: glob
description: Popis pravidla
globs: *.py
---
```
Načte se JEN při práci se soubory matchujícími pattern. Žádný token cost dokud nematch. Použít pro framework/jazyk specifické rules.

## Limity

- 12 000 znaků na soubor
- Může existovat limit na počet aktivně zpracovávaných rule souborů

## Description best practices

- Piš CO rule dělá a KDY se má aktivovat
- Buď specifický – zmiň konkrétní triggery (soubory, akce, situace)
- Max 1-2 věty
- ŠPATNĚ: "Security rules"
- SPRÁVNĚ: "File protection — NEVER overwrite, delete or restore production files without explicit user permission"

## Obsah rules – best practices

### Co patří do rule
- Krátké, jasné zásady v odrážkách
- "Co dělat" a "co NEDĚLAT"
- Konkrétní příklady chyb a správného chování
- Cesty k souborům (pokud Always On)
- Odkazy na skills pro detaily ("viz skill X")
- Piš WHY – agent lépe rozhoduje v edge cases

### Co NEPATŘÍ do rule
- Detailní postupy krok za krokem (→ workflow)
- Referenční tabulky s desítkami řádků (→ skill)
- Encyklopedický obsah (→ skill)
- Duplikace obsahu ze skills
- Věci které LLM už zná (samozřejmosti)

## Formátování

- Psát anglicky pro lepší LLM comprehension
- Základní markdown pouze – žádné dekorativní tabulky, ASCII art
- Jeden soubor = jedna oblast (Single Responsibility)

## Správa

### Přes UI
1. Agent panel → `...` → Customizations → Rules
2. `+ Workspace` pro nový rule
3. UI umožňuje nastavit Activation Mode dropdownem

### Přes soubory
1. Vytvořit `.md` v `.agent/rules/`
2. YAML frontmatter s `description` (povinné) a `trigger` (volitelné)
3. Napsat obsah

## Anti-patterns

- Always On rules s 50+ řádky = context waste
- Cpát detailní postupy do rules = "prompt sludge"
- Vágní description = špatný matching pro Model Decision
- Duplikovat skill obsah v rules = dvojitý context cost
