La strada più breve verso il workflow giusto.

Scegli il workflow #

Usa il workflow più piccolo che corrisponde all’incertezza, all’impatto e alla prova richiesta.

Come funziona #

Mind collega Forge → Council → Hyper; ogni workflow può anche essere eseguito da solo. Nessuno trasforma il consenso in una prova.

Council: isola, valuta, preserva il dissenso

Confini dei workflow

Gate delle evidenze frontend

Leonardo esamina UX/UI. Bob esegue l’evidenza nel browser e non vota. Se il browser non è stato eseguito, visuale, tastiera, cronologia, console e overflow restano UNKNOWN.

Le sei fasi di Hyper

1. ContrattoDone osservabile, scope, vincoli, rollback, oracolo.
2. OsservaRegole repo, worktree, baseline, indagine read-only delimitata.
3. OrientaCollega i criteri alle evidenze e riserva un solo writer.
4. AgisciImplementa il percorso minimo e reversibile; verifica gli incrementi.
5. FalsificaMette alla prova contratto, diff grezza e check. Relay aggiunge un verifier nuovo; Solo dichiara la minore copertura indipendente. FAIL o UNKNOWN critici bloccano la chiusura.
6. ChiudiRiconcilia il contratto, riesegui i check giusti, rivedi il diff e dichiara il rischio residuo.

Evidence Lab #

Un record pubblico completato, con risultato di codice riproducibile e limiti di provenienza dichiarati.

Record forte di una run

• run ID, data, versione plugin e commit sorgente;
• stato del worktree o checksum dello snapshot congelato;
• task esatto, chiarimenti, baseline, workflow e route;
• patch risultante, comandi esatti, exit code e stdout/stderr non modificati—oppure omissioni esplicite;
• provenienza del workflow: trascrizioni salvate di agenti/verifier, oppure etichetta PARTIAL chiara;
• verdetto di un verifier nuovo sul contratto accettato;
• rischio residuo e usage non disponibile quando non osservabile.

Record pubblico completato

È un singolo caso di studio, non un benchmark né un claim generale di qualità. Registra un’implementazione Hyper Relay dalla build locale esatta indicata nel bundle di evidenze.

Esempi di prompt #

Copia la struttura, sostituisci i placeholder e definisci evidenze capaci di chiudere il task. Sono esempi, non risultati di prodotto.

Anatomia del prompt

Operazioni #

Esegui solo ciò che puoi rendicontare. Le stime sono euristiche locali, non dati di fatturazione.

Modalità e budget sono controlli diversi

Standard e Deep richiedono una stima accettata. Expanded richiede conferma esplicita. Expanded permette output e reference più ampi; non garantisce evidenze complete né audit trail.

Disciplina di preflight

Scrivi non disponibile quando il runtime non espone l’uso. Non trasformare mai la stima in una fattura o in consumo osservato.

Riferimento CLI rapido

# Valida il plugin locale.
python3 scripts/codex_council.py validate --plugin-root . --strict

# Stima prima del dispatch.
python3 scripts/codex_council.py estimate --topic "<proposta>" \
  --mode standard --type implementation --token-budget compact

# Anteprima del router opt-in senza dispatch.
python3 scripts/codex_council.py estimate --topic "<proposta>" \
  --router auto --panel auto --json

# Prepara gli artefatti dopo l’accettazione della stima.
# init non avvia gli agenti.
python3 scripts/codex_council.py init --topic "<proposta>" \
  --mode standard --type implementation --token-budget compact \
  --confirm-estimate

# Forge usa lo stesso estimatore/scaffolder con --type forge.
python3 scripts/codex_council.py estimate --topic "<idea>" \
  --mode standard --type forge --token-budget compact

# Ispeziona una sessione completata.
python3 scripts/codex_council.py compile-context \
  --topic "<handoff>" --constraint "<vincolo>" --json
python3 scripts/codex_council.py doctor --session <session-path>
python3 scripts/codex_council.py stats --session <session-path> --json
python3 scripts/codex_council.py dashboard

Alters

Visualizza in anteprima il tuning delimitato prima di configurarlo. Gli alter sono consultivi e non rimuovono guardrail. Bob è un evidence runner, non un votante configurabile.

python3 scripts/codex_council.py alters list
python3 scripts/codex_council.py alters preview --role grace --strictness high
python3 scripts/codex_council.py alters show --role grace

Decision Runtime

Il runtime è sperimentale e shadow-only. Gli artefatti legacy e il verdetto del Chairman restano autorevoli. Cells, frontier, recovery e replay migliorano la tracciabilità locale; non cambiano il verdetto.

python3 scripts/codex_council.py cells project --help
python3 scripts/codex_council.py cells apply --help
python3 scripts/codex_council.py cells plan --help
python3 scripts/codex_council.py cells doctor --help
python3 scripts/codex_council.py cells recover --help
python3 scripts/codex_council.py cells rollback --help
python3 scripts/codex_council.py cells purge --help
python3 scripts/codex_council.py cells replay --help
python3 scripts/codex_council.py cells fault-test --help

Governance e privacy

• Locale per default. Mantieni locali sessioni e configurazioni alter salvo autorizzazione alla condivisione.
• Minimizza i prompt. Non passare ai subagenti segreti, credenziali, log grezzi, PII o repository non pertinenti.
• Un writer in Hyper. Explorer e verifier restano read-only; l’evidenza decide i disaccordi.
• Confine sicurezza. Council può giudicare trade-off. Scan e fix di sicurezza del repository appartengono ai workflow Codex Security.

Riferimento #

Nomi, verdetti, limiti ed errori da tenere visibili prima di una run.

Ruoli e gate del Council

Pacchetti di competenze

Le lenti opzionali coprono implementazione, regressione, performance, disciplina del contesto, governance, UX operatore, UX frontend e semplificazione contrarian. Rendono più nitida la run; non creano diversità indipendente di modello.

Leggi l’output in quest’ordine

1. Final Callapproved, approved-with-risk o blocked.
2. Blockercondizioni da risolvere prima dell’approvazione.
3. Dissensorischi di minoranza sopravvissuti all’aggregazione.
4. Verificacosa è stato eseguito e cosa resta UNKNOWN.
5. Rischio residuocosa è accettato, reversibile o ancora esposto.

Errori comuni

• Usare il council per tutto. Il lavoro piccolo, reversibile e verificabile non giustifica l’overhead del Council: usa Codex normale.
• Trattare il consenso come prova. L’accordo è consultivo; la verifica deve essere eseguita.
• Chiamare run un template. Senza task + patch + check + verdetto non è stato eseguito.
• Dichiarare la UI completa senza browser. I claim browser restano UNKNOWN.
• Confondere modalità e budget. Una modifica la topologia; l’altro il margine.
• Pensare che init avvii gli agenti. La CLI prepara gli artefatti; la skill Codex orchestra la run.

FAQ

Glossario