Pomenované podľa chvíle, keď to vzniklo
Názvy súborov, ktoré dávali zmysel v deň, keď vznikli, a o mesiac ich už nikto nevyhľadá.
Súbory dostávajú mená podľa kontextu svojho vzniku – final, v2, poznámky, samotné meno klienta. Tieto názvy zachytávajú okamih, nie obsah, takže o mesiac sa nedá nič nájsť bez toho, aby ste súbor otvorili. Konvencia pomenovania je systém na vyhľadávanie a treba ju určiť pred prvým súborom, nie po stom.
Vzor
Súbory sa hromadia s názvami ako notes, final, v2, analysis_new, alebo len holé priezvisko. Každý z nich bol v okamihu vzniku jasný.
Desať súborov sa dá prehľadať, 50 už otravuje, 300 je problém. O mesiac je priečinok neprehľadný a jediný spôsob, ako niečo nájsť, je otvárať súbory jeden po druhom.
Prečo to vyzerá správne
Názov vzniká v okamihu maximálneho kontextu, keď na ňom nič nie je nejednoznačné. Venovať čas premýšľaniu o konvencii pomenovania pôsobí ako vyhýbanie sa skutočnej práci.
Situácia sa navyše zhoršuje postupne. Desať súborov je v poriadku, päťdesiat otravuje, tristo je problém s vyhľadávaním – a vtedy je premenovanie už celý projekt.
Prečo to zlyháva
Názov súboru je jediné metadáta, ktoré s istotou prežijú každé presunutie, kopírovanie, synchronizáciu a export. Je to jediná vec, ktorú vyhľadávanie vidí bez toho, aby čokoľvek otváralo.
Názvy, ktoré zachytávajú okamih – final, new, v2 – nenesú o mesiac žiadnu informáciu, pretože každý súbor bol kedysi finálny a nový. Názvy, ktoré zachytávajú iba tému bez dátumu, sa nedajú zoradiť. A nekonzistentné názvy znemožňujú porovnávanie podľa predpony, čo je pre agenta najlacnejší spôsob vyhľadávania.
Pre agenta je to horšie ako pre človeka. Model si vyberá súbory podľa názvu a nové súbory píše podľa vzoru názvov, ktoré vidí, takže nekonzistentný priečinok vytvára čoraz nekonzistentnejší výstup.
Namiesto toho
Konvenciu určte pred prvým súborom a urobte ju natoľko mechanickou, aby sa dala uplatňovať bez rozmýšľania:
YYMMDD_subject_variant · dátum na začiatku kvôli chronologickému zoradeniu · žiadna diakritika v identifikátoroch · verzia podľa changelogu, nie podľa názvu súboruVäčšinu práce odvedú dve pravidlá. Nikdy nezakódovávajte stav do názvu – final a v2 sú na to, na čo slúži história verzií. A na jednej ploche udržujte jednu konvenciu namiesto konvencie pre každého človeka zvlášť, pretože konvencia, ktorá sa líši podľa autora, je konvencia, ktorá sa nedá vyhľadávať.
$ head -12 named-for-the-moment.md
$ cite named-for-the-moment
Citation id SV-7390 is stable. It resolves at
https://stillvalid.dev/sk/c/SV-7390 even if this artifact moves to another section,
which a bare URL does not survive. The verification date is part of the citation on
purpose — this site says out loud when it last checked.
[Pomenované podľa chvíle, keď to vzniklo](https://stillvalid.dev/sk/patterns/named-for-the-moment) — stillvalid, SV-7390 (anti-pattern, verified 2026-08-14)