Il collo di bottiglia non è più scrivere codice
Gli agenti di coding sanno già correre da soli verso un obiettivo — /loop, goal mode, esecuzioni autonome. Quello che un repo vuoto non può dargli è un modo per sapere che l'obiettivo è raggiunto. Indigo è il framework che chiude il loop: descrivi, costruisci, verifica, migliora, ripeti — finché «fatto» non sono check verdi e percorsi verificati, invece di una sensazione.
Perché «lascia fare all'agente» fallisce senza un framework
Punta un agente su un repo Next.js vuoto e chiedigli un prodotto: improvviserà delle fondamenta — auth fatta a mano, una tabella billing su misura, colla tra una dozzina di librerie senza alcun modello condiviso. Ogni passata successiva del loop costruisce sulla sabbia.
Il fallimento non è l'intelligenza — è l'ambiente. Il loop non ha una mappa del sistema, nessun segnale che gli dica cosa si è rotto e nessun modo di usare l'app che ha appena modificato.
Fondamenta improvvisate
Auth, billing, contenuti e job vengono reinventati al volo — in modo diverso a ogni sessione. È nelle cuciture tra loro che le app costruite dagli agenti marciscono.
Nessun segnale di feedback
Senza tipi rigorosi, test e health check, niente dice al loop che un'iterazione è andata storta. La deriva si accumula in silenzio.
Nessun modo di verificare
Un agente che può solo leggere il codice rilascia alla cieca. Ha bisogno di accedere, cliccare in giro e controllare il proprio lavoro come farebbe un utente — la maggior parte delle codebase non gliene dà modo.
Sei cose che servono a un loop auto-migliorante. Indigo le fornisce tutte e sei.
Questo è l'intero brief di progettazione. Tutto ciò che c'è nel framework esiste perché una di queste sei mancava ovunque altrove.
Una mappa
I file CLAUDE.md annidati spiegano l'intento a ogni livello; indigo visualize e indigo map rendono l'architettura live in diagrammi e mappe del codice che l'agente può interpretare. Orientarsi è un comando, non una spedizione.
Un segnale
TypeScript strict, input vincolati con Zod, test e indigo doctor valutano ogni passata. Il loop sa immediatamente — e meccanicamente — quando sbaglia e quando ha finito.
Mani
L'endpoint MCP trasforma ogni procedura tRPC in uno strumento tipizzato, e le personas precaricate permettono all'agente di accedere e usare l'app come utente free, abbonato o admin. Verifica come un cliente, non come un linter.
Guardrail
Open-closed by design: un tipo di contenuto è una voce di config, una funzionalità è un modulo, un job è una chiamata di registrazione. L'agente estende senza toccare il codice condiviso, così il raggio d'impatto di ogni passata resta piccolo.
Iterazioni economiche
Documentazione pointer-first, cablaggio generato e contesto delimitato per modulo tengono ogni passata leggera in token. Un loop che non puoi permetterti di eseguire non è un loop — l'efficienza in token è una funzionalità, non un caso.
Niente che blocchi
Setup, installazione dei moduli, migrazioni e controlli girano tutti attraverso CLI non interattive. Nessun prompt nascosto del terminale blocca mai il loop; quando una decisione spetta a te, l'agente te lo chiede in chat.
Un framework coeso che l'agente estende, mai modifica
Ogni livello conosce già gli altri
Indigo è un unico sistema type-safe. L'auth conosce le organizzazioni. Il billing conosce l'auth. CMS, job, livello real-time e pannello admin condividono un solo modello dati e un solo insieme di convenzioni — così il mese da idraulico sparisce, per gli umani come per gli agenti.
Open-closed by design
Le nuove capacità si registrano da sole. Un tipo di contenuto è una voce di config. Una funzionalità è un modulo. Un job in background è una chiamata di registrazione. L'agente aggiunge ciò che descrivi senza toccare il codice condiviso — così gli aggiornamenti restano puliti e il loop si può rilanciare in sicurezza anche domani.
Il loop non va in pensione quando la funzionalità è rilasciata
«Feature-complete» è il punto in cui la maggior parte delle codebase smette di essere sicura da toccare. Indigo è costruito per l'opposto: gli stessi binari che fanno convergere la prima build rendono il miglioramento continuo una routine. L'agente può continuare a iterare sul prodotto che ha costruito — correggendo ciò che doctor segnala, estendendo la copertura dei test dove è scappata una regressione, traducendo i nuovi contenuti nelle tue lingue, mantenendo validi sitemap, feed e dati strutturati man mano che il prodotto cresce.
Ogni passata di miglioramento ha la stessa forma della prima: leggi la mappa, fai una piccola modifica registrata, fatti valutare, verifica come utente. È questo che «auto-migliorante» significa qui — niente magia, solo un loop che non perde mai l'equilibrio. La ricetta, pianificazione e guardrail inclusi, è documentata nella guida all'Improvement Loop.
Cosa ti dà davvero costruire su Indigo
I vantaggi che si accumulano — per l'agente che fa il lavoro e per l'umano a cui appartiene il risultato.
CLAUDE.md pointer-first, indigo map, diagrammi Mermaid live e /llms.txt fanno sì che l'agente si orienti da una mappa invece di rileggere la codebase. Una parte più grande di ogni sessione va nel tuo prodotto.indigo doctor valida l'intera installazione.degit non porta con sé la history, bun run init crea un repo nuovo di zecca. Tipizzato, testato, leggibile, tuo sotto Apache-2.0.Servizio completo, non black box
Tu descrivi; l'agente esegue — comandi inclusi. Setup, installazione dei moduli, migrazioni e controlli girano attraverso CLI non interattive progettate perché niente si blocchi mai su un prompt nascosto del terminale. Quando una decisione spetta a te, l'agente te lo chiede in chat.
E tutto resta una codebase vera: tipizzata, testata, revisionabile, tua sotto Apache-2.0. degit non porta con sé la history, bun run init crea un repository nuovo di zecca, e puoi prendere il volante in qualsiasi momento.
Open core, con licenza permissiva
Il framework e i suoi moduli gratuiti sono open source sotto la licenza permissiva Apache-2.0 — usali per qualsiasi cosa, incluso il lavoro commerciale closed-source, senza obbligo di copyleft e senza nulla da comprare. Tre moduli verticali premium — e-commerce, chat con personaggi AI e generazione di contenuti AI — hanno licenza commerciale e finanziano lo sviluppo continuo del core gratuito.
Guarda il loop con i tuoi occhi
Il modo più veloce per capire Indigo è puntarci sopra il tuo agente. La demo live è un'installazione completa con ogni modulo attivo — e anche il sito che stai leggendo è un'installazione Indigo.