Cosa fa Maestro di osFoundry, una chat IA che mostra ogni passaggio compiuto

Sono le 4:40 di un giovedì e Priya ha chiesto a un assistente IA di aggiungere un pulsante "Elimina account" alla pagina delle impostazioni della sua app. La risposta dice "Fatto, 4 file modificati." Prima di rilasciare vuole sapere quali sono questi quattro file, cosa ha letto l'assistente per decidere e se si è avvicinato al codice di fatturazione. Una normale finestra di chat le dà solo l'ultimo paragrafo.

Maestro in un paragrafo

Maestro è lo spazio di lavoro IA con tutti gli strumenti dentro l'app desktop di osFoundry. Scrivi la richiesta come in qualsiasi chat, ma la risposta arriva con il suo percorso di lavoro: ogni file elencato, ogni ricerca eseguita, ogni file letto o modificato e ogni comando da terminale, ciascuno sulla propria riga con una durata che puoi espandere. Può lavorare dentro una cartella del tuo computer, proporre modifiche invece di scriverle in silenzio e fermarsi a mostrarti un piano prima di toccare qualsiasi cosa. Lo trovi alla voce Maestro nella barra laterale. Se hai usato ChatGPT o Claude nel browser, pensa alla stessa conversazione, con accanto il registro delle attività dell'agente e un paio di freni.

Un giro della schermata

• Le schede di superficie in alto. Maestro, Model chat, Multi chat, Research, Wiki e Code stanno tutte in questa stessa schermata. Maestro è la scheda con il set completo di strumenti.
• Le schede di dettaglio sopra la conversazione: Chat, Sources, Files, Changelog, Tools, Pipeline e Logs. Sono viste diverse della stessa esecuzione. Sources conserva ciò su cui si basa la risposta, Changelog elenca i file scritti da questa chat e Logs mostra i passaggi e, sotto Costs, quanto è costata ogni richiesta.
• Le righe di processo nella trascrizione. Qui Maestro ha elencato src/ (38 file), ha fatto grep di deleteUser, ha trovato 0 risultati e poi ha letto account.ts e users.ts. Clicca su una riga e si apre mostrando l'input e l'output esatti di quella chiamata allo strumento.
• La barra di controllo sopra la casella del messaggio: l'interruttore della sandbox, Plan OFF/ON, Tools e Goal. Sotto la casella ci sono i selettori di cartella, progetto, repo, Router e modello.
• Il pannello di anteprima a destra, dove un file, un diff o una pagina web si apre accanto alla conversazione invece di sostituirla (Open File / App / Page, Browse Files, Browser).

Tre modi di usarlo

Una sviluppatrice solitaria che vuole il piano prima della modifica

Il caso di Priya dell'inizio. La modifica tocca account e sessioni, quindi preferisce leggere il piano piuttosto che revisionare un diff a sorpresa.

1. Clicca su Plan nella barra di controllo, così compare Plan ON.
2. Scrive "Add a Delete account button to settings" e invia.
3. Maestro legge sei file e non ne modifica nessuno. Con la modalità piano attiva è l'app desktop stessa a rifiutare qualsiasi strumento che scriva un file o esegua un comando, quindi "sola lettura" non è una gentile richiesta nel prompt.
4. Arriva una scheda Plan con la dicitura "Awaiting approval" e i pulsanti Approve e Cancel.

Il piano dell'esempio nomina quattro file, dice che src/billing/ resta intatto perché Stripe tiene i propri record e si chiude con "Nothing has been changed yet." La modalità piano si disattiva da sola quando arriva il piano. Priya clicca Approve e solo allora Maestro modifica i quattro file ed esegue i test (npm test -- account, 3 passed), tutto visibile come righe EDIT e TERMINAL. Se il piano non l'avesse convinta, Cancel avrebbe lasciato la cartella esattamente com'era.

Cosa ottiene: una modifica approvata in anticipo e una trascrizione che mostra dove l'agente ha guardato e cosa ha eseguito.

Un nuovo collega che si orienta in una codebase

Dan è entrato nel team lunedì. Deve capire dove si trova il blocco del login, ma nel codice nessuno lo chiama "lockout", quindi una ricerca testuale non trova niente.

1. In Indexes aggiunge una volta la cartella del progetto, così si può cercare per significato.
2. In una chat di Maestro su quella cartella chiede dove l'app blocca gli utenti dopo i login falliti.
3. Segue le righe di processo: una ricerca nella cartella che restituisce 2 risultati, poi un READ di throttle.ts.

