Nápověda Kaloka

Jak Kaloko nastavit, projít aplikaci s agentem, zkontrolovat, co postavil, a z výsledku vést changelog a dokumentaci. Obrázky pocházejí ze schválených běhů samotného Kaloka, takže ukazují obrazovky tak, jak vypadají dnes. I tahle nápověda je živá dokumentace publikovaná v Kaloku.

Tutoriály #

• První běh za deset minut: instalace, přihlášení, průchod flow, sdílení a kontrola
• Navrhněte flow se svým agentem: živé HTML kroky, verze a reference designu

Kontrola a schválení #

• Projít běh: obrazovky běhu na plachtě jednu po druhé
• Schválit nebo vrátit běh: schválit kroky, které sedí, a vrátit ty ostatní
• Kontrolovat jen to, co se změnilo: režim kontroly, jeho klávesy a převzatá schválení
• Co je nového: novinky s obrázky před a po
• Předat podepsaný záznam o přijetí: doklad, kdo co převzal, a jak ho ověřit

Průchod a kontroly #

• Napsat scénář: flow, jeho kroky a co má každý krok ukázat
• Přidat kritéria a packy kontrol: automatické kontroly, otázky pro evaluátor, packy
• Projít víc prohlížečů a zařízení: WebKit, Firefox, telefony, tablety, tmavý režim
• Projít aplikace pro Android, iOS a desktop: emulátory, simulátory, Electron, macOS a Windows
• Natočit video průchodu: video a průběh každého kroku, jedno video celého běhu
• Spouštět Kaloko v CI a komentovat pull requesty: průchod každého preview nasazení
• Porovnat s referenčním během a ignorovat, co se mění pořád: rozdíly bez hodin a karuselů
• Kontrolovat stránky podle plánu (hostované běhy): prohlížeče Kaloka otevřou vaše stránky každý den nebo týden

Tým a přístup #

• Pozvat lidi a hosty: členové, hosté v jednotlivých projektech, čtenáři z vaší domény
• Role a API tokeny: kdo smí co, tokeny pro agenty a CI
• Nastavit firemní přihlášení: přihlašovací domény, dvoufázové ověření, SAML, OIDC a SCIM
• Připojit Jiru, Linear, Slack a Teams: úkoly z kroků a kanály po projektech

Changelog a dokumentace #

• Publikovat changelog s obrázky: připravit záznam, zapsat release, nasdílet ho
• Publikovat živou dokumentaci a hlídat zastaralé části: návody, jejichž obrázky drží krok s aplikací
• Exportovat dokumentaci a changelog: Markdown, Docusaurus, VitePress, MkDocs, HTML, PDF nebo JSON

Reference #

• Příkazy CLI: všechny příkazy kaloko
• Soubor scénáře: všechny klíče scénáře
• Kritéria, kontroly a packy: všechny typy kontrol a co který pack přidá
• Konfigurační soubor: kaloko.config.yml
• Nástroje MCP: co agenti zvládnou přes MCP

Vysvětlení #

• Jak Kaloko odpovídá vašim aplikacím: organizace, produkty, projekty, moduly, prostředí a verze
• Jak vznikají verdikty: kontroly, evaluátor a lidé
• Bezpečnost a vaše data: co opustí váš počítač a kdo to uvidí