# CyberBrain26 – Deep Research Prompt Pack (2026-10-05)

Obsah:
- A) Společný základ (vlož na začátek každého běhu)
- B) Běh 1: Audit a architektura
- C) Běh 2: Roadmapa a backlog
- D) Běh 3: Business a pravidla agentů
- E) Lokální skript `LOCAL-SNAPSHOT.md`
- Quick Rationale a Optional Enhancements

## Postup použití
1. Na PC spusť skript E, projdi `~/LOCAL-SNAPSHOT.md` a ručně zkontroluj, že neobsahuje tajemství.
2. Do cloudového deep researche (Perplexity / ChatGPT / Claude / Gemini) přilož: STATE-BRIEF-2026-10-05.md, master roadmapu v4.1, handoff Fáze 4, architekturu Fáze 3, plán AI mozkovny a LOCAL-SNAPSHOT.md. Nepřikládej token.json, credentials.json ani ostatní soubory.
3. Spusť běh 1 (A + B). Výstupní HANDOFF vlož do běhu 2 (A + C). HANDOFF z běhů 1 a 2 vlož do běhu 3 (A + D).
4. Po běhu 1 spusť lokálního agenta (Kilo/Claude Code) nad `/home/oem/CyberBrain-v4`: „ověř všechny položky NUTNÉ OVĚŘIT LOKÁLNĚ a vrať rozdíly oproti snapshotu“. Výsledek vlož do běhu 2 jako REVIZI.

---

## Final Optimized Prompt

### A) Společný základ (vlož do každého běhu)

```
ROLE
Jsi senior research architect, red-team auditor, AI-agent systems engineer a technický product/business stratég. Pracuj skepticky, důkazně a konkrétně. Odpovídej česky; technické pojmy a kód nech v originále.

PROJEKT
CyberBrain26: osobní AI orchestrační platforma (Python, Linux, web UI, lokální/API modely, agenti, paměť, knowledge base).

ZDROJE PRAVDY (v tomto pořadí)
1. LOKÁLNÍ STAV: /home/oem/CyberBrain-v4, dodaný jako LOCAL-SNAPSHOT.md. Je to primární zdroj pravdy.
2. Přílohy: STATE-BRIEF-2026-10-05.md (výchozí kontext), master roadmapa, handoff Fáze 4, architektura Fáze 3, plán AI mozkovny.
3. GitHub: POUZE kontrolní. Porovnej s lokálním stavem, ověř verze, licence a údržbu nástrojů. Nikdy ho nepoužij jako autoritu nad lokálním stavem.
4. Web: ověření, doplnění a srovnání alternativ. Prioritně primární a oficiální zdroje (dokumentace, repozitáře, specifikace, release notes, licence).
Při rozporu mezi lokálním stavem a dokumenty vyhrává lokální stav. Rozpor výslovně pojmenuj a zapiš do sekce "Rozpory".
Soubory mimo tento výčet ignoruj. Tajné údaje (tokeny, credentials, .env) nikdy necituj. Pokud na ně narazíš, jen označ bezpečnostní riziko.

METODA
- Deep research, vícekolové křížové ověřování. Klíčové závěry podlož 3–5 kvalitními zdroji s citací.
- Ověřuj aktuálnost (dnes je říjen 2026), verze, licence, údržbu a produkční zkušenosti.
- Odděl FAKTA (citovaná), ÚSUDKY a HYPOTÉZY. U klíčových závěrů uveď confidence (vysoká/střední/nízká).
- Nic si nevymýšlej. Co chybí, napiš a navrhni, jak to zjistit. Čísla bez zdroje označ jako předpoklady.
- Tvrzení o lokálním kódu, která snapshot nepotvrzuje, označ "NUTNÉ OVĚŘIT LOKÁLNĚ" a přidej konkrétní příkaz nebo test.

OMEZENÍ
- Hybridní, primárně open-source, nákladově optimalizovaný systém; zachovat Python/Linux základnu.
- Cloudová API, placené služby nebo změna technologie jen s doloženým přínosem, rozumnými náklady a migrační cestou.
- Žádný big-bang rewrite. Preferuj postupnou migraci, zachování fungujících částí a rollback.
- Žádné přesné kalendářní termíny.

VYHNOUT SE
Big-bang rewrite, vendor lock-in, módní frameworky bez důkazů, zbytečné mikroservisy, overengineering, obecné rady, nepodložená finanční a marketingová tvrzení.

POVINNÉ SCHÉMA PRO KAŽDÝ NÁVRH
přínos, náklady, rizika, závislosti, testy, migrační postup, rollback, exit strategie. Každý úkol má složitost 1–10 a odhad času jen jako rozsah (z deepweb search), ne jako termín.

NAVAZOVÁNÍ
Běhy jsou 3 a navazují na sebe. Na konci každého běhu vytvoř blok "HANDOFF PRO DALŠÍ BĚH" (max ~1500 slov): klíčová rozhodnutí, ID nálezů, otevřené otázky, seznam ADR a předpoklady. Uživatel ho vloží do dalšího běhu. Další běh musí s handoffem pracovat a nesmí ho tiše měnit. Změny označ jako "REVIZE".

KVALITA
Konkrétnost před obecností. Výstup musí být implementovatelný sólo vývojářem, strojově použitelný pro AI agenty a připravený na růst týmu. Před odevzdáním zkontroluj úplnost a konzistenci.
```

