Agenti: multiagentní provoz se čtyřmi rolemi a pravidla pro git

Hlavní session běží jako orchestrator bez souborových nástrojů a deleguje
na scout, implementer a reviewer. Scout zjišťuje fakta, implementer píše
veškerý kód včetně kreslicího jádra a WPF vrstvy, reviewer dělá revizi
i nezávislý build a testy. Doplněn skill upresni pro nejednoznačná zadání.
Commit až po revizi, push jen na vyžádání.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-08 06:21:41 +02:00
co-authored by Claude Opus 5
parent 1e5a552c13
commit a2a93ca155
12 changed files with 420 additions and 157 deletions
+51 -5
View File
@@ -12,7 +12,8 @@ dotnet run --project "Rozpisky\Rozpisky.csproj"
```
Baseline: build bez chyb a varování, **119 testů zelených**. Před hlášením hotovo obojí spustit
(nebo použít `/overit`).
(nebo použít `/overit`). Hlavní vlákno tyhle příkazy nespouští samo — deleguje je (viz
[Multiagentní provoz](#multiagentní-provoz)).
## Architektura — jediné pravidlo, které se nesmí porušit
@@ -72,11 +73,56 @@ zůstane plochý. Nový zapisovaný soubor = přes `UzivatelskaData.Cesta(...)`,
- `docs/SZ_SM011_P10_Manual_v6.md`, `Rozpisky/Podklady/SZ_SM011_P10_Manual_v6.pdf`
— normativní podklad SŽ, jen ke čtení.
## Delegování
## Multiagentní provoz
Specializovaní subagenti v `.claude/agents/`: `render-dxf` (Rendering/, Dxf/), `wpf-ui`
(ViewModels/, Views/, Themes/), `verifikator` (read-only build + testy). Pro úkol spadající
celý do jedné z těchto domén je použít; drobnosti napříč vrstvami řešit v hlavním vlákně.
Repo běží jako tým agentů. `.claude/settings.json` nastavuje `"agent": "orchestrator"`, takže
**hlavní session *je* orchestrátor** — má jen `Agent`, `TodoWrite`, `AskUserQuestion` a `Skill`,
žádné nástroje na soubory ani na spouštění příkazů.
| Role | Model | Nástroje | Práce |
|---|---|---|---|
| `orchestrator` (hlavní session) | Opus, high | Agent, TodoWrite, AskUserQuestion, Skill, SendUserFile | Plánuje a deleguje. **Nemá žádné souborové nástroje** (`SendUserFile` jen na cesty nahlášené subagentem). |
| `scout` | Haiku | Read, Grep, Glob | Zjišťuje fakta o kódu. Read-only. |
| `implementer` | Sonnet | Read, Write, Edit, Bash, PowerShell, Grep, Glob | Píše a edituje veškerý kód projektu. |
| `reviewer` | Sonnet, high | Read, Grep, Glob, Bash, PowerShell | Revize i nezávislý build a testy. PROŠLO / POTŘEBUJE ZMĚNY. Read-only. |
### Pravidla
- Hlavní vlákno nečte, nepíše, nehledá ani nespouští. Chceš-li se podívat do souboru, pošli
`scout`.
- **Nejdřív fakta, pak plán:** nech si od `scout` potvrdit, že soubor, metoda nebo konvence
existuje, dřív než kolem toho plánuješ.
- Veškerou implementaci dělá `implementer`. Změna přes víc vrstev (kreslicí jádro, UI, data...)
se dělí na samostatně ověřitelné kroky, ne podle domény, ale podle toho, co lze ověřit zvlášť.
- Každý prompt pro subagenta musí stát sám o sobě — absolutní cesty, úplná specifikace,
znovu vypsaná zjištění. Subagent z konverzace nevidí nic.
- Nic není hotové bez PROŠLO od `reviewer`.
- Když je požadavek nejednoznačný natolik, že dvě čtení dají jinou práci, spusť skill `upresni`.
### Ověřování
- Žádný hook build nespouští. **Ověřené je jen to, co agent skutečně spustil.**
- `implementer` končí každý úkol vlastním během buildu a testů a výsledek doslova cituje.
Dokud je build červený, úkol není hotový.
- `reviewer` si build a testy pouští **nezávisle**, hlášení implementera nebere jako důkaz.
- Orchestrátor musí požadavek na ověření napsat explicitně do každého promptu pro implementera
i revizora — subagent tahle pravidla automaticky nedědí.
## Git — kdy commit a kdy push
- **Commit:** jeden na jednu ucelenou, dokončenou a zrevidovanou změnu — ne po každé editaci
souboru a ne po každém kroku plánu. Commituje se až po zeleném buildu a testech a po `PROŠLO`
od `reviewer`. Rozdělaná práce, červený build ani „průběžný stav" se necommitují.
- Zpráva commitu je **česky**, v duchu historie repa: `Oblast: co se změnilo a proč`
(`Šrafy: rozvinout vzor na čáry místo plné výplně`). Popisuje účinek, ne seznam souborů.
- **Push jen na vyžádání.** `git push` se nespouští sám od sebe — ani po commitu, ani na konci
session. Čeká se, až o něj uživatel výslovně požádá. `git push` proto **není** a nemá být
v `permissions.allow`; každý push projde promptem.
- Když je v pracovním stromu hotová práce a session končí, orchestrátor v závěru jednou větou
řekne, co je scommitované a kolik commitů čeká na push. Nenabízí push jako akci, kterou už
provedl.
- Commit spouští subagent, který má `Bash` (typicky ten, který změnu udělal); orchestrátor
git nespouští, jen ho zadá jako samostatný krok po revizi.
## Další dokumentace