Un hub versionato col codice
Standard, lessico del progetto e regole per assegnare il lavoro agli agenti specializzati vivono in una cartella versionata insieme al codice: documenti che dicono come si lavora, non appunti sparsi che nessuno rilegge.
Contesto chiaro.
AI governata.
Dai agli agenti una direzione chiara. Tieni le decisioni e le prove a portata del team.
Open source · Apache 2.0
Il contesto,insieme al codice.
- StandardCome si costruisce
- LessicoCome si chiama ogni cosa
- ResponsabilitàA chi tocca il lavoro
- VerificheCome si controlla il risultato
Il nostro metodo, in un repository open source
Ogni progetto segue lo stesso metodo in quattro passi: ricognizione, tracciatura, salita, vetta. steepy-apex è lo strumento con cui lo applichiamo quando lavoriamo con gli agenti AI di programmazione: un hub versionato nel repository del progetto raccoglie standard, lessico e regole, e il lavoro segue un percorso esplicito dalla specifica alla revisione, proporzionato al compito. È open source, con licenza Apache 2.0.
Dall’idea alla verifica
Questa demo mostra il percorso completo. Nel lavoro reale, il workflow si adatta al task e a ciò che la documentazione dell’hub già definisce.
Gear 1Intervento diretto
- Le regole dell’hub coprono già una modifica a basso impatto.
- Implementazione e controllo di coerenza.
Gear 2Specifica leggera
- Una modifica rilevante già coperta dalle regole, oppure contenuta ma ancora da definire.
- Specifica, implementazione e verifiche.
Gear 3Workflow completo
- Un cambiamento rilevante non ancora definito dalle regole, oppure irreversibile.
- Specifica, piano, implementazione e revisione.
Gear 4Ciclo autonomo
- Design definito, obiettivo verificabile automaticamente e conferma umana prima di partire.
- Contratto dell’obiettivo, ciclo autonomo delimitato e revisione finale.
Il modello segue
il compito.
Complessità e rischio guidano la scelta del modello, indipendentemente dal Gear, per bilanciare qualità e costo complessivo. Dove l’ambiente non supporta la selezione per task, si usa il modello della sessione.
01 / 06
Il problema
Le richieste sono sparse. Prima del software, serve una domanda chiara.
Richieste clienti / esempioTre strumenti.
Tre strumenti.
Nessuna vista d’insieme.
02 / 06
La specifica
Il problema diventa un perimetro condiviso e criteri che si possono verificare.
Specifica / esempioUna richiesta.
Una richiesta.
Un responsabile.
Uno stato leggibile.
- Chi scrive inserisce un titolo.
- Il team assegna un responsabile.
- Ogni richiesta ha uno stato.
- Le modifiche restano tracciabili.
03 / 06
Il piano
Ogni attività ha un responsabile, una dipendenza e un controllo.
Piano di lavoro / esempioIl percorso ha
Il percorso ha
responsabilità precise.
- 01Definire il contratto della richiestaContratti · verifica dei campi obbligatori
- 02Salvare richiesta e cronologiaAPI · verifica della persistenza
- 03Costruire la vista del teamWeb · verifica del flusso e accessibilità
04 / 06
Il prototipo
Un incremento piccolo, utilizzabile. Qui puoi provare una versione dimostrativa.
Prototipo locale / esempio
Da leggere a provare.
Richiesta di esempioAggiungere un campo al modulo
Da valutareResponsabile da assegnare
Anteprima statica. Gli altri passaggi della demo restano esplorabili.
05 / 06
La revisione
Una seconda lettura confronta il risultato con i criteri, prima dell’approvazione umana.
Revisione / esempio«Funziona» deve
«Funziona» deve
avere una prova.
Osservazione della revisione
Il titolo accetta solo spazi: il campo risulta compilato, ma la richiesta è vuota.
Apri la correzione proposta
Validazione del titolo
Rimuovere gli spazi iniziali e finali. Rifiutare il titolo quando non rimane testo.
Caso di prova: « » deve essere rifiutato.06 / 06
La verifica
Standard, riferimenti e responsabilità devono continuare a tornare.
Controllo di coerenza / esempioIl codice cambia.
Il codice cambia.
Il contesto lo segue.
- Collegamenti validiLa specifica rimanda al piano corretto.
- Responsabilità espliciteOgni attività ha una superficie di riferimento.
- Documenti raggiungibiliL’indice conduce alle regole del progetto.
Esito illustrativo, nessun controllo è eseguito sul tuo progetto.
Idea · 1 di 6
Scegli un passaggio. Guarda cosa cambia.Il caso: raccogliere e gestire le richieste dei clienti.
Un percorso esplicito
L’idea diventa una specifica, poi un piano di lavoro e un’implementazione sottoposta a revisione. Ogni passaggio lascia un artefatto leggibile.
L’ultima parola è umana
L’AI propone e lavora dentro confini dichiarati; una persona approva le decisioni che cambiano il progetto.
Coerenza controllata
Il controllo di coerenza verifica collegamenti, instradamento e riferimenti al codice nella documentazione del progetto e segnala dove non tornano. Non sostituisce la revisione di una persona.
Il metodo ti segue.
Anche quando cambi ambiente.
steepy-apex è compatibile con più harness: Claude Code, Codex, OpenCode, Pi e DeepSeek Harness. Il contesto, le regole e le verifiche del progetto accompagnano il lavoro nei diversi ambienti.
- Claude Code
- Codex
- OpenCode
- Pi
- DeepSeek Harness