Hands-on 2: Research agent — dodavatel obsahu pro tvůj skill

⏱ Odhadovaný čas 45 min

📍 Pozice Den 6, blok 4 / 7

🎯 Po tomto bloku budeš umět

• Pochopil(a) jsi KRITICKÝ gotcha: sub-agent nevidí Memory MCP ani CLAUDE.md
• Použil(a) jsi research sub-agent na augmentaci svého 2. skillu
• Vidíš, kdy je sub-agent dodavatel obsahu užitečný — a kdy je overhead

🧠 NEJDŘÍV mini-sekce: Co sub-agent NEVIDÍ (10 min, KRITICKÉ)

⚠️ Tohle je nejdůležitější věc Dne 6

Sub-agent má vlastní izolovaný kontext. Nevidí tvou aktuální konverzaci, nevidí Memory MCP, nevidí Global ani Project CLAUDE.md. Vidí JEN to, co napíšeš jako úkol pro něj.

Když na tohle zapomeneš, sub-agent ti vrátí generický (často špatný) výstup, a ty si budeš myslet, že je „rozbitý”. Není. Jen nemá kontext.

Konkrétní příklad — proč to selhává

Student A

❌ NEFUNGUJE (sub-agent nemá kontext):

Spusť Task tool. Úkol: "Najdi 3 maturitní fakta k mému slabému tématu."

Co se stane: Sub-agent neví, kdo jsi, neví jaké slabé téma máš (to je v Memory MCP), neví kterou maturitu (české / slovenské?). Vrátí buď generická fakta o čemkoli, nebo si vymyslí — halucinace, protože nemá data.

✅ FUNGUJE (vše explicitně v promptu):

Spusť Task tool. Úkol: "Najdi 3 fakta k tématu Třicetiletá válka (1618-1648)
pro maturitního studenta v ČR. Krátká, ne víc než 2 věty na fakt. Pro českou
státní maturitu z dějepisu, ne pro vědce."

Co se stane: Sub-agent má všechno potřebné — téma, úroveň, kontext (česká maturita), formát. Vrátí přesně to, co potřebuješ.

Student B

❌ NEFUNGUJE (sub-agent nemá kontext):

Spusť Task tool. Úkol: "Najdi mi příklady té gramatiky, co mi nejde."

Co se stane: Sub-agent neví, kdo jsi, neví jakou gramatiku (to je v Memory MCP), neví úroveň. Vrátí cokoli, často C1 nebo academic — k ničemu pro B1.

✅ FUNGUJE (vše explicitně v promptu):

Spusť Task tool. Úkol: "Najdi 5 autentických příkladů věty s past perfect
v běžné konverzaci (ne učebnicové). Pro českou studentku angličtiny, úroveň
B1. EN + CZ překlad. Pro každý příklad krátce vysvětli, PROČ je tam past
perfect (a ne past simple)."

Co se stane: Sub-agent má všechno potřebné — gramatika, úroveň, mateřský jazyk, formát výstupu. Vrátí přesně to.

Pravidlo

Pokud chceš, aby sub-agent vrátil personalizovaný výstup, hlavní CC musí nejdřív zavolat list_memories (pokud máš Memory MCP), vzít relevantní fakta, a předat je jako součást description parametru Task volání.

📦 Pokud Memory MCP nemáš funkční (Dne 5 fallback path)

Žádný panika — Memory není povinný pro tento blok ani pro Dne 6 obecně. Místo list_memories kroku dej osobní data ručně do promptu, jako bys je vytahoval/a z Memory.

To je vlastně přesně to, co tato kapitola učí — sub-agent dostane všechno explicitně. Memory by jen ušetřila psaní opakujících se faktů, ale nezmění hodnotu lekce.

Příklad: místo „zavolej list_memories a předej slabá místa” napíšeš v promptu „Slabá místa studentky: past perfect (plete s past simple), předložky” — totéž, jen ručně.

Cvičení (3 min)

Na papír si napiš své před / po prompty pro vlastní use case. Před = naivní (sub-agent neví). Po = explicitní (sub-agent ví všechno).

---

🚀 Hands-on: Research agent pro tvůj 2. skill (25 min)

Teď použiješ sub-agent jako dodavatele obsahu pro existující skill z Dne 5.

Student A

Use case

Tvůj /pripravny-plan (Dne 5) plánuje studium. Plán je obecný (například „Den 3: téma Třicetiletá válka”). Research sub-agent ti dodá konkrétní fakta, která vložíš jako podklad k danému dni.

1. Spusť claude v maturita-tutor/ (pokud neběží).

2. Zavolej skill /pripravny-plan — vytvoří plan-studia.md s tématy.

3. Otevři plan-studia.md a najdi konkrétní téma. Příklad: „Den 3: Třicetiletá válka”.

