Roundly for Laravel: register balíkov pre AI agentov

3. októbra sme zverejnili vyše 50 Laravel balíkov ako open source. Dnes pridávame to, vďaka čomu ich dostanete priamo do rúk svojho AI agenta: Roundly for Laravel, register všetkých balíkov napísaný tak, aby ho agent vedel čítať, a jeden prompt, ktorý mu povie, ako s ním pracovať. Vy opíšete aplikáciu. Agent si z registra vyberie balíky, nainštaluje ich cez Composer, pred písaním kódu si prečíta dokumentáciu každého z nich a sám naprogramuje len to, čo žiadny balík nepokrýva.

Prečo AI agenti stavajú znova to, čo už existuje

Keď AI agenta požiadate o aplikáciu s prihlasovaním, platbami, tímami a schvaľovaním, zvyčajne sa vydá jednou z dvoch ciest. Buď napíše každú funkciu od nuly — nové prihlasovanie, novú evidenciu kreditov, nový schvaľovací engine — a vy dostanete čerstvý, nikým neskontrolovaný kód, ktorý odteraz udržiavate. Alebo siahne po knižnici tretej strany, ktorú si najlepšie pamätá, takže o vašich závislostiach rozhoduje pamäť modelu, a nie niekto z vášho tímu.

Najdrahšie je však tretie zlyhanie: hádanie. Agent, ktorý vie, že balík existuje, no jeho dokumentáciu nikdy nečítal, napíše volania, ktoré vyzerajú správne — s vierohodnými názvami tried aj signatúrami metód — a za behu zlyhajú. Ako sme písali v článku Open source v ére agentického kódovania, zriedka ide o zlyhanie uvažovania. Sú to rozumné odhady oproti API, ktoré agentovi nikto neukázal.

Jeden súbor, ktorý agent prečíta ako prvý

Roundly for Laravel je jediný Markdown súbor, REGISTRY.md, vo verejnom repozitári roundly-for-laravel na GitHube. Obsahuje vyše 50 našich open source Laravel balíkov v siedmich kategóriách, od autentifikácie a e-commerce po tímy, dáta a infraštruktúru. Každý záznam má rovnakých päť častí:

• Jednovetový popis toho, čo balík robí. S týmto riadkom agent porovnáva funkcie vašej aplikácie.
• Tagy, ktoré pokrývajú problém, bežné synonymá a štandardy, aby „magic link“ alebo „RBAC“ viedli k správnemu balíku.
• Presný inštalačný príkaz.
• Odkaz na kompletnú dokumentáciu balíka na našom webe.
• GitHub repozitár.

Takto vyzerá jeden záznam presne v podobe, v akej ho číta agent:

### auth-for-laravel
Headless multi-guard auth: password, magic-link, email OTP and passkey login, 2FA challenges, JWT access + rotating refresh tokens, device sessions, invitations, email verification, password reset.
- tags: `authentication` `login` `2fa` `passkeys` `magic-link` `otp` `sessions` `password-reset`
- install: `composer require roundly-consulting/auth-for-laravel`
- docs: https://roundly-consulting.com/open-source/docs/auth-for-laravel
- repo: https://github.com/roundly-consulting/auth-for-laravel

Hlavička registra uvádza požiadavky raz pre všetky balíky: každý beží na PHP ^8.4 a Laraveli 12 alebo 13. Register je zámerne len index. Kompletná dokumentácia každého balíka — inštalácia, konfigurácia, migrácie a celé API — je v našom open source katalógu a každý záznam na ňu odkazuje priamo.

Šesť inštrukcií napísaných pre agenta

Nad záznamami register agentovi vysvetľuje, ako s ním pracovať. Týchto šesť inštrukcií je súčasťou súboru, takže platia bez ohľadu na to, akým promptom prácu začnete:

