Come Domare il Caos nello Sviluppo AI con Comet
Una storia familiare: lanci un agente AI, inizia allegramente a scrivere codice, e dieci minuti dopo scopri che sta "allucinando", sovrascrivendo file funzionanti, o semplicemente bloccato in un loop infinito sullo stesso errore. Siamo abituati a lavorare con gli LLM nel coding essere o sessioni di chat brevi o agenti autonomi imprevedibili che necessitano di supervisione costante.
Recentemente mi sono imbattuto in un progetto interessante chiamato Comet. Non è solo un altro wrapper attorno alle API di OpenAI o Claude. Gli sviluppatori lo posizionano come un "workflow di task lunghi e riprendibili". In termini semplici: è un framework che fa lavorare la rete neurale secondo un protocollo rigoroso, non perde il contesto quando viene fermato, e attraversa tutte le fasi di un normale ciclo di sviluppo — dalla progettazione alla verifica.
Perché preoccuparsi quando hai Cursor o Claude Code
Sembra logico chiedersi perché costruire qualcosa di complesso quando gli IDE moderni e gli strumenti CLI gestiscono le cose abbastanza bene? Il problema è la disciplina. Un agente normale spesso salta direttamente al codice, saltando la fase di progettazione corretta. Comet impone un approccio architetturale.
Il progetto combina due metodologie: OpenSpec (cosa stiamo facendo) e Superpowers (come lo stiamo facendo). L'intero processo è suddiviso in cinque fasi:
- Open — preparare la proposta e scomporre i task.
- Deep Design — progettazione dettagliata e creazione del Design Doc.
- Plan & Build — creare il piano di implementazione e i commit effettivi.
- Verify & Finish — test e report di verifica.
- Archive — sincronizzare le specifiche e archiviare le modifiche.
Interessante: l'agente fisicamente non può passare alla fase successiva finché il "guard" (script di verifica) non viene attivato. Ad esempio, non ti permetterà di chiudere un task se non c'è un report dei test o se la struttura .comet.yaml viene violata.
Come funziona nella pratica
L'installazione è standard per gli strumenti Node:
npm install -g @rpamis/comet
cd your-project
comet init
Dopo l'inizializzazione, nel tuo progetto appariranno le configurazioni e un set di skill per la piattaforma selezionata (sono supportate più di 30 piattaforme, tra cui Claude Code, Cursor, Windsurf e persino GitHub Copilot).
La funzionalità principale che mi è piaciuta è il comando /comet. Funziona come punto di ingresso con memoria. Se hai messo in pausa il lavoro, sei andato a prendere un caffè, o hai riavviato il computer, /comet determinerà in quale fase il processo si è fermato e ti offrirà di riprendere esattamente da quel punto. Non hai bisogno di ri-alimentare il contesto all'agente o di ricordargli cosa avevi intenzione di fare.
A proposito, per chi impara meglio visivamente c'è comet dashboard. È un server locale che apre una dashboard ordinata nel tuo browser mostrando tutte le modifiche attive, i progressi dei task e la cronologia dell'archivio. È molto più bello di un log infinito nel terminale.
I Tre Pilastri di Comet
Nella versione 0.4.0, gli sviluppatori hanno evidenziato tre scenari principali che coprono il 90% delle esigenze:
- Coding tramite
/comet: Il workflow principale dove l'agente ti guida passo dopo passo attraverso le fasi. - Creare skill tramite
/comet-any: Ti permette di costruire le tue catene di azioni (skill) e impacchettarle in distribuzioni. - Valutazione tramite
comet eval: Questa è probabilmente la parte più tecnicamente potente. Invece di indovinare "il mio agente è diventato più intelligente?", lo esegui attraverso test con metriche Pass@k e Pass^k. Puoi persino integrarlo con LangSmith per un monitoraggio serio in produzione.
Interni Tecnici
Il progetto è scritto in JavaScript/TypeScript e gira come un puro runtime Node.js. Questo è un grande vantaggio perché in precedenza strumenti simili spesso richiedevano Bash o WSL su Windows, creando grattacapi extra durante la configurazione.
L'architettura di Comet è costruita sulla gestione dello stato attraverso file YAML. Nella cartella openspec/changes/<name>/ viene creato un file .comet.yaml che memorizza tutto: dalla fase corrente e la modalità di build selezionata ai percorsi della documentazione e i risultati della verifica.
Un dettaglio interessante per chi è attento ai token: Comet ha una modalità context_compression. Durante la transizione da design a build, lo script comet-handoff.mjs comprime il contesto, rimuovendo l'eccesso. Secondo i test dell'autore, questo risparmia circa il 25-30% dei token di input senza perdere qualità del codice. Per progetti grandi su Claude 3.5 Sonnet, questo può far risparmiare una bella somma sul tuo conto.
Vale la pena provarlo
Comet è uno strumento per chi ha superato la fase "scrivimi una funzione Python" e vuole costruire qualcosa di complesso e mantenibile con l'AI. È adatto a te se:
- Sei stanco di modifiche caotiche dell'agente che rompono il progetto in posti inaspettati.
- Hai bisogno di trasparenza: cosa esattamente l'agente sta facendo adesso e perché.
- Vuoi automatizzare task di routine come aggiornare il Design Doc dopo aver fatto modifiche al codice.
Dagli svantaggi, posso notare che la curva di apprendimento è comunque più ripida rispetto a una chat normale. Devi abituarti alla struttura delle cartelle openspec/ e docs/superpowers/. Ma se stai lavorando su un progetto a lungo termine, questa disciplina ripagherà con l'assenza di debito tecnico, che le reti neurali generano molto rapidamente.
Puoi controllare il codice sorgente e la documentazione nel repository rpamis/comet. Il progetto si sta sviluppando attivamente, e a giudicare dai commit, gli autori sono seri nel renderlo un "framework" affidabile per ingegneri autonomi.
Progetti correlati