# Antigravity IDE – Workflows specifikace

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

## Co jsou Workflows

Strukturované sekvence kroků spouštěné uživatelem přes slash command. Markdown soubory v `.agent/workflows/`.

## YAML Frontmatter

Povinné pole: `description`

```yaml
---
description: Akční popis co workflow dělá
---
```

### description pravidla
- Specifický, akční popis
- ŠPATNĚ: "Deployment"
- SPRÁVNĚ: "Deploy current branch to staging using Docker"
- Agent ho používá pro sémantický matching

## Slash commands

- Filename = slash command: `deploy.md` → `/deploy`
- `create-component.md` → `/create-component`
- Naming: lowercase, hyphens, descriptive

## Limity

- 12 000 znaků na soubor

## Turbo anotace

### `// turbo` (nad jedním krokem)
```markdown
3. **Run tests**
   // turbo
   - `npm test`
```
Auto-run jen TOHOTO jednoho `run_command` kroku bez žádání o schválení.

### `// turbo-all` (kdekoliv v souboru)
```markdown
// turbo-all

1. **Install dependencies**
   - `npm install`
```
Auto-run VŠECH `run_command` kroků v celém workflow.

### Safety pravidla
- Jen pro bezpečné, idempotentní, nedestruktivní operace
- NIKDY pro: `rm`, `chmod`, `sudo`, systémové mutace, instalace
- Preferuj `// turbo` na konkrétních krocích nad `// turbo-all`
- `// turbo-all` jen pro plně trusted setup/maintenance skripty

## Chaining

Workflows mohou volat jiné workflows z instrukcí:
```
After completing, call `/run-linting` and then `/deploy-staging`.
```

## Struktura obsahu

```markdown
---
description: What this workflow does
---

# /name – Title

## Steps

1. **Step name**
   - Instructions
   - `command to run`

2. **Step name**
   // turbo
   - `safe command to auto-run`
```

## Content guidelines

- Psát anglicky pro lepší LLM comprehension
- Číslované kroky sekvenčně – každý krok má tučný název
- Instrukce v odrážkách pod krokem
- Příkazy v code blocks
- Vždy zahrnout finální validační krok
- Dokumentovat předpoklady (required tools, file structures)
- Odkazovat na skills místo kopírování obsahu
- Atomické kroky – malé, nezávisle ověřitelné

## Správa

### Přes UI
1. Agent panel → `...` → Customizations → Workflows
2. `+ Global` nebo `+ Workspace`
3. Přidat description a kroky

### Přes soubory
1. Vytvořit `.md` v `.agent/workflows/`
2. YAML frontmatter s `description`
3. Číslované kroky v markdown

## Anti-patterns

- Workflow co jen říká "přečti skill" bez přidaného procesu = zbytečný soubor
- Kopírování obsahu skills místo odkazování
- Chybějící validační krok
- `// turbo-all` na workflows s destruktivními příkazy
