Decisioni e revisione

Una decisione in Mios rappresenta una scelta tecnica concordata, una regola architetturale o un requisito di progetto. Mios tiene traccia della storia di ogni decisione: chi l'ha scritta e quali decisioni precedenti ha sostituito.

Come vengono proposte le decisioni

Le decisioni entrano in Mios attraverso due strade principali:

1. Estrazione dalle fonti collegate: quando Mios indicizza discussioni di pull request, documenti di progettazione architetturale o thread tecnici nelle chat, il suo motore di analisi rileva quando il team concorda su una direzione.
2. Proposte dagli agenti di coding: quando un agente termina un'attività in Claude Code o Codex, l'hook di stop analizza le modifiche fatte durante la sessione e propone a Mios i nuovi schemi che si sono affermati.

Tutte le decisioni appena proposte partono in stato di attesa, in attesa della conferma di una persona.

La coda di revisione («Tocca a te»)

Per rivedere le decisioni proposte, vai su Review (/pages/review) in https://app.mios-ai.com.

Ogni scheda mostra l'enunciato della decisione proposta, la motivazione estratta dalla discussione e link diretti ai documenti di origine. Hai quattro azioni a disposizione:

• Adopt: convalida la decisione. Entra a far parte della memoria autorevole del progetto e viene servita subito agli agenti di coding.
• Reject: scarta la decisione. Esce dalla coda attiva e non verrà suggerita agli agenti.
• Edit: modifica il titolo o la formulazione della decisione prima di adottarla.
• Undo: annulla una recente azione di revisione se una decisione è stata adottata o rifiutata per errore.

Decisioni adottate automaticamente

Quando più documenti distinti e autorevoli affermano esplicitamente la stessa decisione, Mios può contrassegnarla automaticamente come auto-adopted.

Le decisioni adottate automaticamente sono attive subito, ma restano visibili nella coda di revisione, così i membri del team possono controllarle o modificarle in qualsiasi momento.

Sostituire e superare le decisioni

I requisiti di ingegneria evolvono nel tempo. Quando una decisione appena proposta è in conflitto con una precedente o la sostituisce, Mios segnala il legame.

Nella scheda di revisione, Mios evidenzia la decisione precedente in conflitto nell'elenco delle voci contestate. Quando adotti la nuova decisione:

1. La nuova decisione diventa la linea guida attiva del progetto.
2. La decisione più vecchia viene contrassegnata come superseded, così il contesto storico si conserva senza confondere gli agenti.
3. Gli agenti di coding che lavorano su attività future vedono la decisione aggiornata insieme a un riferimento a quella sostituita.