Riferimento rapido ai termini usati in tutta questa guida, con le risposte alle domande più comuni.
Glossario & FAQ
Glossario
| Termine | Definizione |
|---|---|
| Agent | Il "lavoratore" AI che esegue un passo della Pipeline, configurato con uno specifico provider e modello. Vedere Settings. |
| Archive | Il registro consultabile di ogni Task completato, con il dettaglio completo del risultato. Un Task archiviato può essere rimesso in coda con Restore. Vedere Lettura dei risultati & Archive. |
| Auto-merge | L'opzione di Task autoMergeDev che integra automaticamente in dev un Task concluso e testato. Vedere Creazione di un Task. |
| Branch / Worktree | Il branch Git isolato e la cartella di lavoro separata creati per ogni Task, in modo che non possa influire sull'altro lavoro. Vedere La Pipeline. |
| Brainstorm | Il pannello per l'esplorazione aperta e la pianificazione con l'AI, senza modificare il codice. Vedere Brainstorm. |
| Chat | Il pannello di conversazione per progetto per domande e discussioni rapide, consapevoli dei contratti. Vedere Chat. |
| Contract | Una scheda di fatti salvata che descrive come si comporta una specifica parte del progetto, mantenuta allineata automaticamente. Vedere Knowledge Sharing. |
| Dashboard | La vista principale dello spazio di lavoro di AITM, con le schede dei progetti, le card e la coda dei Task. |
| Dev Panel (AITM Dev Panel) | Una barra degli strumenti JS iniettabile (aitm-dev-panel.js) servita dal server AITM che sovrappone gli elementi UI etichettati, mostra un contatore di eventi in tempo reale e un ispettore, e riferisce ad AITM le interazioni con il DOM così che possa costruire e mantenere la mappa degli elementi DOM del progetto. Vedere Mappa DOM + Dev Panel. |
| Branch dev | Il branch predefinito / di integrazione in cui confluisce ogni Task della Pipeline. Vedere Merge, correzioni post-merge & Scope Gate. |
| DOM Explorer | Il registro degli elementi UI reali di un progetto e di cosa attiva cosa, per i progetti con un frontend. Vedere Variable Explorer & IntelliSense. |
| E2E (End-to-End) | Test automatici che mettono alla prova l'applicazione reale in esecuzione in un browser, come farebbe un utente. Vedere Testing. |
| Hint | Una regola breve e riutilizzabile che l'AI applica automaticamente nei Task futuri, senza doverla ripetere. Vedere Knowledge Sharing. |
| Branch di integrazione (defaultBranch) | L'impostazione per progetto che indica in quale branch confluiscono i Task del progetto (predefinito dev); modificabile nelle impostazioni del progetto con un controllo "Verify remote". Vedere Merge, correzioni post-merge & Scope Gate. |
| Knowledge Graph | La mappa interconnessa di variabili, contratti, elementi UI e documentazione di un progetto. Vedere Knowledge Sharing. |
| Slot di licenza | Uno slot di progetto: la licenza indica quanti progetti AITM può gestire. Non limita quanti Task vengono eseguiti contemporaneamente — questo dipende dall'impostazione separata della Pipeline Max concurrently running tasks. Vedere Licenze & slot di progetto. |
| Lite mode | Un'opzione di Task che salta il passo di pianificazione Architect quando il modello di programmazione è sufficientemente potente. Vedere Creazione di un Task. |
| Branch main | Il branch stabile di release, aggiornato solo da un merge dev → main al momento della release. Vedere Merge, correzioni post-merge & Scope Gate. |
| Merge queue | Il meccanismo che serializza i merge in dev uno alla volta e tenta la risoluzione automatica dei conflitti. Vedere La Pipeline. |
| Pipeline | La sequenza automatica di 12 passi (branch → architect → code → compliance-check → review → fix → test → e2e → verify → snapshot → docs → chain-audit) che trasforma il prompt di un Task in una modifica completata, che la Merge queue integra poi in dev. Vedere La Pipeline. |
| Priorità | Un suggerimento sulla posizione di un Task in coda: low, medium o high. Vedere Creazione di un Task. |
| Progetto | Una codebase su cui AITM è stato configurato e per la quale può creare Task. Vedere Panoramica & primi passi. |
| Provider | Il servizio AI sottostante (Claude, Gemini, OpenAI, DeepSeek, NVIDIA, Ollama) che esegue un passo della Pipeline. Vedere Settings. |
| Stato (del Task) | Lo stato corrente di un Task: pending, running, awaiting_input, waiting, finished, failed, stopped, conflict o archived. awaiting_input significa che l'AI attende una risposta o un'approvazione; waiting significa che il Task attende le correzioni dei bug trovati dai test E2E. Vedere Creazione di un Task. |
| Task | Una singola unità di lavoro assegnata che percorre la Pipeline. Vedere Creazione di un Task. |
| Turno | Grosso modo un passo di ragionamento/azione di un Agent AI (ad es. lettura o modifica di un file). Vedere Settings. |
| Verdetto | Il risultato superato/fallito (o più dettagliato) di un passo di test, in particolare i verdetti E2E. Vedere Lettura dei risultati & Archive. |
| Watchdog | Il processo in background che rileva i passi della Pipeline bloccati e li riprende automaticamente. Vedere La Pipeline. |
FAQ
Cosa succede se un Task fallisce?
La Pipeline si ferma al passo fallito e lo stato del Task diventa failed, con il motivo registrato. Di solito è possibile riprenderlo da quel passo (o da uno precedente) una volta capito cosa è andato storto — vedere Lettura dei risultati & Archive.
È possibile eseguire più Task contemporaneamente?
Sì, su progetti diversi. All'interno di un singolo progetto i Task vengono eseguiti uno alla volta per evitare che due Task si contendano lo stesso branch; progetti diversi vengono eseguiti pienamente in parallelo.
AITM esegue mai push su un remote o su un branch di produzione di propria iniziativa?
No. L'Auto-merge integra soltanto nel branch dev locale. Qualsiasi push oltre questo è sempre un'azione deliberata e separata compiuta personalmente.
E se l'AI si blocca a metà di un Task?
Il Watchdog rileva un passo bloccato e riprende automaticamente la Pipeline, fino a un numero limitato di tentativi. Se ancora non riesce a riprendersi, il Task viene contrassegnato come failed con il motivo conservato, in modo da poter decidere come procedere. Vedere La Pipeline.
Dove sono memorizzati i miei dati?
In locale, in una combinazione di database per progetto, cartelle dei Task e documentazione generata automaticamente. Vedere Quali dati memorizza AITM per la mappa completa.
Occorre scrivere prompt perfetti?
No, ma prompt più specifici richiedono meno cicli di correzione. Vedere i suggerimenti per la scrittura dei prompt in Creazione di un Task.
Qual è la differenza tra Chat, Brainstorm e un Task?
Chat e Brainstorm servono a discutere e pianificare — non toccano mai il codice. Un Task è l'unica cosa che modifica davvero il codice e passa sempre attraverso l'intera Pipeline con review e test. Vedere Chat e Brainstorm.
Cosa significa il banner "License blocked (session-mismatch)"?
Il server di licenza ha visto la stessa chiave inviare heartbeat da due posti contemporaneamente — una seconda istanza AITM, una VM clonata o un backup ripristinato in esecuzione accanto all'originale. Finché non si risolve, la coda non ammette alcun Task. Fermare l'istanza duplicata, quindi fare clic su Retry nel banner (oppure su Refresh from server in Settings → License). Se si è certi che esista una sola istanza, il blocco è un falso positivo e può essere sbloccato dallo stesso banner. Vedere Licenze & slot di progetto.
Perché l'intestazione mostra un pulsante "Restart" dopo il merge di un Task?
AITM ha integrato una modifica al proprio codice e, nella modalità predefinita manual, attende l'utente prima di riavviarsi, in modo da non interrompere una coda in esecuzione. Lasciare terminare i Task in esecuzione, quindi fare clic su Restart nel menu dell'intestazione. Per i server senza supervisione, impostare Settings → Git & Storage → Server restart after self-merge su auto.
Perché i Task restano in pending anche se non è in esecuzione nulla?
Il limite di concorrenza è 0, è visibile il banner della licenza, oppure la protezione delle risorse trattiene i Task perché RAM/CPU è al di sotto della soglia percentuale libera. Controllare la barra di stato (RAM/CPU), il banner della licenza e Settings → Pipeline → Max concurrently running tasks. La scheda Queued della barra Monitor mostra perché ciascun job è in attesa.