Rules — praxe

AGENTS.md, CLAUDE.md, obdobné soubory

• + Nemusíte znovu vysvětlovat konvence v každém chatu; sdílený onboarding po clone
• + AGENTS.md se prosazuje jako společný formát napříč nástroji (Claude Code, Cursor, Codex CLI…)
• − Každý řádek jde do kontextu — příliš dlouhý soubor žere tokeny a hůř se udržuje
• − Někdy duplicita AGENTS.md + CLAUDE.md + vendor rules — riziko rozjezdů
• − Agent pravidla občas přehlédne; zastaralá pravidla = špatné návyky
• → Krátce a úderně; stack, příkazy build/test/lint; proč ne jen zákaz; u velkého monorepa pravidla po složkách; udržovat jednu kanonickou verzi (sync / symlink)

Co v rules, co ve skills

Rozdělení odpovědnosti

• Vlastní skill na celý workflow — orchestrace žije ve skillu; v rules nech jen vyvolání toho skillu a odchylky pro konkrétní projekt (stack, cesty, výjimky)
• Žádný takový skill — celou orchestraci (pořadí skillů, kdy agent, kdy checkpoint) musíš mít popsanou v rules / AGENTS.md (nebo v projektové docs), jinak to agent neudrží konzistentně

MCP — typické příklady

Co často napojuješ

• Dokumentace — knihovny, interní wiki, „fetch docs“ (např. Context7, vlastní index)
• Issue tracker — Jira, Linear, GitHub Issues / PR přehled bez kopírování z UI
• Git — stav větve, diff, historie commitů (read-only nástroje)
• DB / API — řízený dotaz nebo schéma; ne hrubý shell s heslem
• Souborový systém — čtení projektu v mezích pravidel (ne celý disk)
• Prohlížeč / fetch — ověření URL, screenshot, test endpointu (kde to dává smysl)
• Connectors — hotové remote MCP od Anthropicu/partnerů (Google Drive, Slack, GitHub…); OAuth, fungují i na webu a mobilu bez lokální instalace

Úkol 4

~20 min

• Přidejte implementační skill — vezme výstup z plánovacího skillu a realizuje jej (ideálně podle nějaké metodiky)
• Vše propojte, ať to jde po sobě

Úkol 5

~15 min

• Přidejte code review skill a zařiďte, aby se po jeho připomínkách vrátili zpět k implementačnímu skillu, který je opraví

Úkol 7

~20 min

• Upravte generování plánu, aby rozsekalo plán na malé tasky (max 5 minut na task) a psalo závislosti mezi tasky
• Zařiďte, aby se implementace pouštěla v paralelních agentech

Co dál?

• Vyřešit git workflow
• Review v každém kroku — i u specky, i u plánu (ne jen u kódu)
• Validační agenti, kteří zajistí dodržení základních pravidel (security, a11y, kvalita architektury, atd.)
• Doladit každého agenta
• Zabalit a distribuovat (plugin)

Kopírujte!

• Superpowers
• BMAD
• Spec-kit
• OpenSpec
• AI-DLC

Kontext

• Umíme orchestrovat a stavět workflows — to je jen polovina
• Druhou polovinou je budování kontextu
• AI může všechno rozbít — kontext určuje správný směr
• Cíl: živý „second brain“ v repozitáři — AI čte kontext před každou prací

Úkol 9

Kontext · ~10 min

• Vytvořte agenta, který dokáže kontext načíst a předhodit ho ostatním agentům — klidně jim to vnucujte, aby si ho načítaly

Úkol 10

Kontext · ~10 min

• Vytvořte agenta, který aktualizuje kontext na základě právě provedených úprav, a zařaďte ho do svého workflow

Shrnutí

• 4-krokové workflow: Spec → Plán → Implementace → Review
• V každém kroku automatická oponentura — AI ověřuje svou vlastní práci před tím, než pokračuje dál
• Živá knowledge base v repozitáři — kontext, pravidla a rozhodnutí, která AI vždy přečte před prací

TDD s AI — proč

Test je jediná pravda, kterou si agent nemůže vyložit

