# Plán autonomy: pravidelný deep web research pro use-case workflow

**Datum:** 21. 10. 2026  
**Stav:** Návrh k schválení vlastníka (declarativní plán, nehotový kód)  
**Určení:** Autonomie CyberBrain26 s pravidelným deep web researchem jako součástí každodenního workflow. Používá Kilo jako hlavního orchestrátora a existujícího subagenta `deep-research` pro gaining aktuálních informací.

---

## 1. Cíl

CyberBrain26 má být schopen autonomně rozhodnout, že daný use case vyžaduje aktuální webové informace, delegovat výzkum subagentovi `deep-research`, uložit výsledky s provenienzí a syntetizovat je do rozhodnutí, přičemž všechno prochází bezpečnostním řetězcem a auditní stopou.

---

## 2. Ověřené stavové poukazy (fakta z kódu)

Tato část popisuje stav, který je ověřen v kódu nebo konfiguraci. Vše ostatní je návrh.

### Ověřeno

| Komponenta | Soubor | Stav |
|---|---|---|
| Subagent `deep-research` | `.kilo/agent/deep-research.md` | Existuje, `mode: subagent`, `bash: deny`, `edit: deny`, `task: deny`, `external_directory: deny` |
| Orchestrátor je jediný primární delegátor | `.kilo/kilo.jsonc` | `"orchestrator": {"mode": "primary"}, "subagent_depth": 1` |
| Egress gate | `src/cyberbrain26/security_plane/egress.py` | Existuje, `EgressGate` vyžaduje allowlist providera, povolenou klasifikaci dat a audit |
| Auditní řetězec | `src/cyberbrain26/security_plane/audit/chain.py` | Existuje, verifikováno, `verify_chain()` vrací `linkage_ok` a `integrity_ok` odděleně |
| Knowledge plane (lokální adapter) | `src/cyberbrain26/knowledge_plane/local_source.py` | Lze registrovat pouze lokální soubor, metadata + SHA-256 digest, **žádné síťové operace, žádný parsing** |
| Retention default | `product/local_store.py` | `DEFAULT_RETENTION_DAYS` = 90 dnů; **pruning není naplánován**, `prune_expired()` musí být voláno explicitně |

### Otevřenámezery (problémy, které plán řeší)

1. **`deep-research` nemá `bash`** — dle svého vlastního popisu musí ověřovat každou URL (`curl` na API endpoints), ale `bash: deny` to blokuje. Výsledkem: URL, které subagent neověřil, musí být označeny jako `[NEOVĚŘENO]`.
2. **Žádné síťové úložiště v knowledge plane** — `local_source.py` podporuje pouze lokální soubory (`file:///`), nelze do něj ukládat stažené webové stránky.
3. **Žádná pravidelná (scheduled) research úloha** — orchestrátor řeší jednotlivá zadání, ne periodické monitoringové cykly.
4. **Pruning není automatický** — stará research data se neodstraňují samy.

---

## 3. Architektura autonomy s deep research

```
Uživatel/zadavatel zadá cíl / use case
    → Kilo (hlavní orchestrátor) posoudí, zda je potřeba deep research
        → ANO: Kilo deleguje subagentovi deep-research s formulovanou otázkou a rozsahem
            → deep-research provede webový výzkum (websearch,webfetch), URL ověří jen pokud má přístup
            → Výsledek: shrnutí s URL a daty přístupu, claims označené [VÝZKUM] / [HYPOTÉZA] / [NEOVĚŘENO]
            → Výsledek se uloží (lokální soubor, git, nebo knowledge plane po implementaci adapteru)
        → Kilo syntetizuje výzkum do doporučení / rozhodnutí pro use case
    → Výsledek + auditní stopa se předá uživateli
    → Opakováno periodicky podle need (use-case specifické intervaly)
```

### Komponenty

- **Kilo (hlavní orchestrátor):** rozhoduje o need for research, sestavuje input artefact pro `deep-research`, syntetizuje výstup, udržuje auditní stopu.
- **Subagent `deep-research` (read-only):** provádí veřejný webový výzkum, nesmí měnit repo, nesmí spouštět `bash`, nesmí delegovat.
- **Security plane:** identity → politika → oprávnění/scope → egress kontrola → schválení → vykonání → ověření → audit.
- **Uložiště výsledků:** dočasně souborový systém/git; po implementaci network adapteru knowledge plane.

---

## 4. Pracovní tok (use-case workflow)

Pro každý use case, který vyžaduje current informace:

