Postup pro napsání záznamu architektonického rozhodnutí do docs/adr/ podle šablony, kterou repozitář už používá: měřeno, ne odhadnuto. Předepisuje disciplínu i strukturu výsledného souboru.
Kdy ho spustit
Když je rozhodnutí zároveň VÝZNAMNÉ (nová závislost, změna datového modelu, výměna knihovny) a SPORNÉ (rozumný člověk může argumentovat oběma směry). Malé zjevně správné změny ADR nepotřebují.
Co vynucuje
Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.
Co je potřeba vědět
- Měř, neodhaduj. ADR, které tvrdí „mohlo by to být pomalé ve velkém“, aniž by uvedlo změřený současný rozsah, není hotové.
- Řekni, co bylo skutečně rozbité. Návrhy na větší stack často začínají u reálného symptomu, jehož skutečná příčina je mnohem menší — najít a opravit ten skutečný problém bývá celé řešení.
- Zvaž konkrétní údržbovou cenu přijetí, ne jen nepřijetí. Druhý zdroj pravdy je nové riziko duplikace, ne jeho snížení.
- Dej ČÍSELNÝ práh pro přehodnocení, ne „později“ nebo „až to poroste“ — to je rozdíl mezi „teď ne“ a „ne“.
- ADR nikdy nepřebíjí AGENTS.md: dokumentuje technické rozhodnutí, ne rozhodnutí o rozsahu. Rozsah se mění výhradně zápisem do append-only autorizačního logu.