Zavádí povinná pravidla pro správu task registru: search before create, cancel superseded, reference related, scan after done — platí pro všechny agenty i developery pracující v EP21 repozitářích.
Bez explicitní policy vznikají v task registru duplicitní a ghost tasky. Příklad: po architektonickém přepisu git domain modelu zůstalo 12 open tasků (TASK-0005 až TASK-0016) jejichž záměr byl implementován pod jiným task ID. Backlog obsahoval ghost tasks které matly agenty i developery.
Problém byl strukturální: neexistovalo pravidlo vyžadující prohledání backlogu před vytvořením nového tasku nebo zrušení supersedovaných tasků při architektonické změně.
Rozhodnutí
✓ Chosen: Task Hygiene Policy — čtyři závazná pravidla jako součást AGENTS.md a CLAUDE.md
Task registry je first-class projektový artefakt. Znečištěný backlog způsobuje ghost tasks, contradictory tasks, duplicate effort a backlog noise.
Čtyři pravidla:
1. Search before create — před tasks.py add spustit tasks.py list + OPEN-TASKS.md
2. Cancel superseded immediately — před zahájením implementace, s poznámkou Superseded by TASK-YYYY
3. Reference between related tasks — nový task odkazuje na ten který nahrazuje
4. Scan after done — po označení done projít open tasky a zrušit obsolete
Policy je implementována v AGENTS.md (Task Hygiene sekce) a CLAUDE.md (Before starting any task + AI agent rules).
Scope
Policy platí pro:
Všechny AI agenty (Claude Code, Claude API, jiné LLM agenty) pracující v repozitáři
Lidské developery používající EP21 task registry
Jakýkoli automatizovaný workflow, který vytváří tasky programaticky
Duplicate detection checklist před každým tasks.py add:
[ ] Prohledán task list podle hlavního klíčového slova
[ ] Zkontrolován OPEN-TASKS.md pro aktivní práci ve stejné oblasti
[ ] Žádný existující task nepokrývá stejnou tabulku, presenter, CLI příkaz nebo feature
[ ] Pokud existuje podobný done/cancelled task: nový task má prokazatelně odlišný scope
Důsledky
Pozitivní:
Backlog zůstává malý, přesný a důvěryhodný — i po mnoha iteracích s různými agenty
Agenti mohou spolehlivě číst OPEN-TASKS.md jako zdroj pravdy o aktivní práci
Architektonické přepisy mají trackovatelnou historii zrušených tasků
Negativní / rizika:
Vyžaduje disciplínu: agenti musí search before create i při časovém tlaku
False positive: agent může označit relevantní task jako duplicitu → mitigace přes checklist
Follow-up:
Zvážit automatizovanou detekci potenciálních duplicit při tasks.py add (fuzzy match na title + labels)
Changelog
Version
Date
Author
Note
1.0.0
2026-04-10
david.sorf
Migrováno z docs/adr/ADR-EP21-Task-Hygiene-Policy.md.