---
title: "Dluh v porozumění kódu u AI agentů"
description: "Dluh v porozumění kódu vzniká tiše, když schvalujete, čemu nerozumíte. Zjistěte, jak nastavit verifikační smyčku a udržet kontrolu nad kódem od AI agentů."
author: "Michal Černý"
author_role: "Spoluzakladatel · Technology & Product"
author_url: https://nobig.deals/cs/blog/autor/michal-cerny
url: https://nobig.deals/cs/blog/dluh-v-porozumeni-kodu-ai-agenti
content_type: text/markdown
---

Autor: Michal Černý (Spoluzakladatel · Technology & Product)

[Blog](https://nobig.deals/cs/blog)/[AI a vývoj](https://nobig.deals/cs/blog/kategorie/ai-a-vyvoj)/Dluh v porozumění kódu: jak ho ustát, kd…

# Dluh v porozumění kódu: jak ho ustát, když kód píše AI agent

Kontrolu nad kódem od AI agenta udržíte, když zůstanete vlastníkem vnější smyčky: sami určíte cíl, definujete důkazy a schvalujete výsledek. Nemusíte číst každý řádek, ale musíte vědět, co testy nedokazují.

[Michal Černý](https://nobig.deals/cs/blog/autor/michal-cerny)·Publikováno 5\. listopadu 2026·10 min čtení

![Dvě postavy zezadu stojí u stolu, na kterém leží tlustý pořadač s vyčnívajícím oranžovým listem.](https://nobig.deals/_next/image?url=https%3A%2F%2Fassets.nobig.deals%2Fblog%2Fcmw2pypy202s60xpgfm98b6eh%2Fdluh-v-porozumeni-kodu-ai-agenti-hero-dcab42c805.webp&w=3840&q=75)

Schválit změnu znamená převzít ji i s porozuměním.

Obsah článku · 7
1. [Co je dluh v porozumění kódu a jak vzniká?](#co-je-dluh-v-porozumeni-kodu-a-jak-vznika)
2. [Od delegování ke kognitivní kapitulaci](#od-delegovani-ke-kognitivni-kapitulaci)
3. [Test vlastnictví: umíte to vysvětlit?](#test-vlastnictvi-umite-to-vysvetlit)
4. [Paradox dohledu a atrofie dovedností](#paradox-dohledu-a-atrofie-dovednosti)
5. [Proč nestačí, že testy prošly](#proc-nestaci-ze-testy-prosly)
6. [Jak nastavit verifikační smyčku pro AI agenta](#jak-nastavit-verifikacni-smycku-pro-ai-agenta)
7. [Postup krok za krokem](#postup-krok-za-krokem)
8. [Co hlídat u zadání](#co-hlidat-u-zadani)
9. [Jak dluh v porozumění v týmu měřit a omezovat](#jak-dluh-v-porozumeni-v-tymu-merit-a-omezovat)
10. [Kdy plná autonomie nestojí za to a kdo ručí](#kdy-plna-autonomie-nestoji-za-to-a-kdo-ruci)
11. [Časté otázky](#caste-otazky)

Kontrolu nad kódem od AI agenta si udržíte tak, že zadání, definici důkazu a konečné schválení necháte u člověka. Agentovi svěříte jen práci uvnitř smyčky. Postup: vlastní hypotéza, malé kroky, testy schvalované zvlášť a review zaměřené na to, co testy nedokazují. Jinak roste dluh v porozumění kódu.

Ve zkratce

* Dluh v porozumění kódu (comprehension debt) vzniká v okamžicích, kdy schválíme změnu bez pochopení rozhodnutí, která agent udělal.
* Zelené testy nestačí, protože test může obsahovat stejnou chybu jako funkce. Agent je navíc umí upravit podle implementace.
* Rozlišujeme delegování, odkládání kontroly a kognitivní kapitulaci. Hranici určuje, zda umíme výstup vysvětlit.
* Verifikační smyčka stojí na vlastní hypotéze, malých krocích, samostatném schvalování testů a hmatatelném kritériu „hotovo“.
* Odpovědnost za kód v produkci zůstává vždy na člověku, i když agent dělá práci i část auditu.

## Co je dluh v porozumění kódu a jak vzniká?

Dluh v porozumění vzniká, když tým přijímá kód rychleji, než stihne pochopit rozhodnutí, předpoklady a důsledky, které v něm agent zanechal.

Definice

Dluh v porozumění kódu (_comprehension debt_) je rozdíl mezi tím, co systém skutečně dělá, a tím, čemu z toho tým rozumí a co dokáže vysvětlit.

Pojem razil Jeremy Twei. Addy Osmani ho [rozpracoval pro kód psaný agenty](https://addyosmani.com/blog/comprehension-debt/). Podle něj agent vytváří a mění kód rychle, ale člověk nestíhá průběžně chápat, proč je napsaný právě takto. Příbuzný jev v týmech popisuje Margaret-Anne Storey jako kognitivní dluh. Tým postupně ztrácí sdílenou teorii systému, tedy společnou představu o tom, jak a proč systém funguje.

Zrádné je, že v okamžiku vzniku tento dluh nikdo nevidí. Kódová báze vypadá čistě, testy procházejí a build je zelený. **Problém se ukáže až při další změně**, kdy tým zjistí, že systému nikdo nerozumí. Osmani zároveň upozorňuje, že tento dluh jde splácet. Úplný mentální model velké kódové báze nedrží v hlavě nikdo. Stačí umět ho lokálně obnovit a vědět, co vám chybí.

Příklad

Agent odevzdá pull request o 600 řádcích. Recenzent projde strukturu, názvy proměnných vypadají rozumně a testy procházejí, takže změnu schválí. Uprostřed diffu ale leží drobná změna pořadí uvnitř hranice transakce nebo obrácená výchozí hodnota u okrajového případu. Review proběhlo, jenže našlo jen to, co recenzent čekal.

## Od delegování ke kognitivní kapitulaci

Delegovat práci na agenta je v pořádku. Problém nastává, když s úkolem nevědomky předáte i úsudek. Osmani popisuje tři stavy jako spektrum. Pojem **kognitivní kapitulace** (_cognitive surrender_) převzal od Stevena Shawa a Gideona Naveho z Whartonu.

| Stav                      | Co se děje                                                   | Kdo vlastní výsledek        |
| ------------------------- | ------------------------------------------------------------ | --------------------------- |
| Delegování (_offloading_) | Úkol předáte agentovi, výsledek kontrolujete                 | Vy                          |
| Odkládání (_deferral_)    | Výstup agenta se stává vaším vstupem, přestává být hypotézou | Formálně vy, fakticky nikdo |
| Kapitulace (_surrender_)  | Výstup se tiše stane vaším, potřebu kontroly necítíte        | Agent                       |

Rozlišení tří stavů popisuje Addy Osmani, který na ně navazuje i v [textu o dluhu v porozumění](https://addyosmani.com/blog/comprehension-debt/).

Posun dolů po spektru je pozvolný a každý jeho krok působí rozumně. Poslední odpověď byla dobrá, takže další jen přelétnete. U třetí už sledujete jen kostru. Pak se vás někdo zeptá na konkrétní řádek a vy ho nedokážete vysvětlit ani s pomocí agenta. Osmani doporučuje jednoduché pravidlo: kde je omyl levný, delegujte celé. **Kde nesou následky jiní**, tedy u rozhodnutí, co stavět, co ovlivní uživatele a zda je bezpečné nasadit, si úvahu nechte u sebe.

### Test vlastnictví: umíte to vysvětlit?

Ano, pokud dokážete vysvětlit, co změna dělá a proč, třeba i s pomocí agenta. Když to nedokážete, vlastnictví jste ztratili. Praktický příklad, jak ověřovat výstupy více agentů, ukazuje náš popis toho, jak postavit [tým agentů v Claude Code](https://nobig.deals/cs/blog/ai-agenti-backtesting-claude-code).

Poznámka

Tým Claude Code ve společnosti Anthropic podle Osmaniho veřejně uvádí, že porozumění obnovuje na požádání. Když potřebuje pochopit část systému, nechá si od Clauda vysvětlit právě tento výsek. Jde o postup cizího týmu. Funguje jen tam, kde lidé vědí, na co se ptát.

### Paradox dohledu a atrofie dovedností

Čím rychleji agent generuje změny, tím víc by měl člověk kontrolovat. Stejná rychlost ale zvětšuje objem výstupu nad kapacitu review. Osmani tomu říká _orchestration tax_. Je to rozdíl mezi tím, co agenti vyprodukují, a tím, pod co jste ochotni se podepsat.

Druhé riziko je pomalejší: přestanete trénovat dovednosti, které jste dřív používali denně. Riziko atrofie dovedností řeší i novější preprinty na arXivu ([2605.01160](https://arxiv.org/html/2605.01160), [2607.06101](https://arxiv.org/html/2607.06101v1)). Jejich závěry zatím nejsou ustáleným konsenzem. Doporučujeme položit si Osmaniho otázku: co už necvičím? Část rutinního ladění klidně pusťte, ale vědomě.

## Proč nestačí, že testy prošly

Zelená značka dokládá jednu vlastnost, ne správnost celku. Pokud test vznikl se stejnou chybou jako funkce, projde. Agenti navíc psaní testů tak zlevnili, že zelené značky přibývají rychleji, než roste jejich výpovědní hodnota.

Osmani [upozorňuje](https://addyosmani.com/blog/comprehension-debt/) na horší scénář. Agent může změnit implementaci a zároveň přepsat stovky testů, aby odpovídaly novému chování. Prošlé testy pak dokazují jen **konzistenci kódu s upravenými testy**, ne původní záměr. Úzkým hrdlem proto už není psaní kódu, ale jistota, že je správně.

Empirická data tento vzorec potvrzují. [Studie publikovaná v ACM](https://dl.acm.org/doi/10.1145/3805689.3812402) vychází z rozhovorů se zkušenými vývojáři. Popisuje čtyři formy dohledu nad agenty: kontrolu předem, společné plánování, monitorování v reálném čase a následnou kontrolu. Zároveň zjistila, že vývojáři berou výsledky testů jako záruku správnosti, i když testy mohou stát na stejných chybných předpokladech jako implementace.

Klíčová čísla

* **17** zkušených vývojářů dotazovala studie o formách dohledu ([ACM](https://dl.acm.org/doi/10.1145/3805689.3812402))
* **4** formy dohledu nad agenty studie identifikovala ([ACM](https://dl.acm.org/doi/10.1145/3805689.3812402))
* **50 %** v testu porozumění u inženýrů pracujících s AI ([Osmani](https://addyosmani.com/blog/comprehension-debt/))
* **67 %** v témže testu u kontrolní skupiny bez AI ([Osmani](https://addyosmani.com/blog/comprehension-debt/))

Údaj 50 % proti 67 %, který [Osmani cituje](https://addyosmani.com/blog/comprehension-debt/), je třeba číst opatrně. Pochází ze sekundárních zdrojů a plná metodika studie, včetně velikosti vzorku, není z citací zřejmá. Jde o rozdíl 17 procentních bodů podle [stejného textu](https://addyosmani.com/blog/comprehension-debt/), ne o relativní pokles. Bereme ho jako signál, ne jako změřený zákon.

Pozor

Nejčastější past je agent, který při selhání testu „opraví“ test místo kódu. V diffu to vypadá jako běžná úprava. Ve skutečnosti se tím změnila specifikace a nikdo ji neschválil.

## Jak nastavit verifikační smyčku pro AI agenta

Verifikační smyčka funguje, když člověk předem určí, co znamená „ověřeno“, a agent nesmí být jediným zdrojem implementace i důkazu. Podle [dokumentace Claude Code](https://code.claude.com/docs/en/how-claude-code-works) agent opakovaně prochází fázemi získání kontextu, provedení akce a ověření výsledků. Osmani cituje Borise Chernyho z týmu Claude Code: dejte agentovi způsob, jak ověřit vlastní práci. Místo čtení každého řádku pak stavíte smyčky a posuzujete důkazy.

### Postup krok za krokem

Postup

1. **Sepište vlastní hypotézu.** Ještě před spuštěním si zapište očekávané řešení a rizika. Když nemáte vodítko, požádejte o _blind spot pass_ podle Thariqa Shihipara: model dostane, co víte, a hledá, co nevíte.
2. **Definujte „hotovo“ předem.** Stanovte hmatatelný cíl, například konkrétní prošlý test, screenshot, log nebo trace. Zpětně byste si obhájili jakýkoli výsledek.
3. **Rozdělte práci na malé kroky.** Dlouhý běh nahraďte několika kontrolovatelnými úseky se stop podmínkou.
4. **Schvalujte změny testů zvlášť.** Agent nesmí upravovat testy podle implementace. Každá změna očekávání potřebuje zdůvodnění a samostatné schválení.
5. **Ověřte citlivost testů.** Mutační testování ukáže, zda testy selžou při úmyslně vnesené chybě. Samotné pokrytí řádků to neprozradí.
6. **Čtěte nejdřív důkaz.** Po dokončení zkontrolujte spuštěný příkaz a jeho výstup. Shrnutí agenta čtěte až potom.

Krok 4 jde vynutit i technicky. Následující git hook odmítne commit, který současně mění implementaci i testy. Agent tak musí změnu testů předložit odděleně, kde ji člověk vidí.

```bash
#!/usr/bin/env bash
# .git/hooks/pre-commit – testy a implementace nesmí být v jednom commitu,
# aby změna očekávání nezapadla v diffu implementace
staged=$(git diff --cached --name-only)
tests=$(echo "$staged" | grep -E '(^tests/|\.(test|spec)\.ts$)' || true)
impl=$(echo "$staged" | grep -E '^src/' | grep -vE '\.(test|spec)\.ts$' || true)

if [[ -n "$tests" && -n "$impl" ]]; then
  echo "Změny testů dejte do samostatného commitu se zdůvodněním."
  echo "Dotčené testy:"
  echo "$tests"
  exit 1
fi
```

### Co hlídat u zadání

Kvalita zadání odráží, jak dobře problému rozumíte. Kolega by vágní požadavek zpochybnil. Agent mezery doplní sám a vrátí něco, co vypadá hotově. Do zadání proto patří rozsah souborů, věci mimo rozsah, invarianty, které se nesmí změnit, příkazy pro ověření a podmínka, kdy se má agent zastavit. Typicky jde o změnu veřejného API, databázového schématu nebo oprávnění.

Pozor i na řetězení agentů. Každý další agent snadno dostane jen shrnutí od předchozího a originál nikdo nečte. Kdy dává smysl jeden agent a kdy více specializovaných, rozebíráme v článku o tom, jak volit mezi přístupy [single agent loop a subagenti](https://nobig.deals/cs/blog/single-agent-loop-kdy-nahradit-subagenty).

Tip

Před sloučením požádejte agenta, ať vypíše všechna rozhodnutí a předpoklady, které udělal: výchozí hodnoty, co vynechal a který požadavek si vyložil jinak. V souhrnu typu „vše proběhlo v pořádku“ tyto informace nenajdete.

## Jak dluh v porozumění v týmu měřit a omezovat

Standardní metrika pro dluh v porozumění neexistuje. Týmy proto kombinují nepřímé ukazatele technické kvality a schopnosti lidí změnu vysvětlit. Jednotlivě nic nedokazují, ale jejich trend ukáže, kde porozumění mizí.

![Řada krémových stránek s modrými bloky na dopravníku prochází branou, jedna oranžová stránka stojí na stojánku.](https://assets.nobig.deals/blog/cmw2pypy202s60xpgfm98b6eh/dluh-v-porozumeni-kodu-ai-agenti-img-1-f32f822380.webp)

Trend ukáže, které změny nikdo nevysvětlí.

Přehled ukazatelů, které doporučujeme sledovat, a signálů, na které reagovat:

* **Doba do smysluplného review:** sledujte čas skutečné kontroly, ne kliknutí na Approve. Varovný signál jsou velké diffy schválené během minut.
* **Změny testů spolu s implementací:** sledujte podíl pull requestů, kde se mění obojí. Varuje, když se testy mění pokaždé, kdy selžou.
* **Mutation score:** ukazuje, kolik vnesených chyb testy zachytí. Varuje vysoké pokrytí při nízkém skóre.
* **Vysvětlitelnost změny:** vzorkujte pull requesty a ptejte se, zda jiný vývojář po 24 hodinách popíše účel změny. Varují odpovědi typu „to dělal agent“.
* **Rekonstrukce mentálního modelu:** měřte, jak dlouho nováček hledá modul a invarianty. Varuje doba, která roste, i když je CI zelené.

Principem je to, co zdůrazňuje [Osmani](https://addyosmani.com/blog/comprehension-debt/): testy ověří jen předem zakódované předpoklady, ne správnost zvoleného chování.

Druhou páteří jsou záznamy architektonických rozhodnutí (_ADR_) uložené v repozitáři, ne v konverzaci s agentem. Konverzace skončí, ADR zůstane a další člověk i další agent z něj obnoví důvody. Do pull requestu pak doporučujeme přidat krátkou šablonu.

Šablona review agentní změny

* Jaký problém změna řeší a jaké alternativy agent zamítl?
* Co testy dokazují?
* Co testy nedokazují?
* Jaké předpoklady agent učinil a kdo je schválil?
* Změnila se očekávání v testech, a pokud ano, proč?
* Je rozhodnutí zapsané v ADR?
* Jak změnu vrátit?

## Kdy plná autonomie nestojí za to a kdo ručí

Autonomii agenta stupňujte podle síly nezávislého ověření. Kde chybí silné testy, kontrakty nebo ruční scénáře, plná autonomie jen odkládá problém do produkce. Opakují se tři chyby. První je _rubber stamping_, tedy formální schválení bez porozumění. Druhou je agent, který přizpůsobuje testy své implementaci. Třetí je schválení podle struktury diffu místo podle rozhodnutí, která agent udělal.

Výhody a nevýhody

Kdy se vyplatí

* Omyl je levný a snadno vratný.
* Existují nezávislé testy a kontrakty, které agent nenapsal.
* Hotovo je definované hmatatelným důkazem.

Kdy ne

* Změna se týká transakcí, oprávnění nebo dat uživatelů.
* Testy vznikají ve stejném běhu jako implementace.
* Hotové práce přibývá rychleji, než ji tým dokáže posoudit.

Osmani nabízí test, který používáme i my: vsadili bychom na tuto změnu před člověkem, který ji bude udržovat? Pokud ne, nejde o review, ale o naději. Řešením je zpřísnit kontroly, aby člověka potřebovalo méně změn, nebo zpomalit. Další paralelní session nepomůže.

V nobig.deals nasazujeme agenty tak, že vnější smyčka zůstává u člověka. Člověk stanoví cíl, určí důkazy a schválí výsledek. Jak k tomu přistupujeme v praxi, popisujeme v rámci služby [AI agenti a automatizace](https://nobig.deals/cs/sluzby/ai-agenti). Týmům, které chtějí tento režim zavést do celého vývojového procesu, nabízíme [AI transformaci pro vývojáře](https://nobig.deals/cs/sluzby/ai-transformace). Ať agenti ve vývoji softwaru převezmou jakoukoli část práce, **odpovědnost za kód v produkci nese vývojář**, který změnu pustil dál.

## Časté otázky

### Co je comprehension debt a jak se liší od technického dluhu?

Comprehension debt je dluh v porozumění: tým provozuje kód, kterému už dostatečně nerozumí. Technický dluh se týká kvality kódu, třeba zkratek nebo zastaralé architektury, a obvykle je vidět. Dluh v porozumění může vzniknout i v čistém kódu se zelenými testy. Projeví se až ve chvíli, kdy je potřeba systém změnit a nikdo neumí vysvětlit, proč funguje právě takto.

### Stačí ke kontrole kódu od AI agenta zelené testy?

Nestačí. Kontrola kódu od AI agentů se nemůže opírat jen o zelený build, protože test může nést stejnou chybu jako implementace. Agent navíc dokáže testy přepsat tak, aby odpovídaly jeho řešení. Vždy se ptejte, co konkrétní test dokázal a co ne. Citlivost testů ověřte mutačním testováním a změny testů schvalujte odděleně od implementace.

### Co je kognitivní kapitulace u vývojářů?

Kognitivní kapitulace je stav, kdy výstup AI tiše přijmete za svůj a necítíte potřebu ho kontrolovat. Pojem zavedli Steven Shaw a Gideon Nave z Whartonu. U vývojářů se projevuje postupně: nejdřív čtete pozorně, pak jen přelétáte a nakonec schvalujete podle struktury. Poznáte ji tak, že nedokážete vysvětlit řádek, který jste sami schválili.

### Jak poznám, že agent upravil testy podle své implementace?

Nejspolehlivěji tak, že změny testů nikdy nepřijmete ve stejném commitu jako implementaci. Pak je každá změna očekávání vidět samostatně a vyžaduje zdůvodnění. Varovné signály jsou oslabené aserce, nově přeskočené testy a očekávané hodnoty přepsané na to, co kód právě vrací. Pomáhá také git hook nebo pravidlo v CI, které smíšené commity odmítne.

### Musím číst každý řádek kódu od AI agenta?

Ne, ale musíte vlastnit vnější smyčku. Předem definujte, co znamená „ověřeno“, a nejdřív kontrolujte důkazy, tedy spuštěné příkazy a jejich výstupy. Od agenta si nechte vypsat rozhodnutí a předpoklady. U rizikových míst, jako jsou transakce, oprávnění nebo výchozí hodnoty, čtěte pozorně. Když nedokážete říct, co kontroly minuly, chtějte skutečné review místo rychlého schválení.

Zdroje a odkazy (5)

Externí stránky, na které článek odkazuje.

1. [addyosmani.com](https://addyosmani.com/blog/comprehension-debt/) /blog/comprehension-debt
2. [arxiv.org](https://arxiv.org/html/2605.01160) /html/2605.01160
3. [arxiv.org](https://arxiv.org/html/2607.06101v1) /html/2607.06101v1
4. [dl.acm.org](https://dl.acm.org/doi/10.1145/3805689.3812402) /doi/10.1145/3805689.3812402
5. [code.claude.com](https://code.claude.com/docs/en/how-claude-code-works) /docs/en/how-claude-code-works

## Číst více

[![Message threads Claude API: co přinášejí a co ne](https://nobig.deals/_next/image?url=https%3A%2F%2Fassets.nobig.deals%2Fblog%2Fcmw0f2oww01zr0xpgbd68q6z1%2Fmessage-threads-claude-api-vlakna-hero-6cd97856d8.webp&w=3840&q=75)AI a vývojMessage threads Claude API: co přinášejí a co neMessage threads Claude API drží historii konverzace na serveru, takže po prvním požadavku posíláte jen novou zprávu a ID předchozí odpovědi. Šetří přenos dat a latenci, ale ne tokeny ani cenu, a vlákno po pěti minutách nečinnosti vyprší.](https://nobig.deals/cs/blog/message-threads-claude-api-vlakna)[![AI agenti ve firmě: co to je a jak automatizují procesy](https://nobig.deals/_next/image?url=https%3A%2F%2Fassets.nobig.deals%2Fblog%2Fcmvy8vi3w000a0xn8p64c66kc%2Fai-agenti-firma-automatizace-procesu-hero-df1c0d65b7.webp&w=3840&q=75)AI a vývojAI agenti ve firmě: co to je a jak automatizují procesyAI agenti nejsou chytřejší chatbot ani RPA skript, ale software, který si podle cíle naplánuje kroky, použije firemní nástroje a řeší výjimky. Ukážeme, kde dává smysl, kolik může ušetřit a jak ho nasadit bezpečně.](https://nobig.deals/cs/blog/ai-agenti-firma-automatizace-procesu)[![ChatGPT Work: sloučení Chat a Work a společný limit](https://nobig.deals/_next/image?url=https%3A%2F%2Fassets.nobig.deals%2Fblog%2Fcmw0ca3yg01ww0xpgxwnl0bnc%2Fchatgpt-work-slouceni-chat-work-hero-dc0d998b2d.webp&w=3840&q=75)AI a vývojChatGPT Work: sloučení Chat a Work a společný limitOpenAI chystá sloučení karet Chat a Work do jednoho okna, zatím jen pro vybranou testovací skupinu. Od prosince 2026 se navíc spojí limit ChatGPT a Codexu, a to je pro týmy důležitější než nové pohodlí.](https://nobig.deals/cs/blog/chatgpt-work-slouceni-chat-work)