provozni zaloha

cml/wiki/concepts/coding-agent-setup.md

@@ -0,0 +1,43 @@
+---
+type: concept
+title: "Coding agent setup"
+tags: [coding-agent, setup, configuration, workflow]
+sources: [claude-code-local-cloud-models, claude-code-ollama-workflow, claude-code-openrouter-beast-mode]
+created: 2026-06-18
+updated: 2026-06-18
+graph:
+  node_id: concept:coding-agent-setup
+  canonical: true
+  relationships:
+    - predicate: depends_on
+      object: concept:coding-agent
+      source: claude-code-local-cloud-models
+      evidence: "Setup je krok před použitím coding agenta"
+      confidence: high
+      status: current
+---
+
+# Coding agent setup
+
+Koncept konfigurace a nastavení coding agentů pro praktické použití. Zahrnuje volbu modelu, API endpointu, nákladovou optimalizaci a workflow.
+
+## Klíčové aspekty
+
+- **Volba modelu** — lokální (Ollama) vs. cloud (OpenRouter, nativní API)
+- **Konfigurace** — `.claude/settings.json`, env vars (`ANTHROPIC_MODEL`, `OPENAI_API_BASE`, `OPENAI_API_KEY`)
+- **Nákladová optimalizace** — OpenRouter pro beast mode, Ollama pro zdarma
+- **Workflow** — jak efektivně pracovat s agentem v terminálu
+
+## Konfigurace Claude Code
+
+1. **Ollama**: `OPENAI_API_BASE=http://localhost:11434/v1`, `OPENAI_API_KEY=ollama`
+2. **OpenRouter**: `OPENAI_API_BASE=https://openrouter.ai/api/v1`, `OPENAI_API_KEY=<klíč>`
+3. **Nativní API**: defaultní konfigurace, `ANTHROPIC_API_KEY`
+
+## Související
+
+- [[product-claude-code]] — hlavní coding agent
+- [[product-ollama]] — lokální inference
+- [[product-openrouter]] — cloud proxy
+- [[local-vs-cloud-models]] — trade-offy
+- [[cost-optimization]] — optimalizace nákladů

cml/wiki/concepts/coding-agent.md

@@ -0,0 +1,57 @@
+---
+type: concept
+title: "Coding agent"
+tags: [coding-agent, llm, tool-design, agent-architecture]
+sources: [pi-coding-agent-mario-zechner, pi-dev-terminal-limitation, claude-code-local-cloud-models, claude-code-ollama-workflow, claude-code-openrouter-beast-mode, claude-code-goal-command]
+created: 2026-06-16
+updated: 2026-06-22
+graph:
+  node_id: concept:coding-agent
+  canonical: true
+  relationships:
+    - predicate: depends_on
+      object: concept:llm
+      source: pi-coding-agent-mario-zechner
+      evidence: "Coding agenti využívají LLM jako jádro"
+      confidence: high
+      status: current
+---
+
+# Coding agent
+
+Software nástroj, který využívá LLM k autonomnímu nebo poloautonomnímu psaní, úpravě a správě kódu. Typicky nabízí schopnosti jako čtení/zápis souborů, spouštění příkazů, vyhledávání v codebase a správu kontextu.
+
+## Běžné problémy (podle Maria Zechnera)
+
+- **Feature bloat** — agenti nabírají funkce, které nejsou potřeba a přidávají skrytou kontextovou injekci.
+- **Skryté chování** — vendoři mění system prompty a kontext bez transparentnosti.
+- **Špatná pozorovatelnost** — těžké vidět, co agent dělá a kolik stojí.
+- **Chybějící rozšiřitelnost** — power user nemůže přidat vlastní nástroje bez forku.
+- **Approval fatigue** — buď plná autonomie, nebo approval pro každou akci.
+- **Špatná správa kontextu** — session compaction ztrácí důležitý kontext.
+
+## Příklady
+
+- [[product-pi]] — minimalistický agent (4 nástroje, tree-structured sessions)
+- Claude Code, OpenCode, Codex CLI, AMP, Cline — zmínění konkurenti
+
+## Modely a konfigurace
+
+- [[local-vs-cloud-models]] — trade-offy mezi lokálními a cloud modely
+- [[coding-agent-setup]] — konfigurace a nastavení
+- [[cost-optimization]] — optimalizace nákladů na API
+
+## Související
+
+- [[tree-structured-sessions]] — Piův přístup ke správě kontextu
+- [[terminal-limitation]] — společná limitace terminal-only agentů
+- [[pi-coding-agent-mario-zechner]] — zdroj (talk)
+- [[pi-dev-terminal-limitation]] — zdroj (poznámka o terminálové limitaci)
+- [[claude-code-local-cloud-models]] — zdroj (Ollama/OpenRouter/llama.cpp setup)
+- [[claude-code-ollama-workflow]] — zdroj (Ollama workflow návod)
+- [[claude-code-openrouter-beast-mode]] — zdroj (OpenRouter beast mode)
+- [[claude-code-goal-command]] — zdroj (/goal příkaz dokumentace)
+
+## Autonomní běh
+
+- [[goal-driven-agent-loop]] — koncept autonomního agenta s verifikovatelnou koncovou podmínkou

