Nápověda

🧠 Discovery analýza

Nástroj pro analýzu transkriptu z Discovery Workshopu. Generuje WMM scoring (7 dimenzí), zjištění, stakeholder mapu, rizika, doporučení a implementační cestu.

Vstupní data

1. Text — vlož transkript ručně (např. z Fireflies exportu jako text).
2. Soubor — nahraj PDF/DOCX/TXT s transkriptem.
3. JSON — nahraj Fireflies JSON export (preferovaný zdroj — obsahuje timestamps pro situační analýzu).

Pohled konzultanta

Před spuštěním analýzy vyplň pole 👤 Pohled konzultanta z workshopu. AI to bere jako ověřený insight se stejnou prioritou jako dossier klienta. Použij pro:

• Co nezaznělo nahlas (tenze, mlčení, nesoulad mezi lidmi).
• Tvé hypotézy, které chceš, aby AI zvážil.
• Kontext před workshopem (co ti klient řekl mimo kameru).
• Aha-momenty, které si nejde domyslet z transkriptu.

Hloubka session (auto-detekce)

Podle délky transkriptu se automaticky volí hloubka výstupu:

• Standard (< 8 000 znaků): 3–5 zjištění, 100–150 slov narrative.
• Rozšířená (8 000–25 000 znaků): 4–7 zjištění, 200–300 slov narrative, 2–3 stakeholders.
• Board session (> 25 000 znaků): 6–10 zjištění, 400–600 slov narrative, 4+ stakeholders, 3+ rizika, 3+ příležitosti.

Indikátor hloubky vidíš vpravo vedle tlačítka Analyzovat živě podle délky vstupu.

🌍 Situační analýza

Add-on k Discovery analýze. Z Fireflies JSON transkriptu extrahuje situační body o firmě ve 3 vrstvách a naplní jimi samostatnou sekci v DA výstupu. Neovlivňuje WMM scoring ani ostatní sekce.

Kdy ji spustit

• Máš Fireflies JSON export z Discovery Workshopu (s timestamps).
• Chceš kompletní situační obrázek firmy — externí + interní + jak se propojují do řízení práce.
• Potřebuješ traceability — každý bod má timestamp (MM:SS) pro zpětné dohledání v záznamu.

Jak ji spustit

Tři vrstvy výstupu

Barevné proužky u bodů

• ■ Zelená (high) — opakovaně diskutováno, konkrétní čísla/jména.
• ■ Oranžová (mid) — 1–2 konkrétní zmínky.
• ■ Červená (low) — nejasná nebo kolísavá formulace.

Gap list — klíčový výstup

Když některá pod-oblast v rozhovoru nezazněla dostatečně, AI nefabrikuje data — místo toho vytvoří otázku pro klienta. Všechny otázky se sbírají do Gap listu na konci situační sekce.

Jazyková podpora

Auto-detekce jazyka (čeština / angličtina). Výstup dostaneš v jazyce rozhovoru — jazyk je označen v badge vedle titulku karty (CS / EN).

Iterace promptů (pro vývojáře)

Prompty pro 3 vrstvy jsou v samostatném souboru src/data/situational-prompts.js. Konstanta SITUATIONAL_PROMPTS.{external, internal, bridge} — stačí upravit, commit, deploy. Tool schemas pro Anthropic jsou tamtéž v SITUATIONAL_SCHEMAS.

📊 WMM Scoring — jak číst

Worki Maturity Matrix (WMM) je náš proprietary framework pro měření vyspělosti řízení práce. 7 dimenzí, stupnice 1–5.

• T — Tým & vedení (váha 10%)
• S1 — Vstup práce (20%)
• S2 — Existence procesu (15%)
• S3 — Jasná odpovědnost (20%)
• S4 — Stabilita priorit (20%)
• S5 — Řiditelnost (15%)
• N — Nástroje (0% — informativní, nepočítá se do overall)

Confidence: každá dimenze má štítek Nízká / Střední / Vysoká jistota. Nízká = v rozhovoru málo dat, potřeba ověřit v Mapping Session.

„Předběžné" štítek nahoře karty — discovery dává orientační skóre, finalizace je v Mapping Sessions per oddělení.

Zóny: ≥ 3.5 🟢 dobrý základ · 2.5–3.5 🟡 potenciál · < 2.5 🔴 kritická oblast.

👤 Klientská karta & CRM přenos

Všechny výstupy (DA, MS, Situační) se automaticky ukládají ke klientské kartě. Z karty:

• Vidíš aktuální WMM profil s radar grafem, health score a trendem za posledních 5 měření.
• Vidíš archiv všech analýz s badge hloubky session a indikací, zda byl vyplněn pohled konzultanta.
• Můžeš stáhnout Export pro klienta (Word dokument s cover page, branded jako Worki).
• V listu /klienti vidíš sloupce WMM a Stage, filtry podle stage/hloubky/WMM, sort.

🔄 Doporučený workflow

1. Connect Call → založení karty klienta (prospect).
2. Průzkumník → dossier (company, people, nástroje) — ukládá se k klientovi.
3. Discovery Workshop → 2 hodiny na pozadí; nahrát Fireflies JSON + vyplnit pohled konzultanta.
4. Discovery analýza → spustit hlavní analýzu (WMM + findings + impl path + next steps).
5. Situační analýza → spustit z Fireflies JSON (externí/interní/bridge).
6. Klient: projít gap list → 3–5 doplňujících otázek před Mapping Session.
7. Mapping Sessions → per oddělení, finalizace WMM (ne předběžné).
8. Implementation path → podle doporučení z DA (typicky ms-first).
9. Pilot → Rollout → postupně měnit implementation_stage na kartě klienta.

⚠️ Řešení problémů

"524 timeout" při analýze

Platforma streamuje odpověď z AI. Pokud narazíš na 524, zmenši transkript nebo spusť znovu — Cloudflare Edge někdy zahazuje dlouhé fetche. Board session (> 25k znaků) může trvat 60–90 sekund, vytrvej.

"Klient nenalezen" v detailu

Klient v listu existuje, ale detail 404? Refresh stránky. Pokud pořád failuje, zkontroluj v /api/clients endpoint přes konzoli. Nejčastěji cache propagace po deployi.

Situační analýza — nabídka se neukáže

Tlačítko 🌍 Spustit Situační analýzu se zobrazí pouze když JSON obsahuje timestamps (Fireflies format). Pokud máš jen plain text transkript, použij hlavní Analyzovat — situační extrakce je Fireflies-only v light verzi.

JSON parse fail

DA používá Anthropic tool_use — JSON je garantovaně validní. Pokud přesto dostaneš parse error, v konzoli napiš _dwLastRaw a pošli output Honzovi. Pravděpodobně edge case v AI response.

Verze dokumentace: 17. 4. 2026 · Nahlásit chybu / žádost o feature: Honzovi.