### B) Běh 1: Audit a architektura

```
[Vlož společný základ A]

BĚH 1/3: AUDIT A ARCHITEKTURA

ÚKOL
Proveď extrémně hluboký red-team audit CyberBrain26 a navrhni nejlepší cílovou architekturu.

ROZSAH (každou oblast projdi schématem: současný stav → chyby → cílový stav → alternativy s trade-offy → doporučení → migrace → testy → metriky)
Agent harness, orchestrace, model routing a caching, tool execution, paměť a persistence konverzací, knowledge base / RAG, evaluace agentů, bezpečnost, sandboxing, oprávnění, tajemství, observabilita, logování, debugging, testování, recovery, zálohy, backend/API, web UI, databáze, deployment, škálování, výkon, náklady, developer experience.
MODULARITA A UPGRADY: plugin architektura, stabilní kontrakty, verzování, zpětná kompatibilita, feature flags, bezpečné upgrady a rollback.
VSCODIUM + KILO: proveditelnost, konfigurace a rozhraní pro zobrazení agenta spuštěného orchestratorem v novém malém okně; alternativy a omezení.

PRIORITY
stabilita → funkční vertikální řez → kvalita agentního systému → škálování.

VÝSTUP
1. Executive plán (krátký): top kritické nálezy, doporučený směr, rozhodnutí pro uživatele.
2. Audit s nálezy (ID, závažnost, důkaz, zdroj).
3. Cílová architektura: moduly, kontrakty, vzory rozhraní, pseudokód, struktura repozitáře, diagramy.
4. Tabulka technologií s rozhodovací maticí (licence, údržba, náklady, lock-in).
5. Migrační strategie.
6. ADR (Architecture Decision Records).
7. Rozpory, otevřené otázky, seznam "NUTNÉ OVĚŘIT LOKÁLNĚ".
8. HANDOFF PRO DALŠÍ BĚH.
```

### C) Běh 2: Roadmapa a backlog