cml/wiki/concepts/cost-optimization.md

@@ -0,0 +1,42 @@
+---
+type: concept
+title: "Cost optimization"
+tags: [llm, cost, api, coding-agent]
+sources: [claude-code-openrouter-beast-mode]
+created: 2026-06-18
+updated: 2026-06-18
+graph:
+  node_id: concept:cost-optimization
+  canonical: true
+  relationships:
+    - predicate: depends_on
+      object: concept:coding-agent
+      source: claude-code-openrouter-beast-mode
+      evidence: "Cost optimization je relevantní v kontextu coding agentů"
+      confidence: medium
+      status: current
+---
+
+# Cost optimization
+
+Koncept optimalizace nákladů na LLM API při používání coding agentů. Klíčové pro dlouhodobě udržitelné používání.
+
+## Strategie
+
+- **OpenRouter proxy** — přístup k modelům za zlomek ceny nativního API
+- **Lokální modely** — nulové API náklady, ale nižší kvalita
+- **Model switching** — použití levnějších modelů pro jednoduché úkoly, výkonných pro komplexní
+- **Beast mode** — cílené použití nejvýkonnějších modelů přes nízkonákladový proxy
+
+## Praktické poznatky
+
+- OpenRouter ceny jsou výrazně nižší než přímé API přístupy
+- Lokální modely (3B–8B) jsou zdarma, ale kvalita stačí jen pro jednoduché úkoly
+- Hybridní přístup (lokální pro rutinu, cloud pro komplexní úkoly) je nejefektivnější
+
+## Související
+
+- [[product-openrouter]] — klíčový nástroj pro cost optimization
+- [[product-ollama]] — lokální alternativa
+- [[local-vs-cloud-models]] — trade-offy
+- [[coding-agent-setup]] — konfigurace

cml/wiki/concepts/e-waste-reduction.md

@@ -0,0 +1,29 @@
+---
+type: concept
+title: "E-waste reduction"
+tags: [e-waste, sustainability, longevity, hardware]
+sources: [source-lego-mindstorms-continued-use]
+created: 2026-06-20
+updated: 2026-06-20
+graph:
+  node_id: concept-e-waste-reduction
+  canonical: true
+  edges:
+    - predicate: improves_on
+      object: concept-software-preservation
+---
+
+# E-waste reduction
+
+Koncept prodloužení životnosti elektronických produktů — snižování množství e-waste tím, že hardware zůstává funkční i po ukončení oficiální softwarové podpory.
+
+## Příklad: LEGO Mindstorms
+
+Stovky tisíc až miliony sad Mindstorms po celém světě by se bez softwarové alternativy staly e-waste. [[product-pybricks]] tento trend obrací — open-source firmware dává EV3 brickům nový život s moderním programováním a okamžitým bootem.
+
+Pybricks argumentuje, že technologie LEGO robotiky se za 20 let fundamentálně nezměnila — všechny sady mají smart hub, motory, senzory. Rozdíl je v softwarové zkušenosti, kterou lze obnovit.
+
+## Odkazy
+
+- [[source-lego-mindstorms-continued-use]] — zdroj o Mindstorms a Pybricks
+- [[concept-software-preservation]] — softwarová stránka zachování produktů

cml/wiki/concepts/goal-driven-agent-loop.md

@@ -0,0 +1,38 @@
+---
+type: concept
+title: "Goal-driven agent loop"
+tags: [coding-agent, agent-loop, evaluation, autonomy, goal]
+sources: [source-claude-code-goal-command]
+created: 2026-06-22
+updated: 2026-06-22
+graph:
+  node_id: concept-goal-driven-agent-loop
+  canonical: true
+---
+
+# Goal-driven agent loop
+
+Koncept autonomního agenta, který pracuje dokud není splněna verifikovatelná koncová podmínka. Po každém turnu nezávislý evaluátor (menší model) posoudí, zda cíl byl dosažen.
+
+## Klíčové vlastnosti
+
+- **Verifikovatelná podmínka** — cíl musí být měřitelný z výstupu agenta (test result, build exit code, file count)
+- **Separátní evaluátor** — jiný model než agent sám posuzuje dokončení, čímž se eliminuje konflikt zájmů
+- **Autonomní iterace** — agent pokračuje bez dalšího promptu uživatele, evaluátor poskytuje guidance pro další turn
+- **Omezení běhu** — turn/time klauzule (např. "or stop after 20 turns") brání nekonečnému běhu
+
+## Implementace v [[product-claude-code]]
+
+Claude Code `/goal` příkaz: podmínka až 4000 znaků, evaluátor defaultně Haiku, funguje v interaktivním i non-interactive režimu. Komplementární s auto mode (schvaluje tool calls) — dohromady umožňují plně autonomní běh.
+
+## Porovnání s jinými přístupy
+
+- **`/loop`** — časový interval místo podmínky; vhodné pro opakující se úlohy
+- **Stop hook** — vlastní skript/prompt pro evaluaci; flexibilnější ale složitější
+- **Auto mode** — schvaluje tool calls v rámci turnu, ale nezačíná další turn
+
+## Související
+
+- [[source-claude-code-goal-command]] — zdroj (oficiální dokumentace)
+- [[product-claude-code]] — implementace /goal příkazu
+- [[coding-agent]] — obecný koncept

