DEMIURGOS: Jak vytvořit jednotná pravidla pro AI agenty ve vývoji
AI agenti pro psaní kódu často generují nekonzistentní výsledky a ignorují specifika projektu. Řešením je systém DEMIURGOS, který automaticky vytváří a udržuje jednotnou sadu pravidel pro všechny coding agenty v týmu.
Architektura DEMIURGOS: tři vrstvy řízení
DEMIURGOS je postaven na třívrstvé architektuře, která zajišťuje flexibilitu a minimalizuje redundanci.
- Jádro (.rules/): centralizovaný zdroj pravidel projektu. Popisuje technologický stack, standardy kódování, architektonické vzory a omezení.
- Native Adapters: tenké projekce jádra pro konkrétní AI agenty. Například .cursor/rules/*.mdc pro Cursor, CLAUDE.md pro Claude Code, .github/copilot-instructions.md pro GitHub Copilot. Pravidla se neduplikují – adaptéry odkazují na jádro.
- Extensions: volitelná vrstva pro složité scénáře, jako jsou multi-agentní systémy nebo integrace přes MCP (Model Context Protocol). Vytváří se pouze při prokázané potřebě.
Praktické využití: příklady z různých stacků
Systém prokazuje efektivitu v různých technologických kontextech a odhaluje mezery v pravidlech prostřednictvím režimu ladění.
Vývoj her na Godot 4.3 s GDScript
Při vytváření komponenty zdraví agent, vedený pravidly, generuje typizovaný kód s kompozicí přes uzly a signály. Režim ladění /debug full odhaluje mezery:
- Absence konvencí pro názvy vstupních akcí (například player_dash).
- Nedostatek pravidel pro spojení schopností s UI přes signály cooldown_started.
- Doporučení nahradit SceneTreeTimer uzly Timer pro podporované pauzy timerů.
Backend na Python s asynchronním SQLAlchemy
Pro implementaci API objednávky agent aplikuje pravidla třívrstvé architektury, vlastních výjimek a batch dotazů. Ladění ukazuje mezery:
- Žádné mapování výjimek na HTTP statusy v routeru.
- Absence pravidel pro zpracování race condition přes SELECT FOR UPDATE.
- Nejasné rozdělení flush() v servisu a commit() v routeru.
Frontend s Astro a SolidJS
Při vývoji přepínače témat agent dodržuje pravidla Islands Architecture a UnoCSS. Odhalené mezery zahrnují:
- Absence strategie pro prevenci FOUC přes inline skripty v <head>.
- Žádné univerzální pravidlo pro zpracování Browser API s try/catch.
- Nejistota ve výběru mezi createSignal a createStore pro stav.
Klíčové výhody implementace DEMIURGOS
Zavedení systému pravidel přináší vývojářským týmům měřitelné výhody.
- Konzistence kódu: všichni AI agenti v projektu pracují podle jednotných standardů, čímž snižují čas na revize a refaktoring.
- Zkrácení času onboarding: nový vývojář získá pravidla přes git pull, jeho agent okamžitě generuje kód v souladu s přijatými postupy v týmu.
- Iterativní zlepšování: režim ladění /debug odhaluje mezery v pravidlech po 10–20 požadavcích, což umožňuje prioritně je upravovat. Typické oblasti pro doplnění:
- Konvence game designu v herních projektech.
- Obchodní logika a zpracování transakcí v backendu.
- Edge cases browser API a přístupnost ve frontendu.
- Podpora 22+ nástrojů: jedna sada pravidel v jádru se promítá na Cursor, Windsurf, Claude Code, GitHub Copilot, Kiro, JetBrains AI Assistant a další agenty přes adaptéry.
- Minimální režijní náklady: pravidla jsou uložena jako soubory v repozitáři, nevyžadují samostatnou infrastrukturu nebo složité nastavení.
Co je důležité
- DEMIURGOS řeší problém nedostatku kontextu projektu u AI agentů prostřednictvím centralizovaných pravidel.
- Architektura ze tří vrstev zajišťuje flexibilitu a vyhýbá se duplikaci kódu.
- Režim ladění odhaluje mezery v pravidlech, což umožňuje iterativně je zlepšovat.
- Systém podporuje více než 22 nástrojů pro vývoj, čímž zajišťuje konzistenci v týmech.
- Implementace snižuje čas na správu agentů a zvyšuje kvalitu generovaného kódu.
— Editorial Team
Zatím žádné komentáře.