Přeskočit na obsah

Lekce 06.7: Změna směru: Když se cíl změní (Rerouting: When The Destination Changes)

⏱️ 2 min čtení Lekce 06.7

🧠 Mentální model & teoretický rozbor

V reálném inženýrství se často stane, že v polovině práce zjistíte, že původní plán nefunguje:

  • Třetí strana změnila API.
  • Knihovna má kritický bug.
  • Vedení změnilo byznys zadání.
ŠPATNÝ PŘÍSTUP (OHÝBÁNÍ ZA POCHODU):
Vývojář se snaží "přesvědčit" agenta v zaplněném sezení, aby zapomněl, co dělal,
a začal dělat něco úplně jiného.
Výsledek: Agent vytvoří hybridní zmetek kombinující staré i nové zadání.
SPRÁVNÝ INŽENÝRSKÝ PŘÍSTUP (REROUTING):
1. Zastavit sezení (Ctrl + C)
2. Git stash / Git checkout (Úklid nedokončeného kódu)
3. Aktualizace specifikace v Markdownu (Nová mapa)
4. /clear a start v čistém sezení s novou specifikací!

🏢 Realistický scénář z praxe

Při stavbě platebního modulu s platební bránou GoPay klient náhle oznámil, že se přechází na Stripe:

  • Místo toho, aby vývojář v běžícím chatu psal: „Hele, GoPay zruš a dej tam Stripe,“
  • Provedl čistý řez:
    1. Aktualizoval specifikaci docs/specs/billing.md.
    2. Přepsal tickety.
    3. Spustil čerstvé sezení a za 2 hodiny měl hotovou čistou Stripe integraci bez jediného řádku starého GoPay kódu.

💻 Konkrétní ukázky kódu & promptů

Jak provést čistý restart zadání (Rerouting Prompt):

POZOR - ZMĚNA ZADÁNÍ:
Původní návrh na použití SQLite pro fulltextové vyhledávání byl zrušen.
Nové rozhodnutí: Použijeme PostgreSQL trigram extension (`pg_trgm`).
Aktuální stav:
- Kód byl vrácen do čistého stavu (git reset).
- Nová specifikace je zapsána v docs/specs/search-v2.md.
Úkol pro toto čisté sezení:
Implementuj POUZE migraci pro zapnutí extension `CREATE EXTENSION IF NOT EXISTS pg_trgm;` a GIN index na sloupec title.

⚠️ Analýza selhání & Anti-patterns

Chyba: Ponechání polovičatého kódu z předchozího pokusu

Nechat v projektu viset soubory ze zrušeného návrhu s myšlenkou „třeba se to bude ještě hodit“.

  • Agent tyto soubory najde při vyhledávání a začne je importovat.
  • Pravidlo: Zrušený směr nemilosrdně smažte z repozitáře (v Gitu zůstane v historii, pokud by byl potřeba).

🛠️ Inženýrský postup krok za krokem (Playbook)

  1. Přerušte práci.
  2. Zaktualizujte centrální specifikaci.
  3. Přegenerujte tickety.
  4. Vyčistěte sezení přes /clear a pokračujte s novou mapou.

🧪 Praktické cvičení (Hands-on Lab)

Úkol:

Vyzkoušejte si proceduru změny směru (Rerouting) na cvičném úkolu.