cml/wiki/concepts/local-vs-cloud-models.md

@@ -0,0 +1,48 @@
+---
+type: concept
+title: "Local vs. cloud models"
+tags: [llm, local-models, cloud-models, cost, privacy]
+sources: [claude-code-local-cloud-models, claude-code-ollama-workflow, claude-code-openrouter-beast-mode]
+created: 2026-06-18
+updated: 2026-06-18
+graph:
+  node_id: concept:local-vs-cloud-models
+  canonical: true
+  relationships:
+    - predicate: depends_on
+      object: concept:coding-agent
+      source: claude-code-local-cloud-models
+      evidence: "Lokální vs. cloud modely jsou relevantní primárně v kontextu coding agentů"
+      confidence: medium
+      status: current
+---
+
+# Local vs. cloud models
+
+Koncept volby mezi lokální inference (Ollama, llama.cpp) a cloud API (OpenRouter, nativní API) pro běh LLM modelů, zejména v kontextu coding agentů.
+
+## Trade-offy
+
+| Aspekt | Lokální (Ollama) | Cloud (OpenRouter) |
+|--------|-------------------|-------------------|
+| Náklady | Nulové (vlastní HW) | Pay-per-token |
+| Soukromí | Plné | Omezené |
+| Kvalita | Nižší (menší modely) | Vyšší (nejlepší modely) |
+| Latence | Nízká (lokální) | Vyšší (síť) |
+| Dostupnost | Závislá na HW | Vždy dostupné |
+| Flexibilita | Omezená na lokální modely | Široký výběr |
+
+## Praktické poznatky
+
+- Pro jednoduché úkoly stačí lokální modely (3B–8B parametrů)
+- Pro komplexní úkoly je cloud s výkonnými modely nezbytný
+- OpenRouter umožňuje hybridní přístup — snadné přepínání mezi lokálními a cloud modely
+- Beast mode = cloud s nejvýkonnějšími modely za nízkonákladový proxy
+
+## Související
+
+- [[product-ollama]] — lokální inference server
+- [[product-openrouter]] — cloud proxy
+- [[product-claude-code]] — coding agent podporující oba přístupy
+- [[coding-agent-setup]] — koncept nastavení coding agentů
+- [[cost-optimization]] — optimalizace nákladů

cml/wiki/concepts/micropython.md

@@ -0,0 +1,23 @@
+---
+type: concept
+title: "MicroPython"
+tags: [python, firmware, embedded, robotics]
+sources: [source-lego-mindstorms-continued-use]
+created: 2026-06-20
+updated: 2026-06-20
+graph:
+  node_id: concept-micropython
+  canonical: true
+---
+
+# MicroPython
+
+Lehká implementace Pythonu 3 optimalizovaná pro mikrokontroléry a embedded zařízení. Používá [[product-pybricks]] jako programovací jazyk pro LEGO robotiku — nahrazuje proprietární LEGO software otevřenou alternativou s plnohodnotným Python API.
+
+## V kontextu LEGO robotiky
+
+Pybricks běží MicroPython přímo na LEGO hubech (EV3, Robot Inventor, SPIKE Prime). Uživatelé píší standardní Python kód, který se spouští na bricku v reálném čase — žádná závislost na cloudových službách nebo proprietárních aplikacích.
+
+## Odkazy
+
+- [[product-pybricks]] — implementace MicroPython pro LEGO huby

cml/wiki/concepts/software-preservation.md

