Per sviluppatori · la macchina dietro «vibe the project»
Ogni progetto Motir passa per lo stesso strumento. I moduli sono Motir e i suoi agenti. Manopole e interruttori sono tuoi: nulla va avanti finché una persona non li gira.
Motir e agentiDecidi tu
Scorri il disegno di lato →
Ogni modulo del disegno qui sopra, da vicino. Passa sopra uno per trovarlo nel disegno.
[01] Pianificazione AI
Parti da una frase, da un repository o da un’importazione da Jira, Linear o Plane. Il planner legge ciò che esiste, compreso un grafo del codice dei tuoi repository, e fa domande di approfondimento dove la richiesta è ambigua.
Prepara Epic, storie, attività e sottoattività, ciascuna con un tipo, un esecutore, una dimensione e i suoi archi blocked_by. validate_plan controlla l’albero prima che tu lo veda.
[02] Tu · cancello del piano
Nulla arriva sulla bacheca finché una persona non approva il piano. Chiedi modifiche a parole tue; ogni giro è un nuovo turno, e lo storico del piano conserva ogni versione e il motivo per cui è cambiato.
[03] Elementi di lavoro
Il piano approvato diventa elementi di lavoro con Sprint, un Backlog e una roadmap. L’esecutore di ogni elemento di lavoro è agent o human.
Le attività manuali (un account, un secret, un record DNS, un via libera al rilascio) vengono guidate un passo alla volta da motir guide.
[04] Esecuzione agente
Un agente prende il prossimo elemento di lavoro pronto (motir next o motir run <KEY>), lo prende in carico, lavora sul proprio branch e apre una pull request per repository, collegata all’elemento di lavoro.
Un Bug trovato al di fuori del proprio elemento di lavoro non ferma l’esecuzione: l’agente ne individua la causa, lo registra con motir log bug nella cartella Bug come elemento di lavoro a sé e va avanti.
Ogni esecuzione registra l’harness dell’agente, il modello, ogni passo e l’esito. Gli agenti si collegano tramite MCP, sulla tua macchina o come agenti in hosting di Motir.
[05] Tu · cancello del merge
L’elemento di lavoro passa a Implemented e l’agente pubblica le istruzioni di test. Le storie ricevono un video di accettazione registrato in CI. Tu rivedi, approvi e fai il merge; il merge chiude l’elemento di lavoro. Nulla arriva a Done senza una persona.
[06] Riparazione
Una pull request rossa o in conflitto viene riparata sul proprio branch con motir fix, con fino a cinque tentativi. Un’esecuzione interrotta (un portatile chiuso, una sandbox persa) viene ripresa con motir continue sul branch che ha lasciato.
I Bug registrati lungo la strada aspettano nella cartella Bug; motir fix bugs li affronta uno per uno, dal più vecchio.
[07] Ciclo di apprendimento
Un agente che non riesce a realizzare un elemento di lavoro chiede prima se è ancora ciò che il piano approvato aveva approvato (get_approved_shape_verdict), così una modifica successiva non viene attribuita al planner. Se il piano era sbagliato, viene ripianificato e la modifica viene registrata con il suo motivo.
L’errore diventa una lezione, o ne rafforza una; se nessuna regola lo copre, viene registrato un Bug di pianificazione. Il piano successivo legge prima le lezioni. Le lezioni che non si ripresentano per 90 giorni vanno in pensione.
[08] Memoria
Design, pagine delle decisioni, documenti, lezioni, revisioni del piano e lo storico di ogni esecuzione vivono accanto agli elementi di lavoro. Tu, un nuovo collega o il prossimo agente potete riprendere il progetto mesi dopo senza che nessuno debba rispiegarlo.
Il nucleo di gestione dei progetti è open source, con licenza GPL-3.0. Ospitalo tu, oppure usalo su motir.co.