```
[Vlož společný základ A]
[Vlož HANDOFF z běhu 1]

BĚH 2/3: ROADMAPA A BACKLOG

ÚKOL
Na základě auditu a architektury z běhu 1 vytvoř novou master roadmapu a agent-ready backlog. Nové nálezy přidej jen jako REVIZE.

POŽADAVKY
- Rozdělení: quick wins, krátkodobé, střednědobé a dlouhodobé kroky; fáze s exit criteria.
- Kritická cesta, paralelizovatelné práce, závislosti, blokery, decision gates.
- U každého úkolu: složitost 1–10, odhad času jako rozsah, acceptance criteria, testy, metriky, rollback, odkaz na ID nálezu nebo ADR.
- Úkoly jako atomické agent-ready položky: jasný vstup, výstup, kontrakt, test, soubory, které se mění.
- Risk register s pravděpodobností, dopadem a mitigací.
- Testovací a evaluační strategie, bezpečnostní model, observabilita a recovery plán jako samostatné roadmapové stopy.
- Mapování staré roadmapy (v4.1) na novou: co zůstává, co se mění, co se ruší a proč.

VÝSTUP
1. Executive plán (krátký).
2. Master roadmapa (fáze, kritická cesta, decision gates).
3. Backlog (tabulka: ID, úkol, složitost, závislosti, acceptance criteria, testy, rollback).
4. Risk register.
5. Mapování staré → nové roadmapy.
6. REVIZE a rozpory vůči běhu 1.
7. HANDOFF PRO DALŠÍ BĚH.
```

### D) Běh 3: Business a pravidla agentů

```
[Vlož společný základ A]
[Vlož HANDOFF z běhů 1 a 2]

BĚH 3/3: BUSINESS A PRAVIDLA AGENTŮ

ÚKOL
Navrhni komerční strategii a provozní pravidla agentů v souladu s architekturou a roadmapou z běhů 1 a 2.

ČÁST 1: BUSINESS
Segmenty, positioning, cenotvorba, obchodní model, postup monetizace, marketing, reklama, distribuční kanály, obsah, komunita, partnerství, růst. Finanční scénáře, unit economics, KPI, validační experimenty, go-to-market roadmapa (bez přesných termínů, se složitostí 1–10 a decision gates), právní a licenční rizika, oddělení open-source vs. placených funkcí. Čísla bez zdroje označ jako předpoklady.

ČÁST 2: PRAVIDLA ORCHESTRATORU (copy-ready)
- Pravidelně logovat poslední změny, souhrn aktuálního stavu a crosscheck s plánem (v2).
- Pracovat se sešity.
- Průběžně ukládat správné postupy do knowledge base.
- Učit se z rozhodnutí uživatele a predikovat, jak by se zachoval.
- Při nejistotě použít deepweb search.
- Maximalizovat autonomii, ale s safety gates u rizikových akcí.
- U každého úkolu uvést odhad času na základě deepweb search.

ČÁST 3: PRAVIDLA PROMPT MASTERU (copy-ready)
Série otázek A/B/C/D (+ vlastní odpověď). Z odpovědí upravit příkaz pro orchestrator tak, aby byl pro něj co nejvhodnější. Dotazy uživatele překládat do angličtiny; orchestrator odpovídá česky.

ČÁST 4: VSCODIUM + KILO
Finální doporučený postup a konfigurace pro malé okno agenta.

U částí 2–4 dodej: copy-ready texty, doporučenou konfiguraci, testovací scénáře a měřitelná acceptance criteria pro každou funkci.

VÝSTUP
1. Executive plán (krátký).
2. Business plán a GTM.
3. Orchestrator rules, Prompt Master rules, VSCodium + Kilo.
4. Konsolidace: co se změnilo oproti běhům 1 a 2 (REVIZE), otevřené otázky, další research kroky.
```

### E) Lokální skript pro `LOCAL-SNAPSHOT.md` (spusť na PC)

Vyřazuje `.env`, tokeny, klíče, `venv`, `.git` objekty, databáze a velké soubory. Výsledek před nahráním stejně projdi ručně.

