# Zastaralé TODO komentáře: jak je uklidit kvůli AI agentům

> Zastaralé TODO komentáře stojí agenty o 77 % víc tokenů při odbočce. Podle Googlu: jak je najít, ověřit a uklidit po dávkách i s pojistkou v CI.

Canonical: https://aicko.cz/content/zastarale-todo-komentare-jak-je-uklidit-kvuli-ai-agentum
Last updated: 2026-11-13
Kategorie: Claude Code

**Zastaralé TODO komentáře** v kódu léta nikomu nevadily. S AI agenty se to mění: agent čte soubory jako první věc, narazí na `TODO(bug/12345)` a občas se vydá za ticketem, který je už dva roky zavřený. Google 6. listopadu 2026 zveřejnil měření, kolik ho takové odbočky stojí, a zároveň popsal, jak je ve svém kódu uklízí. Tady je, co z toho plyne a jak stejný úklid udělat ve vlastním repu.

## Co Google změřil: odbočky kvůli TODO stojí +77 % tokenů

Blogpost [Agent Distraction](https://developers.googleblog.com/agent-distraction/) (Google Developers Blog, 6. 11. 2026, autoři Sam Saccone a Madhuri Garikapati) vychází z provozních stop tisíců inženýrů a stovek milionů kroků agentů. Jako ukazatel „zastaralého materiálu" použili inline komentáře typu `TODO(bug/…)` a `FIXME(bug/…)`. Důvod je praktický: TODO často přežije bug, na který odkazuje, a skutečný stav je v ticketu.

Hlavní čísla z textu:

- **13 %** sessions, ve kterých agent četl soubory, narazilo na takový odkaz na bug.
- V **94 %** případů ho agent ignoroval, v **6 %** podnikl akci k danému bugu.
- **83 %** těchto akcí bylo nevyžádaných, vývojář se na bug vůbec neptal.
- **41 %** nevyžádaných odboček mířilo na už zavřený ticket (32 % opravený, 9 % zastaralý nebo „won't fix", 2 % duplicita či omezený přístup).
- Většina zbytku mířila na bugy, které jsou pořád otevřené. Agent je jen dohledával, nebo je rovnou začal opravovat, i když o to nikdo nežádal.

Po očištění regresí o vývojáře, složitost kódu, typ úkolu, tarif modelu, počet přečtených souborů a délku promptu vyšlo na jednu session s nevyžádanou odbočkou **+70 % kroků, +77 % tokenů a +105 % čekání**. Autoři to sami označují za „trivial to minor" případy po jednom, ale v součtu je to znatelná daň.

**Pozor:** čísla jsou z interního prostředí Googlu (jejich agenti, jejich ticketovací systém). Tvůj repozitář bude vypadat jinak. Berme to jako důkaz, že mechanismus existuje, ne jako slib, že u tebe ušetříš přesně 77 %.

## Proč agent za TODO vůbec jde

Agent při plánování čte široce a vše, co vidí, bere jako možně důležitý kontext. Komentář `TODO: opravit race condition, viz bug/4821` vypadá jako instrukce. Dva typické scénáře z blogpostu:

1. **Slepá ulička:** agent řeší nesouvisející chybu, otevře testovací soubor, najde TODO a stráví několik kroků zkoumáním bugu, který se opravil před lety.
2. **Horlivý agent:** narazí na TODO v kódu, který právě upravuje, a bez zadání ho „opraví". Rozšíří tak rozsah změny a vývojář ho musí zastavit.

Obojí tě stojí tokeny, čas i pozornost při review.

## Co říká druhá studie: komentáře nejsou všechno

Aby obraz nebyl jednostranný: studie [Does Code Cleanliness Affect Coding Agents?](https://arxiv.org/html/2605.20049v1) (SonarSource, arXiv, květen 2026) porovnávala čisté a „špinavé" varianty repozitářů s [Claude Code](https://aicko.cz/content/elephant-goldfish-model-spec-first-workflow-pro-claude-code) a Sonnetem 4.6. Čistší kód měl o 7,1 % méně vstupních tokenů a výrazně méně opakovaných návratů k už upraveným souborům (−33,8 %), úspěšnost se nezměnila. Když autoři z kódu odstranili komentáře a značky jako `# TODO` a `# FIXME`, hlavní efekt čistoty zůstal. Komentáře tedy podle nich za rozdíl nemohou.

Rozpor je jen zdánlivý. SonarSource měřil čistotu kódu jako celek na úlohách s jasným zadáním. Google měřil jeden konkrétní jev, odbočku vyvolanou odkazem na bug. Z obou dohromady plyne praktický závěr: **úklid TODO ti pomůže hlavně tam, kde odkazují na ticket, a zázrak od něj nečekej**. Zároveň je to jeden z nejlevnějších úklidů, které existují.

## Workflow: jak uklidit zastaralé TODO komentáře ve vlastním repu

Google na to postavil agenty, kteří prošli celý kód. Jejich postup se dá zmenšit na repo o tisících souborů. Nejdřív inventura, potom třídění, pak úklid po dávkách a nakonec pojistka, aby se TODO nevracela.

### 1. Udělej inventuru

Začni jednoduchým `grep`em. Nejde o dokonalost, jen o počet a rozložení:

```bash
git grep -n -E "(TODO|FIXME|HACK|XXX)" -- . ':!vendor' ':!node_modules' > /tmp/todo-inventory.txt
wc -l /tmp/todo-inventory.txt
git grep -n -E "(TODO|FIXME).*(#[0-9]+|[A-Z]+-[0-9]+|bug/|issues/)" > /tmp/todo-tickets.txt
```

Druhý příkaz vybere ty nejnebezpečnější: TODO s odkazem na ticket (GitHub `#123`, Jira `ABC-123`, interní `bug/…`). U nich se dá objektivně zjistit, jestli ještě platí. TODO bez odkazu („refaktorovat později") řeš až potom.

### 2. Zjisti stav ticketů

Google zjistil, že samotný status ticketu nestačí, ale je to dobrý první filtr. U GitHubu to zvládne `gh`:

```bash
gh issue view 123 --json state,closedAt,stateReason
```

Z `/tmp/todo-tickets.txt` vytáhni čísla ticketů a každé zařaď do jedné ze skupin: **zavřený**, **otevřený**, **neexistující / bez přístupu**.

### 3. Roztřiď podle toho, co s TODO dělat

| Situace | Co udělat |
|---|---|
| Ticket zavřený jako opravený, kód odpovídá | TODO smazat |
| Ticket zavřený jako „won't fix" nebo zastaralý | TODO smazat, případně nechat vysvětlující větu bez odkazu |
| Ticket otevřený, TODO popisuje skutečné omezení | Nechat, ale zkrátit na fakta (co chybí, proč) |
| Ticket otevřený, ale TODO nikdo neřeší roky | Rozhodnout: opravit, nebo smazat a ticket nechat jako jediný zdroj pravdy |
| Odkaz nejde ověřit | Neodstraňovat bez člověka |

Poslední řádek je důležitý. Google posílal změnu k review jen tehdy, když agent dokázal potvrdit, že obsolete je jak TODO, tak záměr za ním. U odkazů, které neumíš ověřit, to neodhaduj.

### 4. Nech agenta připravit úklid po dávkách

Samotné mazání je nudná práce přesně pro agenta. Dej mu inventuru a pevná pravidla. Příklad zadání pro Claude Code nebo Codex:

```text
V souboru /tmp/todo-tickets.txt je seznam TODO/FIXME s odkazem na ticket.
Pro každý záznam:
1. Zjisti stav ticketu přes `gh issue view`.
2. Přečti historii souboru (`git log -S"<text TODO>" --oneline`) a ověř,
   že záměr TODO je v kódu už splněný nebo neplatný.
3. Pokud je ticket zavřený A záměr je obsolete, smaž komentář.
   Jinak komentář nech a zapiš ho do /tmp/todo-skipped.md s důvodem.
Nic dalšího v kódu neměň, žádné opravy, žádné refaktory.
Dělej maximálně 20 souborů na jednu větev, každou dávku jako samostatný commit.
```

Důležité jsou dvě věci. Agent smí **jen mazat komentáře**, žádné „při té příležitosti opravím". A dávky jsou malé, aby je šlo skutečně přečíst. Tipy na větší běhy najdeš v článku o [Claude Code headless a nočních bězích](https://aicko.cz/content/claude-code-headless-nocni-behy-bez-dohledu-2026) a o tom, [jak nastavit oprávnění pro běh bez dohledu](https://aicko.cz/content/claude-code-opravneni-nastaveni-pro-beh-bez-dohledu).

### 5. Zkontroluj diff člověkem

Google uvádí u svého nástroje přes 95 % schválení lidskými reviewery po šesti měsících provozu a tisíce odstraněných odkazů. Tvoje číslo bude záviset na kvalitě pravidel. Při review hledej hlavně to, co agent smazal, ale nemělo se: TODO, které popisuje skutečné omezení a ticket je zavřený jen proto, že ho někdo hromadně uzavřel. Pomůže [code review podle rizika](https://aicko.cz/content/code-review-podle-rizika-jak-ho-nastavit-v-tymu-s-ai): úklid komentářů patří do nejnižší rizikové kategorie, ale nikdy ne do „bez pohledu".

### 6. Přidej pojistku, aby se TODO nevracela

Úklid bez pojistky je jednorázový. Dvě levné varianty:

- **CI nebo pre-commit kontrola:** selže, pokud nové TODO nemá odkaz na ticket ve formátu, který používáte, nebo pokud odkazuje na zavřený ticket. Stačí krátký skript nad `git grep` a `gh issue view`.
- **Pravidlo pro agenta v `AGENTS.md` nebo `CLAUDE.md`:** například „TODO komentáře s odkazem na ticket neber jako zadání. Neotevírej je a neopravuj, pokud o to uživatel nepožádal." Jak psát takové soubory, vysvětluje článek [AGENTS.md: jak naučit AI coding agenta tvým pravidlům](https://aicko.cz/content/agents-md-jak-nastavit-ai-coding-agenta) a [kontextové inženýrství pro AI agenty](https://aicko.cz/content/kontextove-inzenyrstvi-ai-agenti-prakticky-navod).

Pravidlo v `AGENTS.md` je pojistka na straně agenta, kontrola v CI na straně kódu. Google v závěru zmiňuje přesně tyhle nástroje: presubmit analyzátory, skenery nad celým kódem a agenty, kteří mrtvá TODO uklízejí.

## Jak poznat, že to něco dalo

Nejde o dokonalé měření, ale o pár ukazatelů před a po:

1. **Počet TODO s odkazem na zavřený ticket** (cíl: nula).
2. **Spotřeba tokenů a počet kroků** na stejném typu úkolů. Agenti mívají v logu nebo v dashboardu průměr na session, porovnej týden před a po.
3. **Počet nevyžádaných změn v diffech** při review: kolikrát agent sáhl na něco, co jsi nezadal.

Pamatuj na variabilitu. SonarSource uvádí, že nejdražší běh stejného úkolu stál často zhruba 2,5× víc než nejlevnější. Jeden týden dat nic nedokazuje, hledej trend přes víc týdnů.

## Kdy se úklid nevyplatí

Ne každé repo to potřebuje. Pokud máš pár desítek TODO a žádný nemá odkaz na ticket, jsou pro agenta jen šum a nestojí za automatizaci. Pokud je repozitář generovaný nebo archivní a agenti do něj nesahají, taky ne. Úklid se vyplatí tam, kde:

- agenti pracují denně a čtou širokou část kódu,
- TODO mají odkazy na ticketovací systém,
- starší část kódu přežila několik týmů a nikdo neví, co je pravda.

Google v závěru píše, že úklidové projekty odkládané kvůli zdánlivě malé hodnotě je potřeba s agenty přehodnotit. Úklid dnes stojí hodiny agenta a jedno review, ne týdny ruční práce.

## Časté otázky

### Jak poznám, že je TODO komentář zastaralý?

Nejspolehlivější je kombinace tří věcí: ticket, na který odkazuje, je zavřený, historie souboru (`git log -S`) ukazuje, že popsaná práce se udělala, a aktuální kód už popsanému problému neodpovídá. Samotný stav ticketu nestačí, protože zavřený ticket může znamenat „nebudeme řešit" a omezení v kódu pořád platí.

### Opravdu stojí zastaralé TODO komentáře o 77 % víc tokenů?

Ne obecně. Google naměřil +77 % tokenů u sessions, ve kterých agent nevyžádaně vyrazil za bugem z TODO komentáře. Takových sessions bylo jen malé procento (agent akci provedl v 6 % případů, kdy narazil na odkaz). Dopad na celkovou spotřebu bude menší a bude záviset na tom, jak často agenti v tvém kódu na takové odkazy narážejí.

### Mám smazat všechna TODO, aby agenti nebyli rozptylovaní?

Ne. Smaž ta, u kterých umíš prokázat, že jsou zastaralá. TODO, která popisuje skutečné omezení a stále platí, je užitečná i pro agenta, jen ji zkrať na fakta. Nejnebezpečnější jsou komentáře s odkazem na ticket, protože vybízejí k dohledávání. V `AGENTS.md` navíc můžeš agentovi říct, aby je bez zadání neotevíral.

### Může úklid komentářů dělat agent sám?

Ano, ale s omezeným zadáním: jen mazat komentáře, malé dávky, každý krok s důkazem (stav ticketu, historie souboru) a nakonec review člověkem. Google to dělá podobně a u svého nástroje uvádí přes 95 % schválených změn. Agent, který při úklidu „zároveň opraví" kód, přesně opakuje chybu, kterou chceš odstranit.

### Pomůže to i s jiným nástrojem než Claude Code?

Mechanismus je obecný: každý agent, který čte soubory a bere komentáře jako kontext, může být zmaten zastaralým odkazem. Google měřil své interní agenty, SonarSource Claude Code. Postup úklidu (inventura, kontrola ticketu, mazání po dávkách, pojistka v CI) funguje stejně u Codexu i Cursoru, jen pravidlo pro agenta zapíšeš do jejich konfiguračního souboru.

## Related

- [Obsah: Claude Code](https://aicko.cz/obsah/claude-code)
- [Claude AI](https://aicko.cz/ai-tools/claude)
- [Claude Code](https://aicko.cz/ai-tools/claude-code)
- [Codex](https://aicko.cz/ai-tools/codex)
- [Jira](https://aicko.cz/ai-tools/jira)

---
Zdroj: AIčko.cz. Při citaci uveďte název webu a odkaz na https://aicko.cz/content/zastarale-todo-komentare-jak-je-uklidit-kvuli-ai-agentum
