Guida di architettura

Progetta una funzionalità da zero

Parti dal primo utilizzatore e da un risultato osservabile. Mind riunisce intervista, progetto e revisione nella stessa conversazione.

$codex-council:codex-mind · mid
Progetta da zero una coda di lavoro recuperabile. Chiedimi le scelte che cambiano il contratto. Definisci la prima funzionalità completa e il suo test di guasto.

Risolvi le decisioni aperte

Descrivi un caso reale. Il coordinatore verifica i fatti nel repository e raggruppa le domande indipendenti che cambiano il progetto.
Gli specialisti propongono domande dalla propria prospettiva. Il coordinatore unisce i duplicati, dà una raccomandazione motivata e aspetta le risposte da cui dipende la domanda successiva.
Delega i dettagli reversibili. Il brief raccoglie le scelte in un progetto con confini, contratti, recupero e un esempio di accettazione.
Council mette alla prova la proposta. Con un verdetto build e la tua autorizzazione, Hyper implementa le funzionalità approvate ed esegue le verifiche.

Scegli un effort

simpleUn parere per una scelta reversibile.
midTre membri e un revisore per le scelte architetturali ordinarie.
ultraSei membri e cinque revisori per una verifica approfondita.

Questi numeri valgono per Council ordinario. I rischi elevati richiedono copertura completa. Forge usa cinque creatori, la revisione delle skill tre prospettive. Per il frontend si aggiungono Leonardo e le prove browser di Bob. Leggi la stima prima dell’avvio.

Aggiungi --details a estimate per il dettaglio dei costi stimati.

Scenari guidati

Esercizi di progettazione con una decisione e una verifica riproducibile.

Coda di lavoro recuperabile

Un worker si ferma dopo un effetto persistente. Chi assegna la chiave di idempotenza e quando può scadere?

Se la chiave appartiene al chiamante, concorda la finestra di retry. Progetta contratto di invio, stato persistente e conferma del worker.

Test di accettazione · Interrompi il worker tra commit e conferma. Reinvia la stessa chiave e conta i risultati persistenti.

Accessi per tenant

Un operatore lavora su due account. Quale tenant gli concede l’accesso e chi può revocarlo?

Stabilisci prima chi possiede i dati. Poi definisci il controllo in lettura e la scadenza delle autorizzazioni in cache.

Test di accettazione · Apri una sessione, revoca il permesso e ripeti la lettura da entrambi gli account. Verifica il tempo di revoca concordato e la traccia di audit.

Acquisizione di eventi versionati

Un dispositivo offline invia eventi vecchi dopo un aggiornamento. Quali versioni deve accettare il ricevitore?

Concorda la conservazione prima di scegliere il decoder. Definisci riconoscimento della versione, ordinamento e quarantena per payload sconosciuti.

Test di accettazione · Riproduci un evento vecchio, un duplicato e una versione sconosciuta. Controlla record persistiti, quarantena e offset dopo il riavvio.

Conserva un brief locale

Per un’intervista lunga crea un nuovo file, adatta le domande e inserisci answer oppure assumption per ogni decisione chiusa. Esegui di nuovo interview per vedere quali domande sono pronte.

python3 scripts/codex_council.py interview --start "Recover a job" > brief.json
python3 scripts/codex_council.py interview --input brief.json
python3 scripts/codex_council.py estimate --topic "Job queue" --effort mid --brief brief.json
python3 scripts/codex_council.py init --topic "Job queue" --effort mid --brief brief.json --confirm-estimate

Ricerca alla base del metodo

Questi lavori hanno orientato le scelte progettuali. La sezione Prove eseguite riporta separatamente le verifiche sul plugin.

Questo preprint di ottobre valuta separatamente comprensione e implementazione su 100 progetti da zero. Da qui la distinzione fra riepilogo delle decisioni e prova di accettazione. SWE-Clar · 2026

Gli autori scelgono le domande in base all’incertezza che risolvono nelle chiamate a strumenti. Nel plugin chiediamo quale risposta cambierebbe il progetto. Structured Uncertainty · ACL 2026

I costi di coordinamento variano tra compiti sequenziali e scomponibili. Usiamo gruppi limitati e riserviamo gli specialisti alle domande indipendenti. Scaling Agent Systems · 2026 revision

Uno studio con persone confronta interviste, focus group e sondaggi sulla spiegabilità. I sondaggi hanno prodotto anche requisiti ridondanti. Il coordinatore accorpa le domande prima di porle. Obaidi et al. · RE 2025

Il metodo del SEI traduce le esigenze degli stakeholder in scenari prioritari. Usiamo il più importante per verificare la prima funzionalità completa. Quality Attribute Workshops · SEI