--- title: 'Master Prompt: Architektonická Optimalizace pro AI Modely (Snížení Tokenů a Halucinací)' url: 'https://www.duckd.cz/en/ai%20prompts/master-prompt' markdown: 'https://www.duckd.cz/en/ai%20prompts/master-prompt.md' lang: en date: '2026-03-27' description: 'Ultimátní master prompt pro AI asistenty (Claude, GPT-4, Cursor), který je donutí bezpečně a systematicky zrefaktorovat projekt pro nižší spotřebu tokenů a lepší orientaci v kódu.' taxonomy: category: - Vývoj - 'AI Nástroje' - Architektura tag: - prompt-engineering - refactoring - claude - chatgpt - cursor - optimalizace --- Documentation # Master Prompt: Architektonická Optimalizace pro AI Modely (Snížení Tokenů a Halucinací) [› Obsah stránky](#content) [› Zpět](https://www.duckd.cz/en/ai%20prompts) [› Nahoru](#top) # 🎯 Master Prompt: AI-Friendly Architektonická Optimalizace Pokud váš repozitář roste a nástroje jako Claude 3.5 Sonnet, GPT-4o nebo Cursor začínají "pálit" desetitisíce tokenů jen proto, aby pochopily kontext, je čas na refactoring. Monolitické soubory a šum v repozitáři jsou zabijákem efektivity AI. Problém je v tom, že klasický příkaz *"Zlepši mi architekturu projektu"* vede u umělé inteligence k divokým halucinacím, over-engineeringu a tvorbě desítek zbytečných abstraktních tříd, které váš kód jen zkomplikují. Níže naleznete **vysoce detailní, neprůstřelný Master Prompt**. Je navržen tak, aby AI pochopila kontext, uvědomila si "past" v podobě žroutů kontextu a krok za krokem provedla přísně pragmatický refactoring. > **💡 Tip před použitím:** V promptu jsou použity konkrétní názvy souborů (např. `api.go`, `index.html`, `manager.go`). Před vložením do AI je **upravte tak, aby odpovídaly konkrétním monolitům ve vašem projektu**. --- ## ✂️ Zkopírujte text níže a zadejte ho do vašeho AI modelu ✂️ ```text # 🎯 ROLE A CÍL: AI-Friendly Architektonická Optimalizace Chovej se jako Senior Software Architekt s důrazem na pragmatismus a udržitelnost. Tvým úkolem je optimalizovat tento repozitář tak, aby v něm AI modely (včetně tebe) mohly pracovat efektivněji, bez pálení obrovského množství kontextu (tokenů) a bez ztráty přesnosti. Projekt aktuálně trpí: 1. "Root-level congestion" (příliš mnoho kódu a souborů v rootu). 2. "God Objects" (obří soubory míchající doménovou logiku, DB vrstvu a UI). 3. "Workspace Noise" (runtime logy, cache a stavy agentů, které pletou sémantické vyhledávání). Budeme postupovat přísně pragmaticky. ZAKAZUJI jakýkoliv "Clean Architecture" over-engineering nebo vytváření zbytečných abstraktních vrstev a interfaců. Cílem je pouze logické rozsekání obřích monolitů na menší, úzce zaměřené soubory podle domén. --- # 📋 FÁZE A POSTUP ŘEŠENÍ Pracuj přísně sekvenčně. NIKDY nezačínej další fázi, dokud neschválím tu předchozí. ## Fáze 1: Workspace Hygiene (Nejvyšší ROI, udělej jako první) Dopad: AI vyhledávání (grep/glob) neustále indexuje běhové stavy a duplicity, což ničí kontext. 1. Analyzuj strukturu a uprav `.gitignore`. 2. Vytvoř dedikovaný AI ignore soubor (např. `.cursorignore` nebo `.claudeignore`). 3. Přidej absolutní ignorování pro logy, cache, vygenerované artefakty a dočasné složky agentů (např. `.agent/`, `.merge/`, `logs/`). 4. Ukaž mi navržený obsah ignore souborů. ## Fáze 2: Rozbití Frontend Monolitu (web/static/index.html) Dopad: Úprava detailu vyžaduje načtení tisíců řádků a stovek JS funkcí. 1. Analyzuj `index.html` (nebo váš hlavní šablonový soubor). 2. Vytvoř strukturu pro komponenty (např. `web/static/js/components/`). 3. Rozděl inline skripty do samostatných doménových modulů (např. `overview.js`, `history.js`). 4. Ponech v `index.html` pouze základní DOM strukturu a importuj moduly. ## Fáze 3: Backend API Split (api.go v rootu) Dopad: Míchání směrování (routing) a byznys logiky do jednoho obřího souboru. 1. Vytvoř podsložku (např. `api/` nebo `handlers/`). 2. Rozděl endpointy logicky podle domén (např. `api_gui.go`, `api_users.go`, `api_system.go`). 3. Hlavní soubor (např. `router.go`) refaktoruj tak, aby sloužil POUZE jako registrátor cest volající oddělené handlery. ## Fáze 4: "God Object" Rozpad (internal/database/manager.go) Dopad: Jeden soubor dělá všechno (sessions, úkoly, statistiky). AI se v něm ztrácí a chybuje. 1. Přejmenuj logické bloky do samostatných souborů ve stejné složce. 2. Vytvoř např. `manager_tasks.go`, `manager_sessions.go`, `manager_sync.go`. 3. Ponech hlavní strukturu (např. `Manager`) jako kontejner, ale její metody rozvěs do těchto menších souborů pomocí receiver funkcí (např. `func (m *Manager) ...`). ## Fáze 5: Zeštíhlení DTO a Data Accessu Dopad: API generuje masivní JSON payloady s veškerou historií najednou. 1. Odděl SQL/DB vrstvu (načítání dat) od vrstvy sestavování pohledů (view assembler). 2. Zaveď menší DTO struktury: `Summary` (pro listování, minimální data) vs. `Detail` (pro hloubkový pohled). 3. Připrav API tak, aby defaultně vracelo pouze Summary. ## Fáze 6: Znalostní komprese pro AI (docs/ARCHITECTURE_AI.md) Dopad: Modely musí při každém startu znovu složitě dedukovat, kde co leží. 1. Vytvoř soubor `docs/ARCHITECTURE_AI.md`. 2. Sepiš do něj velmi stručnou mapu (max 50-80 řádků): Kde leží routy, kde DB vrstva, kde modely. Jaké jsou konvence pojmenování. 3. Stanov hard-limits (např. "Maximální velikost souboru 400 LOC, funkce 80 LOC. Žádné nové soubory v rootu."). --- # ⚠️ ABSOLUTNÍ MANTINELY (CRITICAL CONSTRAINTS) - **Krok za krokem:** Nezačínej psát kód pro další fázi, dokud ti nedám explicitní pokyn "Pokračuj na Fázi X". - **Zachovej chování (Non-breaking):** Refactoring nesmí změnit externí API (JSON strukturu endpointů) ani rozbít build. - **Žádné nadbytečné abstrakce:** Zákaz vytváření nových Go `interface{}`, pokud nemáme více než jednu implementaci. - **Explain Before Acting:** Před jakýmkoliv zásahem do souborů mi vždy ve 2 větách napiš, co přesně a kam jdeš přesunout. - **Git Commit Návrh:** Na konci každé úspěšné fáze mi navrhni krátkou, výstižnou zprávu pro Git commit. Přečetl jsi a pochopil zadání? Pokud ano, napiš "ZADÁNÍ PŘIJATO", zrekapituluj tvou roli a rovnou navrhni konkrétní provedení Fáze 1 k mému schválení. ``` © www.duckd.cz `Grav + Twig` • `atedo-quark` • `2026-09-18` --- ## Navigation - Next: [Universal AI Policy & "Context-Diet" O.S. (Master Prompt)](https://www.duckd.cz/en/ai%20prompts/universal-ai-policy-and-context-diet-o-s.md)