• Porovnať úlohu s popisom a tagmi každého záznamu a uprednostniť balík zo zoznamu pred vlastnou implementáciou aj pred inou knižnicou tretej strany.
• Inštalovať príkazom uvedeným v zázname.
• Pred písaním kódu si prečítať dokumentáciu balíka a nikdy si nevymýšľať názvy tried či metód len podľa indexu.
• Balíky na seba nadväzujú: auth-for-laravel si pritiahne jwt, passkeys, two-factor a refresh-tokens. To vyrieši Composer, preto stačí vyžadovať len balíky, ktoré používate priamo.
• Za behu závisia balíky len od Laravelu, Symfony a ďalších balíkov Roundly, od nikoho iného.
• Väčšina balíkov ponúka jedno API tromi spôsobmi: ako fasádu, injektovateľný manažér a jednoúčelové triedy akcií. Balíky s vedľajšími účinkami majú pre testy Facade::fake().

Najväčšiu váhu má tretia inštrukcia. Index stačí na to, aby agent balík vybral, nikdy však nestačí na to, aby ho správne zavolal — preto ho register pošle do dokumentácie skôr, než proti balíku napíše prvý riadok. Šiesta uzatvára kruh: testy, ktoré agent napíše pre volania balíkov, nevolajú skutočné služby, ale ich fake verzie.

Na začiatok stačí jeden prompt

Samotný register nikam nevkladáte. Agentovi vložíte jeden prompt, ktorý naň odkazuje, a jeho prvý riadok nahradíte popisom svojej aplikácie: čo robí, kto ju používa a aké sú jej hlavné funkcie.

<describe your app: what it does, who uses it, its main features>

Build this app with Laravel. Use Roundly packages for as many features as possible:
pick them from the registry below, install them with Composer and read each package's
documentation before writing code against it. Hand-roll only what no package covers.

Registry: https://raw.githubusercontent.com/roundly-consulting/roundly-for-laravel/main/REGISTRY.md

Pomenujte funkcie, nie balíky. Agent porovná každú funkciu s registrom, takže čím konkrétnejší popis, tým väčšiu časť aplikácie pokryje otestovaným kódom namiesto nového. Príklad z README repozitára:

A cashback program for a merchant network: merchants manage their store team with roles,
customers earn cashback credits in their own currency and log in with magic links, and the
network runs promo campaigns to all members.

Ide o cashbackový program pre sieť obchodníkov: obchodníci spravujú tím svojej predajne s rolami, zákazníci zbierajú cashbackové kredity vo vlastnej mene a prihlasujú sa cez magic link a sieť posiela promo kampane všetkým členom. Tento jediný riadok pokryje šesť balíkov:

• Tím predajne s rolami: teams-for-laravel a permissions-for-laravel.
• Cashbackové kredity vo vlastnej mene zákazníka: credits-for-laravel a money-for-laravel.
• Prihlasovanie cez magic link: auth-for-laravel.
• Promo kampane pre všetkých členov: campaigns-for-laravel.

Zostáva to, čo žiadny balík vedieť nemôže: pravidlá cashbacku, spôsob, akým sa obchodníci pridávajú do siete, a ktorá kampaň ide komu. Práve tam má agent vynaložiť svoje úsilie — a keď základy nainštaluje namiesto toho, aby ich generoval, naozaj môže.

Zadarmo, rovnako ako balíky

Register je verejný a všetky balíky, ktoré obsahuje, sú zadarmo pod licenciou MIT. Udržať to tak je priebežná práca: držať krok s novými verziami Laravelu a PHP, opravovať nahlásené chyby a pridávať nové balíky, každý s vlastným záznamom v registri. Ak register ušetrí vášmu agentovi písanie funkcie od nuly, jednorazový príspevok, členstvo na Patreone alebo príspevok v kryptomenách pomôže financovať údržbu, nové funkcie aj nové balíky.

Vyskúšajte ho na ďalšej aplikácii

V dokumentácii Roundly for Laravel nájdete prompt, formát registra aj kompletné inštrukcie pre agentov. Skopírujte prompt, opíšte svoju aplikáciu a výber balíkov nechajte na agentovi. Register má aj vlastnú sekciu na našej open source stránke, priamo pri kompletnom katalógu balíkov.

Rovnaké balíky nesú aj webové aplikácie a AI agentov, ktorých staviame pre klientov. Ak by ste aplikáciu postavenú na nich radšej zverili seniornému tímu, pozrite si možnosti použitia, v ktorých uvidíte, aké systémy dodávame, a potom nám napíšte, čo potrebujete. Do 48 hodín dostanete konkrétny návrh.