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í.

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.

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.

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