Navrhněte flow se svým agentem

V tomto návodu navrhnete obrazovky jednoho flow jako živé HTML se svým agentem, necháte tým, ať je okomentuje, publikujete verzi a uděláte z ní návrh, se kterým se porovná každá implementace. Potřebujete projekt, ve kterém už proběhl kaloko init, a scénář pro dané flow, třeba qa/flows/checkout.yml.

Přidejte designové prostředí

Designové prostředí je složka, kterou CLI při průchodu servíruje. Přidejte ho do kaloko.config.yml:

environments:
  design: { kind: design, serve: design }

Scénář zůstává stejný, jaký používá vývoj a QA: stejné kroky, stejná kritéria. Návrh se tak podle akceptačních kritérií zkontroluje dřív, než ho někdo začne stavět.

Nechte agenta nakreslit kroky

Požádejte agenta, s jakýmkoli design skillem, který váš tým používá:

Navrhni checkout flow do design/ podle našeho brand skillu: jedna složka na každý krok z qa/flows/checkout.yml, sdílené CSS v design/_shared, tokeny v design/tokens.json. Pak spusť kaloko walk a kaloko sync.

Z každého kroku vznikne design/<krok>/index.html: obyčejné HTML, CSS a JS, které se otevře i z disku. Odkazy mezi kroky jsou relativní, třeba ../payment/index.html.

Projděte, zkontrolujte a synchronizujte

npx kaloko start --scenario qa/flows/checkout.yml --env design
npx kaloko design lint
npx kaloko walk
npx kaloko sync

design lint zkontroluje složku podle pravidel přenosného HTML: relativní adresy, žádné CDN, žádné úložiště v prohlížeči, předvídatelný obsah. walk vykreslí jen kroky, které se změnily, a sync je uloží do společného konceptu a převezme kroky, které změnili ostatní.

Koncept designového flow
Koncept designového flow · cs · desktop

Jedna šablona v několika variantách

Některé kroky mají varianty: e-mail pro každý důvod, který může podpora vybrat, landing page pro každé město, kartu pro každý tarif. Ve scénáři z takového kroku udělejte stack krok a každé variantě dejte vlastní složku:

- id: credit
  kind: stack
  title: Kredit od podpory
  items: { urls: [refund, late, damaged] }
design/credit/index.html            přehled, nepovinný
design/credit/refund/index.html
design/credit/late/index.html
design/credit/damaged/index.html

Když items.urls složky nevyjmenuje, variantou je každá podsložka s index.html. walk vyfotí každou variantu v každém viewportu a na plachtě krok otevře seznam svých variant i s výsledky. Kliknutím variantu otevřete živě. design lint ohlásí složku varianty, které chybí index.html.

Webová písma a prototyp, který si pamatuje

Živé kroky načítají soubory jen ze složky s návrhem. Pokud vaše designy berou písma z Google Fonts, Adobe Fonts nebo z firemního CDN, admin organizace tyto adresy přidá v Nastavení → Zabezpečení → Písma a obrázky v designech. Zapište je i do prostředí:

environments:
  design: { kind: design, serve: design, origins: [https://fonts.googleapis.com, https://fonts.gstatic.com] }

design lint pak řekne, které z nich organizace ještě nepovolila. Z těchto adres se načtou styly, písma a obrázky, skripty nikdy.

Košík naplněný v jednom kroku se může ukázat v dalším: požádejte agenta, ať ho drží ve stavu prototypu (window.kaloko.state). Každý krok otevřený samostatně dál ukazuje svá ukázková data a Začít znovu v prezentaci košík zase vyprázdní.

Komentujte společně

Tým otevře koncept na plachtě, proklikne si živé kroky a připíná komentáře k prvkům. Každý vidí, kdo se právě dívá. Agent si komentáře přečte přes kaloko feedback, upraví, o co žádají, a synchronizuje znovu.

Živý designový krok
Živý designový krok · cs · desktop

Prázdné košíky a témata značek

Obrazovka, kterou lidé vidí jen v ideálním stavu, se bez těch ostatních i postaví. Vypište je u kroku a agent nakreslí pro každý stav stránku vedle stránky kroku:

  - id: cart
    states: [empty, error, loading]

design/cart/empty.html je prázdný košík, design/cart/error.html košík, který se nenačetl. Každý stav má vlastní snímek, komentáře i verdikty a na plachtě přibude vedle jazyka přepínač Stav kroku.

Sada tokenů s více režimy, třeba brand-a a brand-b, vykreslí každý krok v každém režimu s tokeny režimu jako CSS proměnnými a na plachtě přibude přepínač Režim tokenů. tokens_mode v prostředí zůstává výchozím režimem; token_modes: [brand-a, brand-b] vybere, které režimy se vykreslí. Samotný světlý a tmavý režim se dál řídí color_schemes: [light, dark].

Publikujte verzi

npx kaloko share --name "Checkout v2"

Tím publikujete verzi celého flow, třeba „v2 · 3 změněné, 17 beze změny“. Nezměněné kroky se ukládají jen jednou. share --notes-preview vám před publikováním ukáže poznámky o tom, co se změnilo.

Publikovaná verze
Publikovaná verze · cs · desktop

Udělejte z ní referenci

Až verzi někdo přijme, nastavte ji jako referenci designu (od plánu Team):

npx kaloko reference --design --version 2

U kroků implementace ve scénáři zapněte packs: [design]. Od plánu Business se pak každý běh implementace porovná s referencí: pixely, struktura, tokeny a kontrast, a kaloko drift napíše, který token použít tam, kde se kód liší.

Když máte návrh ve Figmě

Pokud návrh už žije ve Figmě, kaloko design import figma <adresa-souboru> --scenario qa/flows/checkout.yml udělá z framů designové kroky a z proměnných tokeny. Složka framů vyexportovaných z Figmy funguje i bez tokenu.

Kaloko · latest · 2026-11-21