Custom applications built by a team of AI agents. A human makes the call.

# 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.

# Instrukce pro agenta-dispečera

Jsi `agent-dispecer`. Neprogramuješ. Převádíš zadání a hlášení na úkoly,
přiděluješ je a hlídáš, aby se práce nezasekla. Pracuješ jen přes GitHub.

## Vstupy
- Nové issue a komentáře s @zmínkou `agent-dispecer`.
- Hlášení od `agent-tester` (neúspěšné běhy testů).
- Štítek `blokováno` u kteréhokoli úkolu.

## Založení úkolu
1. Použij šablonu úkolu. Název: „Oblast: co je špatně“.
2. Štítky: druh (`chyba` / `funkce`), doména, `stav: nový`.
3. Přiřaď vývojáře podle domény. Nevíš-li, kterou doménu zvolit, zeptej se člověka.
4. Do komentáře napiš, co přesně ověřit, a @zmiň přiřazeného agenta.
5. Duplicitní hlášení nezakládej znovu, připoj ho komentářem k existujícímu úkolu.

## Hlídání toku
- Úkol `stav: v práci` bez nového komentáře déle než 2 hodiny: zeptej se autora.
- PR se štítkem `review` bez review déle než 1 hodinu: @zmiň `agent-reviewer`.
- Úkol `blokováno`: jde-li rozhodnout podle AGENTS.md, rozhodni a napiš proč.
  Jinak @zmiň vlastníka produktu a nech úkol ležet.
- Po zeleném testu a nasazeném náhledu vyměň štítek `test` za `čeká na schválení`
  a @zmiň vlastníka produktu jedním shrnujícím komentářem.

## Noční běh
- Večer člověk schválí frontu štítkem `noc`. Pracuje se jen na těchto úkolech
  a na chybách, které v noci najdou testy.
- Chyba z nočního testu: založ úkol se štítky `chyba`, doména, `stav: nový`, `noc`.
- Nejvýš 3 rozpracované PR najednou. Další úkoly počkají ve frontě.
- Nic nemerguj a nic nenasazuj do produkce. Náhledy nasazuje `agent-devops`.
- Když se oprava dvakrát vrátí z review nebo z testu, označ ji `blokováno`
  a nech ji na ráno.

## Ranní shrnutí (do 7:00)
Jeden komentář v úkolu noční fronty:
- co je hotové a čeká na schválení (čísla PR),
- co je blokované a proč (jedna věta, konkrétní otázka),
- co zůstalo ve frontě.

## Nikdy
- Neměň kód, testy, secrets ani nastavení repozitáře.
- Neodpovídej za člověka a neschvaluj za něj.

---
name: Úkol pro agenty
about: Zadání, které si převezme agent podle štítku své domény
title: "[oblast]: krátký popis"
labels: ["stav: nový"]
assignees: []
---

<!--
  Šablona patří do .github/ISSUE_TEMPLATE/ukol.md.
  Štítek domény (backend, frontend, ui, …) doplní dispečer nebo člověk.
  Úkol pro noční běh dostane navíc štítek „noc“. Ten schvaluje člověk.
-->

## Co se děje
<!-- Jedna až dvě věty. U chyby: co je špatně a kde. -->

## Jak zopakovat
1.
2.
3.

## Očekáváno
<!-- Jak se má aplikace chovat. Odkaz na pravidlo v AGENTS.md, pokud existuje. -->

## Hotovo, když
- [ ] test, který bez opravy selže
- [ ] CI zelená (build, unit testy, e2e)
- [ ] review od jiného agenta
- [ ] náhled nasazený, štítek `čeká na schválení`

## Omezení
<!-- Co se měnit nesmí (API, databáze, závislosti). Nepovinné. -->

## Příloha
<!-- Výstup testu, log, screenshot. Žádné osobní ani produkční údaje. -->

<!--
  Šablona patří do .github/PULL_REQUEST_TEMPLATE.md.
  Název PR podle Conventional Commits,
  např. „fix(kosik): DPH ze zaokrouhleného základu po slevě“.
-->

Opravuje #

## Co se mění
<!-- Soubory a důvod, jeden bod na změnu. -->
-

## Jak jsem to ověřil
- [ ] nový test, který bez opravy selže
- [ ] unit testy zelené
- [ ] e2e testy dotčené oblasti zelené
- [ ] náhled nasazený (odkaz doplní agent-devops v deploymentu)

## Rizika
<!-- Co se může rozbít jinde. „Žádná známá“ je platná odpověď. -->

## Kontrolní seznam
- [ ] větev `fix/<číslo>-<popis>` nebo `feat/<číslo>-<popis>`
- [ ] žádné změny secrets, závislostí ani nastavení repozitáře
- [ ] review od jiného agenta, než je autor
- [ ] štítek `čeká na schválení` až po zeleném testu a nasazeném náhledu
- [ ] schválení a merge člověkem (agenti tento bod neodškrtávají)

# Definice štítků pro repozitář s týmem AI agentů.
# Formát odpovídá běžným nástrojům pro synchronizaci štítků.
# Soubor ulož jako .github/labels.yml (bez přípony .txt).

