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 (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:
- 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.
- 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? (SonarSource, arXiv, květen 2026) porovnávala čisté a „špinavé" varianty repozitářů s 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 grepem. Nejde o dokonalost, jen o počet a rozložení:
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:
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:
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 a o tom, jak nastavit oprávnění pro běh 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: ú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 grepagh issue view. - Pravidlo pro agenta v
AGENTS.mdneboCLAUDE.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 a kontextové inženýrství pro AI agenty.
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:
- Počet TODO s odkazem na zavřený ticket (cíl: nula).
- 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.
- 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.