Dlaczego zbudowaliśmy Indigo

Wąskim gardłem nie jest już pisanie kodu

Agenci kodujący już dziś potrafią pracować bez nadzoru w stronę celu — /loop, tryb celu, autonomiczne przebiegi. Czego nie da im puste repo, to sposobu, by wiedzieć, że cel został osiągnięty. Indigo to framework, który domyka pętlę: opisz, zbuduj, zweryfikuj, ulepsz, powtórz — aż „gotowe” będzie oznaczać zielone kontrole i zweryfikowane ścieżki, a nie przeczucie.

Problem

Dlaczego „niech agent to po prostu zbuduje” zawodzi bez frameworka

Skieruj agenta na puste repo Next.js i poproś o produkt, a zaimprowizuje fundament: ręcznie sklecony auth, autorską tabelę billingu, klej między tuzinem bibliotek bez wspólnego modelu. Każdy kolejny przebieg pętli buduje na piasku.

To nie inteligencja zawodzi — zawodzi środowisko. Pętla nie ma mapy systemu, nie ma sygnału mówiącego, co się zepsuło, i nie ma jak użyć aplikacji, którą właśnie zmieniła.

Zaimprowizowane fundamenty

Auth, billing, treści i zadania w tle są wymyślane na nowo w locie — w każdej sesji inaczej. To na szwach między nimi gniją aplikacje budowane przez agentów.

Brak sygnału zwrotnego

Bez ścisłych typów, testów i kontroli zdrowia nic nie mówi pętli, że iteracja poszła źle. Dryf narasta po cichu.

Brak sposobu na weryfikację

Agent, który umie tylko czytać kod, wypuszcza zmiany w ciemno. Musi się zalogować, poklikać i sprawdzić swoją pracę tak, jak zrobiłby to użytkownik — a większość codebase'ów nie daje mu takiej możliwości.

Anatomia

Sześć rzeczy, których potrzebuje samodoskonaląca się pętla. Indigo dostarcza wszystkie sześć.

To cały brief projektowy. Wszystko w tym frameworku istnieje dlatego, że jednej z tych rzeczy brakowało wszędzie indziej.

Mapa

Zagnieżdżone pliki CLAUDE.md wyjaśniają intencję na każdej warstwie; indigo visualize i indigo map renderują żywą architekturę jako diagramy i mapy kodu, które agent umie sparsować. Orientacja to jedno polecenie, nie wyprawa.

Sygnał

Ścisły TypeScript, wejścia ograniczone Zodem, testy i indigo doctor oceniają każdy przebieg. Pętla wie natychmiast — i mechanicznie — kiedy się myli i kiedy skończyła.

Ręce

Endpoint MCP zamienia każdą procedurę tRPC w otypowane narzędzie, a seedowane persony pozwalają agentowi zalogować się i używać aplikacji jako darmowy użytkownik, subskrybent albo administrator. Weryfikuje jak klient, nie jak linter.

Barierki

Open-closed z założenia: typ treści to wpis w konfiguracji, funkcja to moduł, zadanie to wywołanie rejestracji. Agent rozszerza system, nie dotykając wspólnego kodu, więc zasięg rażenia każdego przebiegu pozostaje mały.

Tanie iteracje

Dokumentacja pointer-first, generowane podpięcia i kontekst ograniczony do modułu utrzymują każdy przebieg na tokenowej diecie. Pętla, na którą cię nie stać, nie jest pętlą — efektywność tokenowa to funkcja, nie przypadek.

Nic, co blokuje

Instalacja, dodawanie modułów, migracje i kontrole działają przez nieinteraktywne CLI. Żaden ukryty prompt w terminalu nigdy nie zatrzymuje pętli; gdy decyzja należy do ciebie, agent pyta na czacie.

Podejście

Jeden spójny framework, który agent rozszerza — nigdy nie edytuje

Każda warstwa już wie o pozostałych

Indigo to jeden otypowany system. Auth wie o organizacjach. Billing wie o auth. CMS, zadania w tle, warstwa czasu rzeczywistego i panel administracyjny dzielą jeden model danych i jeden zestaw konwencji — więc miesiąc hydrauliki znika, tak dla ludzi, jak i dla agentów.

Open-closed z założenia

Nowe możliwości rejestrują się same. Typ treści to wpis w konfiguracji. Funkcja to moduł. Zadanie w tle to wywołanie rejestracji. Agent dodaje to, co opiszesz, nie dotykając wspólnego kodu — więc aktualizacje pozostają czyste, a pętlę można bezpiecznie uruchomić znowu jutro.

Samodoskonalenie

Pętla nie przechodzi na emeryturę, gdy funkcja trafia na produkcję