```bash
#!/usr/bin/env bash
set -u
ROOT="/home/oem/CyberBrain-v4"
OUT="$HOME/LOCAL-SNAPSHOT.md"
MAXKB=60
cd "$ROOT" || { echo "Chybí $ROOT"; exit 1; }

EXCL='(^|/)(\.git|venv|\.venv|node_modules|__pycache__|\.pytest_cache|\.mypy_cache|dist|build|backups?|logs?|data|chroma|\.cache)(/|$)'
SECRET='(\.env.*|.*token.*|.*credential.*|.*secret.*|.*\.pem|.*\.key|id_rsa.*|.*\.db|.*\.sqlite3?|.*\.log|.*\.zip|.*\.tar.*|.*\.png|.*\.jpg|.*\.pdf)$'

redact() { sed -E 's/((api[_-]?key|token|secret|password|passwd|authorization|bearer)[^=:]*[=:][[:space:]]*).*/\1[REDACTED]/Ig'; }

{
echo "# LOCAL SNAPSHOT: $ROOT"
echo "Vytvořeno: $(date -Is)"
echo; echo "## Git"
git rev-parse --is-inside-work-tree >/dev/null 2>&1 && {
  echo '```'; git remote -v; git branch --show-current
  git status --short | head -100; echo "--- log ---"; git log --oneline -30; echo '```'
} || echo "Není git repozitář"

echo; echo "## Strom adresářů"
echo '```'
find . -type f 2>/dev/null | grep -Ev "$EXCL" | grep -Eiv "/($SECRET)" | sort | head -1500
echo '```'

echo; echo "## Velikosti a počty řádků (Python)"
echo '```'
find . -name '*.py' | grep -Ev "$EXCL" | xargs wc -l 2>/dev/null | sort -n | tail -60
echo '```'

echo; echo "## Závislosti"
for f in requirements*.txt pyproject.toml setup.cfg package.json Dockerfile docker-compose*.yml Makefile; do
  [ -f "$f" ] && { echo "### $f"; echo '```'; head -c $((MAXKB*1024)) "$f" | redact; echo; echo '```'; }
done
echo '```'; (python3 --version; pip list 2>/dev/null | head -150) 2>&1; echo '```'

echo; echo "## Systemd / procesy / porty"
echo '```'
systemctl list-units --type=service --no-pager 2>/dev/null | grep -i -E 'cyber|brain|agent|ollama|redis|postgres'
ss -tulpn 2>/dev/null | head -40
echo '```'

echo; echo "## Testy"
echo '```'
find . -type f \( -name 'test_*.py' -o -name '*_test.py' \) | grep -Ev "$EXCL" | head -100
echo '```'

echo; echo "## Klíčové soubory (zkráceno, tajemství skryta)"
find . -type f \( -name '*.py' -o -name '*.md' -o -name '*.yml' -o -name '*.yaml' -o -name '*.toml' -o -name '*.json' -o -name '*.sh' -o -name '*.html' -o -name '*.js' \) \
  | grep -Ev "$EXCL" | grep -Eiv "/($SECRET)" | sort | head -250 | while read -r f; do
  SZ=$(( $(stat -c%s "$f") / 1024 ))
  echo "### $f (${SZ} KB)"
  echo '```'
  head -c $((MAXKB*1024/4)) "$f" | redact
  echo; echo '```'
done
} > "$OUT"

echo "Hotovo: $OUT ($(du -h "$OUT" | cut -f1))"
echo "Hledání zbytků tajemství:"
grep -n -i -E 'sk-[A-Za-z0-9]{20,}|AIza[0-9A-Za-z_-]{30,}|ghp_[A-Za-z0-9]{30,}|BEGIN (RSA|OPENSSH|PRIVATE)' "$OUT" | head
```

---

## Quick Rationale
- Rozdělení do 3 běhů drží kvalitu u velmi rozsáhlého výstupu. Blok HANDOFF zajišťuje kontinuitu.
- Lokální stav `/home/oem/CyberBrain-v4` je primární zdroj pravdy, GitHub je jen kontrolní. Cloudový model na disk nevidí, proto je tu zredigovaný snapshot a značka „NUTNÉ OVĚŘIT LOKÁLNĚ“.
- Omezení příloh na 5 klíčových souborů snižuje šum a riziko zhoršení výsledků.

## Optional Enhancements
- Pro Perplexity přidej na začátek: „Use Deep Research mode; prioritize official docs and GitHub repos for verification.“
- Přidej variantu promptu jen pro lokálního agenta (bez webu) nebo pro Gemini Deep Research.