• AI je rychlá, ale ne přesná — test je executable spec, ne dobrá vůle
• Bez testů agent rád lže: „hotovo“ znamená nedokázané. Se zelenými testy = hotovo
• Red → Green → Refactor dává agentovi okamžitou zpětnou vazbu po každém kroku — místo tázat se vás
• Test napsaný před kódem chrání proti over-engineeringu (agent píše jen tolik kódu, kolik test vyžaduje)

TDD s AI — praxe v Claude Code

• Skill na TDD workflow: agent musí nejdřív napsat failing test, teprve pak smí editovat implementaci
• Hook po každém Edit spustí relevantní testy a vrátí výstup do kontextu — agent vidí, co rozbil
• Validační agent kontroluje, že testy testují chování, ne implementaci (proti mock-heavy slop) — viz pillar testing-correctness-lead
• Verification skill před „hotovo“: čerstvě spustit testy, přečíst výstup, ne věřit cache
• Continuous runner (--watch) jako další vstup do kontextu při delších úlohách

Prototypování přes Claude — proč

Z briefu rovnou na klikací prototyp, bez závazku k produkci

• Místo cesty brief → Figma → kód: rovnou interaktivní prototyp v Reactu / HTML, který klient klikne
• Rychlá validace UX a flow v hodinách, ne dnech — bez závazku k finálnímu stacku
• Multi-modal: nahrajete screenshot, sketch, Figma snímek — Claude čte layout a typografii
• Prototyp jako spec pro reálnou implementaci — funkční referenční chování pro tým

Prototypování přes Claude — praxe

• Artifacts / claude.ai Apps — single-file prototypy bez setupu; sdílíte URL, klient si klikne
• Skill web-artifacts-builder — React + Tailwind + shadcn/ui pro komplexnější vícekomponentové prototypy
• Playwright MCP + screenshoty → agent vidí, co vyrobil, opravuje sám layout a překryvy
• Loop: prototyp → screenshot/komentář → další iterace; rychleji než ruční QA
• Anti-pattern: prototyp ≠ produkce. Když dozraje, přepíše se v cílovém stacku přes plnou orchestraci (spec → plán → impl → review)

Sandboxing běhu agentů

Co všechno smí Claude Code udělat na vašem disku

• Permission modes: default (ptá se) · acceptEdits · plan · bypassPermissions — to poslední jen v izolaci
• Devcontainer — agent vidí jen mountnutý projekt, ne celý home; bezpečný bypassPermissions pro autonomní běh
• Claude Code on web — managed VM v cloudu; ideální pro fire-and-forget tasky a CI integraci
• Hooks jako poslední pojistka — PreToolUse blokuje rizikové příkazy (např. push na main) i v autonomním režimu
• Zlaté pravidlo: mimo sandbox žádný --dangerously-skip-permissions — pohodlí dnes, supply-chain incident zítra

Cost & cache hygiena

Proč některé session stojí 5× víc než jiné

• Prompt cache TTL ~5 min — drž session aktivní; každý cold start přepočítává celý prefix znovu
• CLAUDE.md = každý token každý turn. Drž stručné (< ~150 řádků), detaily deleguj do docs/ přes odkazy
• /compact vs. /clear — compact zachová podstatu, clear restart. Nepřepínej model uprostřed (cache je per-model)
• Subagenti = izolovaný kontext → neplatíš hlavním session za jejich práci; ideální pro objemné rešerše
• Sleduj usage v UI; opakující se drahý task patří do headless / SDK mimo interaktivní session

Worktrees + paralelní agenti

Rozšíření Úkolu 7 — jak to v praxi nepadá

• Jedna branch / jeden agent. Více agentů na stejném HEAD = konflikty checkoutu, přepsané soubory, ztracená práce
• git worktree add ../proj-task-42 -b feature/task-42 — nová cesta, sdílený repo, izolovaný HEAD; agent má vlastní pískoviště
• V Agent SDK / Claude Code: parametr isolation: "worktree" založí worktree automaticky a po dokončení uklidí, pokud nic nezměnil
• Orchestrátor spawnuje agenty paralelně podle závislostí v plánu, sbírá výstupy a otevírá draft PR za každý hotový task
• Review zůstává sériový. Paralelizujte výrobu, ne kontrolu — jinak se vám PR queue stane novým bottleneckem