„Feature-complete” to moment, w którym większości codebase'ów nie da się już bezpiecznie dotykać. Indigo jest zbudowane na odwrót: te same szyny, dzięki którym pierwsza budowa zbiega do celu, czynią ciągłe ulepszanie rutyną. Agent może dalej krążyć w pętli nad produktem, który zbudował — naprawiać to, co flaguje doctor, rozszerzać pokrycie testami tam, gdzie prześlizgnęła się regresja, tłumaczyć nowe treści na twoje języki, utrzymywać sitemapy, kanały RSS i dane strukturalne w porządku w miarę wzrostu produktu.

Każdy przebieg ulepszeń ma ten sam kształt co pierwszy: przeczytaj mapę, wprowadź małą, zarejestrowaną zmianę, odbierz ocenę, zweryfikuj jako użytkownik. To właśnie znaczy tu „samodoskonalący się” — żadnej magii, po prostu pętla, która nigdy nie traci gruntu pod nogami. Przepis, wraz z harmonogramem i barierkami, jest opisany w przewodniku po pętli ulepszeń.

Zysk

Co naprawdę daje budowanie na Indigo

Korzyści, które się kumulują — dla agenta, który wykonuje pracę, i dla człowieka, do którego należy wynik.

Efektywność tokenowa — pliki CLAUDE.md w duchu pointer-first, indigo map, generowane na żywo diagramy Mermaid i /llms.txt sprawiają, że agent orientuje się z mapy, zamiast czytać codebase od nowa. Więcej z każdej sesji idzie w twój produkt.
Porządna architektura od pierwszego dnia — otypowana, open-closed, z wyraźnymi granicami modułów. Struktura przy setnej iteracji to ta sama struktura co przy pierwszej.
Każdy prymityw SaaS podpięty z góry — auth, organizacje, RBAC, płatności, subskrypcje, zadania w tle, czas rzeczywisty, e-mail, storage. Miesiąc klejenia po prostu się nie wydarza.
Prawdziwy CMS — typy treści sterowane konfiguracją, historia wersji, biblioteka mediów, planowana publikacja, shortcode'y i kalendarz treści, wszystko w zestawie.
Wielojęzyczność dostarczana przez agenta — 17 języków z routingiem przez proxy i fallbackiem per typ treści. Opisz stronę raz; agent tłumaczy każdy język — 17 języków tej strony powstało dokładnie w ten sposób. Wyjście na rynki międzynarodowe to prompt, nie projekt.
SEO na autopilocie — kanoniczne URL-e, hreflang, wielojęzyczne sitemapy, JSON-LD, Open Graph i RSS generowane z twoich treści.

Bezpieczeństwo typów od końca do końca — jeden otypowany łańcuch od PostgreSQL przez Drizzle i tRPC aż po klienta. To zarazem główny sygnał błędu pętli.
Wbudowana samoweryfikacja — każda procedura tRPC to otypowane narzędzie MCP; seedowane persony pozwalają agentowi testować jako free, pro albo admin; indigo doctor weryfikuje całą instalację.
Modułowy wzrost — 15+ samodzielnych modułów instalowanych jednym poleceniem, podpinanych generowanym kodem i usuwalnych, gdy z nich wyrośniesz.
Panel administracyjny od pierwszego dnia — treści, media, użytkownicy, formularze, pola niestandardowe, dziennik audytu i statystyki, bez budowania back office'u na start.
Gotowe operacyjnie — jeden obraz Dockera skalowany jedną zmienną roli, endpoint zdrowia i hooki monitoringu gotowe pod twojego dostawcę.
Brak lock-inudegit nie zabiera historii, bun run init tworzy świeże repo. Otypowane, przetestowane, czytelne — twoje na licencji Apache-2.0.

Kontrola zostaje u ciebie

Pełna obsługa, nie czarna skrzynka

Ty opisujesz; agent wykonuje — łącznie z poleceniami. Instalacja, dodawanie modułów, migracje i kontrole działają przez nieinteraktywne CLI zaprojektowane tak, by nic nigdy nie utknęło na ukrytym promptcie w terminalu. Gdy decyzja należy do ciebie, agent pyta na czacie.

A wszystko pozostaje prawdziwym codebase'em: otypowanym, przetestowanym, możliwym do przejrzenia, twoim na licencji Apache-2.0. degit nie zabiera historii, bun run init tworzy świeże repozytorium, a ty możesz przejąć stery w każdej chwili.

Domyślnie otwarte

Otwarty rdzeń na liberalnej licencji

Framework i jego darmowe moduły są open source na liberalnej licencji Apache-2.0 — używaj ich do czegokolwiek, w tym do zamkniętoźródłowej pracy komercyjnej, bez obowiązku copyleft i bez niczego do kupienia. Trzy wertykalne moduły premium — e-commerce, czat z postaciami AI i generowanie treści AI — są licencjonowane komercyjnie i finansują dalszy rozwój darmowego rdzenia.

Zobacz pętlę na własne oczy

Najszybszy sposób, by zrozumieć Indigo, to skierować na nie swojego agenta. Demo na żywo to pełna instalacja z włączonymi wszystkimi modułami — a strona, którą czytasz, sama jest instalacją Indigo.