@@ -0,0 +1,33 @@
+---
+type: concept
+title: "Software preservation"
+tags: [preservation, software, e-waste, longevity]
+sources: [source-lego-mindstorms-continued-use]
+created: 2026-06-20
+updated: 2026-06-20
+graph:
+  node_id: concept-software-preservation
+  canonical: true
+  edges:
+    - predicate: improves_on
+      object: concept-e-waste-reduction
+---
+
+# Software preservation
+
+Koncept zachování softwaru a jeho funkčnosti po ukončení oficiální podpory. Kritický pro produkty, které závisí na aplikacích nebo serverech — bez softwaru se hardware stává e-waste.
+
+## Problém
+
+Jakýkoli gadget vyžadující počítač nebo telefon se rychle stává zastaralým, když původní aplikace přestanou fungovat na nových zařízeních. To platí i pro elektronické LEGO — Mindstorms aplikace mizí z app store a in-app content (tutoriály, build instrukce) je uložen v privátním app storage, který nelze zálohovat bez root přístupu.
+
+## Řešení
+
+- **Archivace instalátorů i app dat** — samotný APK/exe nestačí, potřebné jsou i in-app resources
+- **Komunitní firmware** — [[product-pybricks]] nahrazuje oficiální aplikace open-source alternativou
+- **Root přístup** — na Androidu nutný pro obnovu privátních app dat (blog robotmak3rs.com dokumentuje postupy)
+
+## Odkazy
+
+- [[source-lego-mindstorms-continued-use]] — případová studie Mindstorms
+- [[concept-e-waste-reduction]] — širší kontext snižování e-waste

cml/wiki/concepts/terminal-limitation.md

@@ -0,0 +1,44 @@
+---
+type: concept
+title: "Terminal limitation"
+tags: [coding-agent, terminal, ide, ux, limitation]
+sources: [pi-dev-terminal-limitation]
+created: 2026-06-16
+updated: 2026-06-16
+graph:
+  node_id: concept:terminal-limitation
+  canonical: true
+  relationships:
+    - predicate: depends_on
+      object: concept:coding-agent
+      source: pi-dev-terminal-limitation
+      evidence: "Terminal limitation je problém specifický pro coding agenty"
+      confidence: high
+      status: current
+---
+
+# Terminal limitation
+
+Koncept omezení coding agentů, kteří fungují pouze v terminálovém prostředí (terminal-only), bez plnohodnotné IDE integrace.
+
+## Problém
+
+Terminal-only přístup u coding agentů:
+- **Ztrácí výhodné vlastnosti** — bez IDE chybí vizuální kontext, navigace v kódu, integrace s debuggerem atd.
+- **Omezuje UX a produktivitu** — terminál není dostatečný pro komplexní interakci s kódem.
+- **Je společný pro více agentů** — např. [[product-pi|Pi]] i OpenCode sdílejí tuto limitaci.
+
+## Srovnání
+
+| Aspekt | Terminal-only | IDE integrovaný |
+|--------|--------------|-----------------|
+| Vizuální kontext | Omezený | Plný |
+| Navigace v kódu | Textová | Grafická |
+| Debugging | Omezený | Plný |
+| Rozšiřitelnost UI | Minimální | Plná |
+
+## Související
+
+- [[product-pi]] — Pi coding agent (terminal-only)
+- [[coding-agent]] — obecný koncept
+- [[pi-dev-terminal-limitation]] — zdroj (poznámka)

cml/wiki/concepts/tree-structured-sessions.md

@@ -0,0 +1,41 @@
+---
+type: concept
+title: "Tree-structured sessions"
+tags: [coding-agent, agent-architecture, context-management]
+sources: [pi-coding-agent-mario-zechner]
+created: 2026-06-16
+updated: 2026-06-16
+graph:
+  node_id: concept:tree-structured-sessions
+  relationships:
+    - predicate: depends_on
+      object: concept:coding-agent
+      source: pi-coding-agent-mario-zechner
+      evidence: "Tree-structured sessions jsou designový vzor pro coding agenty"
+      confidence: high
+      status: current
+---
+
+# Tree-structured sessions
+
+Designový vzor pro správu kontextu v coding agentech, zavedený v [[product-pi|Pi]]. Místo lineární chat historie (kde se kontext komprimuje a ztrácí) se session větví jako strom — sub-agenti mohou nezávisle číst soubory a pracovat, přičemž zachovávají lineage a kontext rodičovské session.
+
+## Problém, který řeší
+
+Lineární chat historie v coding agentech vede k:
+- Ztrátě důležitého kontextu při compaction
+- Nemožnosti paralelně zkoumat různé větve řešení
+- Nepružnému řízení — buď vše v jedné session, nebo nová session od nuly
+
+## Princip
+
+- Session je strom (tree), ne seznam (list).
+- Sub-agent se může odvětvit od libovolného bodu v konverzaci.
+- Každý uzel má přístup k souborům a může číst nezávisle.
+- Lineage (původ) je zachována — lze sledovat, odkud sub-agent vznikl.
+
+## Související
+
+- [[coding-agent]] — obecný koncept
+- [[product-pi]] — agent, který tento vzor implementuje
+- [[pi-coding-agent-mario-zechner]] — zdroj (talk)