AI coding asistenti jsou skvělí – dokud nezačnou likvidovat váš kód

Přiznejme si to na rovinu: AI coding asistenti jsou fascinující. Napíší repetitivní kód rychlostí blesku, navrhnou opravy během vteřiny a občas přijdou s řešením, které by vás nikdy nenapadlo. Jenže tady je ten háček – neví, kdy přestat. Necháte-li je bez dohledu, s radostí přepíší celou codebase, zanesou breaking changes nebo jednoduše ignorují architektonická rozhodnutí, nad kterými váš tým strávil týdny.

Přesně na tohle cílí anma.

Divoký západ AI-asistovaného programování

Když dáte AI agentovi přístup k vašemu repozitáři, v podstatě mu předáváte klíče od království. Většina vývojářů si nastaví nějaké ty hranice pomocí CLAUDE.md nebo podobných dokumentů – instrukcí, které agentovi říkají, co má a nemá dělat. Problém je, že tyto dokumenty se snadno přehlédnou, zřídka se dodržují a často padají za okraj, jakmile se kontextové okno zaplní.

Viděl jsem to na vlastní oči. Vývojář požádal AI, ať uklidí auth modul, a za dvě hodiny měl kompletní přepsané ověřování, které obcházelo stávající správu session. AI nebyla zlá – prostě nevěděla, kde jsou hranice.

YAML kontrakty vstupují na scénu

anma jde jinou cestou. Místo statické dokumentace, která v repozitáři jen pasivně leží, používá plain text YAML kontrakty. Ty definují, co vaši AI asistenti mohou a nemohou dělat. Nejsou to žádné složité konfigurační soubory – jde o čitelné, lidsky přívětivé definice hranic.

# Ukázkový anma kontrakt
boundaries:
  - scope: auth/
    allow: [read, modify-session]
    deny: [delete, bypass-auth]
  - scope: migrations/
    allow: [read]
    deny: [write, delete]

Krása tkví v jednoduchosti. Pokud jste někdy psali Docker Compose nebo GitHub Actions workflow, syntaxe YAML vám bude okamžitě povědomá.

Od kontraktu k vymahatelnosti

Tady to začíná být zajímavé. anma nejen vytváří kontrakty a nenechává je jen jako doporučení. Kompiluje je do více enforcement mechanismů:

Generování CLAUDE.md: Váš kontrakt se stává součástí dokumentace, kterou AI agenti čtou při vstupu do projektu. Žádné hledání zastaralých instrukcí – vše se generuje čerstvě pokaždé.

Pre-commit hooky: Než se jakékoli změny s AI asynchronizací commitnou, anma je ověří proti vašim kontraktům. Pokud se váš coding agent pokusí překročit hranice, hook ho zachytí a označí porušení.

CI/CD integrace: Vaše kontrakty běží jako součást vašeho continuous integration pipeline. To znamená, že každý PR se kontroluje proti definovaným pravidlům, bez ohledu na to, jestli změny přišly od AI, junior vývojáře nebo nočního kódění.

Proč je to důležité pro týmy

Pro jednotlivé vývojáře je anma takový rozumný hlídač. Ale pro týmy? Tam se to teprve ukazuje.

Představte si, že nasazujete nového AI agenta do workflow. Místo psaní obsáhlé dokumentace, která možná bude dodržována a možná ne, definujete jasné, vymahatelné hranice. Vaši senioři nastaví pravidla a anma zajistí, že je dodržuje úplně každý – člověk i AI.

To se hodí hlavně tady:

• Startupy jedoucí na plný plyn: Když iterujete rychle, poslední věc, kterou potřebujete, je AI, která zruší včerejší rozhodnutí.
• Konzultační týmy: Definujete pravidla specifická pro klienta jednou a můžete věřit, že každá interakce je respektuje.
• Velké korporace: Compliance a architektonická konzistence se stanou automatickými – ne jen cíli na papíře.

Větší obrázek

Vstupujeme do éry, kdy budou AI coding asistenti standardní součástí vývojových prostředí. Otázka není "jestli je používat" – je to "jak je používat zodpovědně".

Nástroje jako anma reprezentují zralý přístup k této výzvě. Místo toho, abychom AI buď plně důvěřovali, nebo se jí úplně vyhýbali, umožňují střední cestu: inteligentní asistenci v jasně definovaných hranicích.

Přístup přes YAML kontrakty také naznačuje něco důležitého: definování hranic by nemělo vyžadovat disertaci nebo vlastní DSL. Nejlepší omezení jsou ta, která přečte a pochopí celý váš tým.

Jak začít

Pokud používáte AI coding asistenty ve svém workflow – klidně jen na osobních projektech – stojí za to investovat odpoledne do nastavení anma kontraktů. Budete spát líp s vědomím, že vám AI asistent nepřipraví noční překvapení v podobě refactoringu vašeho error handlování.

Podívejte se na projekt na GitHubu: anma-labs/anma. Dokumentace je přímočará a learning curve je mírný. Berte to jako instalaci zábradlí pro vaše čím dál schopnější AI spolupracovníky.

Protože budoucnost kódování není čistě lidská ani čistě AI – je to obojí, spolupracující v rozumných mezích.