# AGENTS.md

Pravidla pro všechny AI agenty v tomto repozitáři. Přečti je před každým úkolem.
Agenti spolu mluví jen přes GitHub: štítky, komentáře, review a @zmínky. Chat se nepočítá.

## Převzetí úkolu
- Ber jen issue se štítkem své domény (`backend`, `frontend`, `ui`, …) a `stav: nový`.
- Při převzetí vyměň štítek `stav: nový` za `stav: v práci` a napiš komentář
  „Beru.“ s krátkým plánem (2–4 body).
- Na jednom úkolu pracuje jeden agent. Má-li issue přiřazeného někoho jiného, neber ho.

## Větve a commity
- Jedna větev na úkol: `fix/<číslo>-<popis>` nebo `feat/<číslo>-<popis>`,
  např. `fix/251-dph-sleva`.
- Commity podle Conventional Commits: `fix(kosik): …`, `test(kosik): …`.
- Nikdy nepiš přímo do `main` a nepoužívej force push na cizí větve.

## Pull request
- Popis podle šablony PR, vždy s řádkem „Opravuje #číslo“.
- O review požádej až při zelené CI: štítek `review` a žádost o review
  pro `agent-reviewer`.
- Review dělá vždy jiný agent, než který kód napsal. Vlastní PR neschvaluj.
- Po „Changes requested“ oprav, pushni a odpověz komentářem s @zmínkou reviewera.

## Testy
- Každá oprava chyby má test, který bez opravy selže.
- Po schválení reviewerem převezme PR `agent-tester` (štítek `test`).
- Tester ověří přesně případ z úkolu a pak celou sadu dané oblasti.

## Merge a produkce
- Do `main` nikdy nemerguj. Merge dělá jen člověk po vlastním schválení.
- Hotový PR označ štítkem `čeká na schválení` a @zmiň vlastníka produktu.
- `agent-devops` nasazuje jen náhledy. Produkce se nasazuje až po merge.

## Když si nevíš rady
- Rozpor v zadání, obchodní rozhodnutí nebo chybějící přístup:
  štítek `blokováno`, komentář s konkrétní otázkou a @zmínka `agent-dispecer`.
- Pak pokračuj jiným úkolem. Nečekej a nehádej.
- Po dvou neúspěšných pokusech o stejnou opravu přestaň a nahlas `blokováno`.

## Noční režim (štítek `noc`)
- V noci ber jen úkoly se štítkem `noc`, které večer schválil člověk,
  a chyby, které v noci najdou testy.
- Žádné změny závislostí, databázových schémat ani infrastruktury.
- Nejvýš 3 otevřené PR najednou a nejvýš 5 běhů CI na jeden PR.
- Ráno musí mít každý úkol jasný stav: štítek a poslední komentář.

## Zakázáno
- Měnit secrets, nastavení repozitáře, pravidla větví a CODEOWNERS.
- Sahat na produkční data.
- Vypínat nebo přeskakovat testy, aby CI prošla.