# --- Stav úkolu: agenti si předávají práci změnou štítku ---
- name: "stav: nový"
  color: "ededed"
  description: "Úkol čeká, až si ho převezme agent své domény"
- name: "stav: v práci"
  color: "fbca04"
  description: "Agent úkol převzal a napsal plán do komentáře"
- name: "review"
  color: "1d76db"
  description: "PR čeká na review od jiného agenta"
- name: "test"
  color: "0e8a16"
  description: "Review prošlo, na řadě je agent-tester"
- name: "čeká na schválení"
  color: "8a5200"
  description: "Otestováno, náhled běží, rozhoduje člověk"
- name: "blokováno"
  color: "b60205"
  description: "Agent potřebuje rozhodnutí nebo přístup, viz poslední komentář"

# --- Druh práce ---
- name: "chyba"
  color: "d73a4a"
  description: "Něco nefunguje podle zadání"
- name: "funkce"
  color: "a2eeef"
  description: "Nová funkce nebo rozšíření"

# --- Domény: určují, který vývojář úkol převezme ---
- name: "backend"
  color: "5319e7"
  description: "Server, API, výpočty cen"
- name: "frontend"
  color: "0052cc"
  description: "Webové rozhraní a klientský kód"
- name: "ui"
  color: "d876e3"
  description: "Návrh rozhraní, texty, přístupnost"
- name: "infra"
  color: "475569"
  description: "CI, nasazení, prostředí (jen agent-devops)"

# --- Plánování ---
- name: "noc"
  color: "1f2a44"
  description: "Schváleno člověkem pro noční běh agentů"

# Vzor GitHub Actions: kontroly u každého pull requestu.
# Soubor ulož jako .github/workflows/ci.yml (bez přípony .txt).
# Názvy úloh musí sedět s povinnými kontrolami v pravidlech větve main.
name: ci

on:
  pull_request:
    branches: [main]

permissions:
  contents: read

concurrency:
  group: ci-${{ github.head_ref }}
  cancel-in-progress: true   # nový push zruší starý běh a šetří minuty

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci
      - run: npm run build

  unit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci
      - run: npm test                   # unit testy

  e2e:
    needs: build
    runs-on: ubuntu-latest
    timeout-minutes: 20
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci
      - run: npx playwright install --with-deps chromium
      # Server pro testy spouští playwright.config (sekce webServer).
      - run: npx playwright test
      # Při selhání uložíme report, aby ho agent-tester mohl přiložit k úkolu.
      - if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: playwright-report
          path: playwright-report/
          retention-days: 7

# Popis pravidel pro větev main (GitHub → Settings → Rules → Rulesets).
# GitHub tento soubor nenačte sám: nastavení zadej ručně nebo přes API.
# Měnit ho smí jen člověk s rolí správce, nikdy agent.
ruleset:
  name: ochrana-main
  target: branch
  include: ["refs/heads/main"]
  enforcement: active

  rules:
    # Nic se nezapisuje přímo do main, jen přes pull request.
    pull_request:
      required_approving_review_count: 1     # 1 schválení od člověka
      require_code_owner_review: true        # vlastníci kódu = jen lidé (CODEOWNERS)
      dismiss_stale_reviews_on_push: true    # nový commit = nové schválení
      require_last_push_approval: true       # poslední push schvaluje někdo jiný
      required_review_thread_resolution: true

    # Povinné kontroly: názvy úloh z .github/workflows/ci.yml
    required_status_checks:
      strict: true                           # větev musí být aktuální vůči main
      checks:
        - ci / build
        - ci / unit
        - ci / e2e

    non_fast_forward: true                   # zákaz force push
    deletion: true                           # main nejde smazat
    required_linear_history: true            # merge jen jako squash

  # Výjimky nemá nikdo: ani správci, ani účty agentů.
  bypass_actors: []

# Účty agentů (GitHub App nebo strojové účty) mají v repozitáři roli „Write“.
# Schválení od agent-reviewer je kontrola kvality, ale nesplní code owner review.
# Merge do main proto vždy dělá člověk.

# Vlastníci kódu. Soubor ulož jako .github/CODEOWNERS (bez přípony .txt).
# Uvádějte jen lidi nebo týmy lidí, nikdy účty agentů.
# Díky tomu pravidlo „require code owner review“ vždy vyžaduje schválení člověkem.
#
# Formát: <vzor cesty> <tým nebo účet>
# Platí poslední odpovídající řádek.

# Výchozí vlastník celého repozitáře
*                         @organizace/vlastnici-produktu

# Ceny, DPH a platby: schvalují lidé, kteří rozumí účetním pravidlům
/src/pricing/             @organizace/vlastnici-produktu @organizace/ucetni-pravidla
/src/payments/            @organizace/vlastnici-produktu @organizace/ucetni-pravidla

# Pravidla pro agenty a nastavení repozitáře mění jen správci
/AGENTS.md                @organizace/spravci
/.github/                 @organizace/spravci

# Infrastruktura a nasazení
/infra/                   @organizace/spravci