1. **Rozhodnutí o need for research** — Kilo vyhodnotí, zda stávající znalosti stačí, nebo je třeba aktuální webové data.
2. **Formulace input artefactu** — otázka, kontext projektu, rozsah, cílové rozhodnutí, deadline.
3. **Delegace `deep-research`** — spuštění subagenta, výstup ve formátu dle `.kilo/agent/deep-research.md` (shrnutí s URL a daty přístupu, [VÝZKUM]/[HYPOTÉZA]/[NEOVĚŘENO] značení).
4. **Ověření výsledků** — orchestrátor zkontroluje, že každé faktické tvrzení má URL a datum přístupu (Gate 3 podmínka 1).
5. **Syntéza** — Kilo sestaví doporučení (znovu použít / upravit / napsat nově / zamítnout) pro use case.
6. **Schválení a audit** — výsledek projde security plane, auditní řetězec zaznamená celou cestu.
7. **Periodické opakování** — u dlouhodobých use cases se výzkum opakuje v definovaném intervalu (např. týdně, každých 14 dnů).

---

## 5. Use cases s pravidelnou frekvencí

| # | Use case | Cíl | Rozsah | Frekvence |
|---|---|---|---|---|
| 1 | Tržní research pro novou nabídku | Aktuální data konkurence, ceníky, tržní trendy | Web konkurence, odvětvové zprávy | Při každém rozhodnutí o nabídce (min. každých 30 dnů) |
| 2 | Technologické trendy pro agentní výběr | Nové modely, providery, schopnosti | Oficiální dokumentace, release notes, benchmarky | Týdně |
| 3 | Bezpečnostní hrozby a mitigace | Nové hrozby relevantní pro CyberBrain26 | Security blogy, CVE, advisories, fóra | Po události (instant) + týdenní shrnutí |
| 4 | Regulační a compliance monitoring | Změny regulací AI, datové privacy, bezpečnost | Oficiální gazety, právní zdroje, compliance blogy | Každých 14 dnů |

---

## 6. Brány a kritéria dokončení

### Gate 1 — Implementace ověřena v kódu
- Subagent `deep-research` je deklarován v `.kilo/kilo.jsonc` a existuje v `.kilo/agent/deep-research.md`.
- Kilo dokáže sestavit input artefact a předat jej `deep-research`.
- Výstup odpovídá formátu z `.kilo/agent/deep-research.md` (URL + datum přístupu, [VÝZKUM]/[HYPOTÉZA]/[NEOVĚŘENO]).

**Ověření:** Automatické testy kroků workflow jsou zelené; negativní testy pro chybějící vstupy fungují.

### Gate 2 — Provoz ověřen
- Reprodukovatelný end-to-end scénář: zadání → research → syntéza → výsledek.
- Celý scénář běží v podporované konfiguraci a zanechá audit a výstupní důkazy.
- Auditní řetězec zachytí celou cestu research akce.

**Ověření:** Reprodukovatelná E2E demonstrace a nezávislý verifier s důkazy.

### Gate 3 — Nezávislé posouzení
- Bezpečnostní tvrzení o egressu, citlivosti dat nebo nasazení prošlo nezávislou revizí.
- Výsledky research jsou odděleny od autorství kontrolovaného výsledku.

**Ověření:** Nezávislý verifier doloží závěr a důkazy.

---

## 7. Zvolená výchozí nastavení

- Kilo je jediný hlavní orchestrátor pro rozhodnutí o research potřebách (D6).
- `deep-research` je `subagent`, `bash: deny`, `edit: deny`, `task: deny` — nelze měnit repo ani spouštět příkazy.
- Výzkum pokrývá pouze veřejný webový obsah (HTTP/HTTPS), filtrováno security policy.
- Výsledky se ukládají do lokálního souboru/gitu; knowledge plane zatím nepodporuje síťová data.
- Pruning research dat není automatický — musí být volán explicitně (90dní retention default je výchozí, ale pruning není schedulován).

---

## 8. Rizika a pojistky

| Riziko | Pojistka v plánu |
|---|---|
| `deep-research` nemá `bash`, nelze ověřovat URL dle vlastního popisu | Výsledek uvádí `URL | HTTP status | co z něj vyčetl` jen pro stažené URL; ostatní jsou `[NEOVĚŘENO]`; orchesttor žádá ověření od uživatele/kilo CLI |
| Citlivá data uniknou přes research egress | Všechna egress projde `EgressGate` a schválením; citlivá data označena jako `restricted` |
| Stará/neaktualizovaná research data | Periodický monitoring dle use-case frekvence; retention 90 dnů, pruning explicitní |
| Monotónní growth research databáze | Ukládání metadata + SHA-256 digestu, originály odděleně, indexy obnovitelné |
| Výzkum bezprokazatelný (žádné URL/datum) | Každé tvrzení bez URL je `[HYPOTÉZA]` (tvrdá podmínka agenta) |

---

## 9. Zdroje a metodiky

Použitá metodologie vychází z existujících deep-research zdrojů (8fázová pipeline, triangulace, synthesis), adaptovaných na tento kódový základ. Subagent `deep-research` definuje vlastní výstupní formát a Gate 3 podmínky.

---

## 10. Zachování původních plánů

Původní soubory se nemažou. Tento plán rozšiřuje schopnosti CyberBrain26 o pravidelnou autonomii s deep web research podporou bez měnění cíle (`CyberBrain26cil-031026-v2.md` zůstává autoritativní).