La risposta indica src/auth/throttle.ts (righe 1–46) e src/routes/session.ts (righe 22–61) e spiega che il codice non dice mai "lock out": dopo cinque tentativi falliti imposta un periodo di attesa di 15 minuti e restituisce 429 prima ancora di controllare la password. Visto che la risposta riporta i percorsi dei file e le righe mostrano cosa è stato letto, Dan può aprire quelle stesse righe nel pannello di anteprima e verificare da solo invece di fidarsi di un riassunto. In questo caso nulla viene scritto su disco, quindi può lasciare Approval Mode sul valore predefinito.

Cosa ottiene: i due file che contano, il motivo per cui la ricerca per parola chiave non li trovava e una chat a cui tornare dall'elenco delle chat.

Una persona del marketing che modifica testi in un repo non suo

Sammy scrive i testi della pagina di lancio, ma la pagina è un file React nel repo dell'engineering. Vuole che il nuovo testo rispetti la guida al tono in docs/ e non vuole che venga fatto commit di nulla senza averlo visto.

1. Apre il menu Approval Mode del composer e sceglie Permission & Approve, che chiede conferma prima delle chiamate agli strumenti. Le altre opzioni sono Auto Accept (predefinita, gli strumenti partono subito), Plan First (pianificare prima di eseguire) e Bypass (nessuna approvazione, nemmeno per push e invio di form).
2. Attiva la sandbox, così le scritture vengono preparate su un branch invece di finire nella cartella di lavoro.
3. Chiede a Maestro una bozza della pagina di lancio coerente con la documentazione. Legge docs/tone.md, cerca nel codice e propone una modifica a src/Launch.tsx.
4. Il diff si apre nel pannello di anteprima. Lo accetta e poi usa Export to branch perché un ingegnere possa revisionarlo come qualsiasi altra modifica.

Cosa ottiene: un testo che cita la guida al tono seguita (la scheda Sources la conserva), un diff revisionato e un branch invece di una sorpresa su main.

Dove si colloca Maestro rispetto a Model chat, Chat e Multi chat

Maestro condivide la schermata con fratelli più semplici, e scegliere quello giusto fa risparmiare tempo e soldi.

• Model chat è una scheda della stessa schermata che invia ogni turno a un solo modello scelto da te. È una conversazione in sola lettura: niente cartella, niente strumenti che agiscono, niente approvazioni. Ottima per una domanda veloce.
• Chat ha un posto tutto suo nella barra laterale. Anche qui risponde un modello scelto per l'intera conversazione, ma mantiene le funzioni sui file, quindi può proporre una modifica che accetti (Accept) o rifiuti (Reject), archiviata in Changelog. Usala quando vuoi che sia un modello specifico a fare il lavoro, senza un router che sceglie per te.
• Multi chat pone la stessa domanda a più modelli contemporaneamente. In Compare leggi le risposte affiancate; in Council i modelli rispondono, valutano alla cieca le risposte degli altri e un modello scrive una sintesi.

Da Maestro il lavoro passa spesso ad altre parti dell'app. Research trasforma una domanda in un report con fonti, Code esegue un agente di programmazione sul proprio branch, Indexes rende una cartella ricercabile per significato (come nel caso di Dan) e Version → Merge Station è il punto in cui si fa il merge delle modifiche della sandbox. Se un turno va storto, scrivere /rewind nella chat ripristina i file modificati da quel turno. Per approfondire, la pagina sull'orchestrazione di Maestro passa in rassegna le schede di dettaglio e la pagina sulla modalità piano spiega il flusso di approvazione.

Le prime domande che si fanno tutti

La modalità piano è solo un'istruzione nel prompt?
No. Finché Plan è su ON, ogni strumento che non è nella lista di sola lettura viene rifiutato quando l'app lo avvia, quindi l'agente può leggere, cercare e navigare, ma non può modificare né eseguire comandi finché non approvi il piano.

Che differenza c'è tra l'interruttore Plan e Plan First in Approval Mode?
Plan è un interruttore una tantum per la richiesta successiva: indagare, presentare un piano, aspettare. Approval Mode è la regola permanente della chat per le chiamate agli strumenti, da Auto Accept a Bypass. Plan First è una delle sue quattro impostazioni.

Le righe di processo sono tante. Posso nasconderle?
Sì. L'impostazione Process Detail passa da Full a Compact e viceversa. Cambia solo come vengono mostrati i passaggi, non come viene eseguito il turno.

Che modello usa Maestro?
Di default il Router sceglie un modello a ogni turno, e le righe di processo mostrano quale è stato usato. Puoi cambiare la modalità del modello (cloud, locale o self-hosted) dal composer, oppure usare Chat quando vuoi un solo modello fisso per tutta la conversazione.

L'app desktop si scarica da osfoundry.io/it/download.