# Antigravity IDE – .agent složka

**Datum**: 2026-04-12
**Zdroje**: antigravity.google, agentskills.io, community best practices

## Co je .agent/

Konfigurační složka v kořeni workspace pro customizaci AI agenta v Antigravity IDE. Obsahuje 3 typy souborů: Rules, Skills, Workflows.

## Struktura

```
<workspace-root>/
└── .agent/
    ├── rules/                    # Pasivní omezení, guardrails
    │   └── *.md                  # Markdown s YAML frontmatter
    ├── skills/                   # On-demand znalostní balíčky
    │   └── <skill-name>/         # Každý skill = vlastní složka
    │       ├── SKILL.md          # POVINNÝ soubor
    │       ├── scripts/          # Volitelné – executable kód
    │       ├── references/       # Volitelné – docs on demand
    │       └── assets/           # Volitelné – šablony, schémata
    └── workflows/                # User-triggered sekvence kroků
        └── *.md                  # Markdown s YAML frontmatter
```

Globální skills: `~/.gemini/antigravity/skills/`

## 3 typy – role a aktivace

**Rules** – pasivní omezení/standardy pro agenta
- 4 aktivační režimy: Always On, Model Decision, Manual, Glob
- Token cost závisí na trigger režimu
- Detaily: viz `antigravity-rules.md`

**Skills** – modulární balíčky znalostí načítané on-demand
- Progressive disclosure: agent čte metadata při startu, plný obsah jen když potřeba
- Token cost: jen když aktivováno
- Detaily: viz `antigravity-skills.md`

**Workflows** – strukturované sekvence kroků spouštěné uživatelem
- Trigger: slash command `/filename`
- Token cost: jen při spuštění
- Detaily: viz `antigravity-workflows.md`

## Progressive disclosure princip

Klíčový mechanismus pro token optimizaci:

1. **Discovery (~100 tokenů/soubor)**: Agent čte POUZE `name` + `description` z YAML frontmatter
2. **Activation (< 5000 tokenů)**: Agent čte celý obsah jen když task matchuje
3. **Deep context (dle potřeby)**: Agent čte scripts/, references/, assets/ jen když instrukce říkají

`description` = LLM search index pro routing. Musí být přesný a specifický.

## Rozhodovací strom

```
"Je tohle vždy platné?"
  → ANO → RULE (krátké, stručné)
  → NE → "Potřebuji to jen občas pro specifický úkol?"
           → ANO → SKILL (detailní know-how)
           → NE → "Je to opakovaný multi-step proces?"
                    → ANO → WORKFLOW (číslované kroky)
                    → NE → Nepotřebuješ .agent soubor
```

## Limity

- Rules: 12 000 znaků/soubor
- Skills: SKILL.md body < 5000 tokenů doporučeno; name 1-64 chars; description 1-1024 chars
- Workflows: 12 000 znaků/soubor

## Klíčové zásady

- Každá informace na PŘESNĚ jednom místě – žádné duplikace
- Rules odkazují na skills pro detaily
- Workflows odkazují na skills místo kopírování
- Description je klíčový pro matching – psát specificky, akčně
- Psát anglicky pro lepší LLM comprehension
- Základní markdown – žádné dekorativní tabulky, ASCII art