4. Spusť research sub-agent s plně explicitním promptem (klíčová lekce z této kapitoly):

   Spusť Task tool s general-purpose. Úkol:
   
   "Vyhledej 3 nejdůležitější bitvy Třicetileté války (1618-1648) a u každé:
   - Jméno bitvy + rok
   - Strany (kdo proti komu)
   - Stručný význam (1 věta)
   - Proč si ji student musí pamatovat (1 věta, pro českou státní maturitu)
   
   Cílový student: maturitní ročník v ČR, dějepis. Max 5 vět na bitvu."

5. Sleduj ⏺ Task(...) indikátor + výsledek.

6. Otevři plan-studia.md a manuálně vlož výstup pod sekci „Den 3: Třicetiletá válka — bonus material”.

7. Iterace: Zkus si projít ostatní dny v plánu. Pro každý spusť research sub-agent. Vždy s plně explicitním promptem (téma, úroveň, formát).

Student B

Use case

Tvůj /tyden-anglictiny (Dne 5) plánuje samostudium. Plán je obecný (například „Den 2: gramatika past perfect”). Research sub-agent ti dodá autentické příklady, které vložíš jako bonus material k danému dni.

1. Spusť claude v anglicky-tutor/ (pokud neběží).

2. Zavolej skill /tyden-anglictiny — vytvoří plan-tydne.md s gramatikami.

3. Otevři plan-tydne.md a najdi konkrétní gramatiku. Příklad: „Den 2: past perfect”.

4. Spusť research sub-agent s plně explicitním promptem (klíčová lekce z této kapitoly):

   Spusť Task tool s general-purpose. Úkol:
   
   "Najdi 5 autentických příkladů věty s past perfect (had + past participle)
   v běžné konverzaci. Cílová úroveň: B1. EN + CZ překlad pod každou větou.
   Pro každý příklad krátce vysvětli (1 věta), PROČ je tam past perfect a
   ne past simple. Cílová studentka: česká, mateřština čeština, žádná IPA fonetika."

5. Sleduj ⏺ Task(...) indikátor + výsledek.

6. Otevři plan-tydne.md a manuálně vlož výstup pod sekci „Den 2: past perfect — bonus material”.

7. Iterace: Zkus si projít ostatní dny. Pro každý gramatický jev spusť research sub-agent. Vždy s plně explicitním promptem (gramatika, úroveň, mateřština, formát).

---

✍️ Reflexe (10 min)

Do zaznamy.md:

🧠 Otázka 1

Tvůj research sub-agent vrátil personalizovaný výstup. Co konkrétně jsi musel/a poslat v promptu, aby to vrátilo dobré data?

Vzorová odpověď

• Téma (konkrétní, ne „moje slabé místo”)
• Úroveň (maturita, B1, ne „pokročilý”)
• Cílový student (kdo, mateřština, kontext)
• Formát výstupu (počet, struktura, max délka)

Sub-agent neví nic, takže ti to musí všechno vrátit. Bez tohoto = halucinace nebo generika.

🧠 Otázka 2

Kdyby tvůj 2. skill (/pripravny-plan / /tyden-anglictiny) měl tohle volat AUTOMATICKY pro každý den plánu, jaké by to bylo pravidlo v SKILL.md?

Vzorová odpověď

## Postup (rozšíření)

7. **Pro každý den plánu**, zavolej Task tool s general-purpose subagentem.
   V description **explicitně předej**:
   - téma daného dne
   - úroveň studenta (z Memory MCP, nebo natvrdo „B1" / „maturita")
   - mateřštinu (z Memory MCP nebo „čeština")
   - požadovaný formát (3 fakta + 1 otázka, max 4 věty na fakt)

   Výsledek vlož do plan-*.md pod sekci „Den N — bonus material".

Tohle uděláme v Bloku 05 (capstone). Důležité: hlavní CC musí nejdřív zavolat list_memories a osobní data předat sub-agentovi jako součást description (ne spoléhat na to, že to sub-agent „pochopí” sám).

---

🛟 Pokud se zasekneš

• Sub-agent vrátil generický / halucinovaný výstup → tvůj prompt nebyl explicitní. Doplň téma, úroveň, formát.
• Sub-agent ignoroval část úkolu → zkrať / zaostři. Sub-agent má vlastní kontext, ale ten není nekonečný.
• CC nepoužil Task tool → přidej „Použij Task tool, ne odpovídej sám”.

---

🧪 Checkpoint 120 min (od začátku dne)

• Rozumíš, že sub-agent nevidí Memory ani CLAUDE.md (mini-sekce výše)
• Spustil/a jsi research sub-agent alespoň 2× s plně explicitním promptem
• Manuálně vložil/a sub-agent výstup do svého plánu (plan-studia.md / plan-tydne.md)
• Reflexe v zaznamy.md (2 otázky)
• Tušíš, jak by se to dalo automatizovat ve SKILL.md (capstone Blok 05)

---

✅ Research sub-agent funguje, kontext-isolace pochopena, plán augmentován

Pokračovat na blok 04: Check-in →