🎯 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 ✂️

# 🎯 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í.