Beta ARchetipo
Tutte le informazioni per partecipare alla beta: documentazione tecnica, repository GitHub, server Discord e prove consigliate per aiutarci a migliorare il workflow.
Benvenuti nella beta di ARchetipo
Grazie per aver scelto di entrare nella beta di ARchetipo. Il tuo contributo ci permetterà di vedere il prodotto all'opera in progetti, team e contesti reali, cioè proprio dove emergono i feedback più utili per renderlo più chiaro, più solido e più affidabile.
ARchetipo è un workflow spec-driven per agenti di coding AI. Invece di trattare ogni richiesta come un prompt isolato, introduce un metodo condiviso, ruoli specializzati e artefatti persistenti che accompagnano l'intero percorso di sviluppo: dalla visione iniziale al backlog, dalle spec al piano tecnico, fino a implementazione, test e review.
Tra le sue caratteristiche principali ci sono l'elevata efficienza nell'uso dei token grazie ad un approccio CLI driven, la possibilità di salvare gli artefatti tramite connector dedicati e una board locale per seguire lo stato del lavoro. Inoltre, si adatta alla lingua della conversazione, così backlog, piani e documenti restano leggibili e coerenti anche in flussi reali di team.
Risorse essenziali
Che cosa testare
Per noi i test più utili sono quelli che mettono ARchetipo alla prova in un contesto reale: ambienti diversi, progetti diversi e workflow diversi.
Setup e installazione
La CLI supporta installazione globale e inizializzazione su più tool. Con il comando archetipo init si possono installare le skill per Claude Code, Codex, Gemini CLI, OpenCode, GitHub Copilot e Pi, oltre a creare .archetipo/config.yaml e .archetipo/shared-runtime.md. Dopo l'installazione puoi lanciare archetipo version per verificare che la CLI sia disponibile e controllare la versione installata.
Quindi se vuoi contribuire allo sviluppo di ARchetipo, prova l'installazione su macOS, Linux o Windows. Verifica se npm install -g @techreloaded/archetipo è lineare o richiede workaround. Controlla se archetipo init chiarisce bene la scelta tra tool e connector.
Workflow completo
Il valore di ARchetipo emerge quando tutto il flusso resta coerente dall'inizio alla fine. Il test più utile è seguire un'esigenza reale lungo l'intero percorso, verificando se ogni passaggio prepara bene il successivo e se gli artefatti rimangono comprensibili anche dopo più iterazioni.
Per questo parti da un obiettivo concreto del progetto, non da un prompt scollegato dal contesto. Verifica se discovery, backlog, spec, acceptance criteria, task e review raccontano davvero la stessa storia. Osserva se il piano tecnico prodotto da archetipo-plan è abbastanza preciso da guidare decisioni, dipendenze e ordine di lavoro. Controlla se archetipo-implement mantiene coerenza con quanto pianificato, aggiornando codice, test e stato finale in modo leggibile.
Connector e board
ARchetipo lavora su artefatti di progetto, come backlog, specifiche e piani, che possono essere collegati a strumenti diversi tramite il connector. Il connector decide dove questi artefatti vengono letti, salvati e aggiornati durante il workflow.
Oggi ARchetipo supporta i connector file e github, oltre a una board locale accessibile con archetipo view. Se vuoi approfondire come funziona questa parte, trovi i dettagli nella documentazione tecnica sui connector. Nella beta vogliamo verificare se il workflow rimane robusto quando gli artefatti si muovono.
| Area | Cosa provare | Segnale utile |
|---|---|---|
| Connector file | Creazione e aggiornamento di backlog, spec e piani nel repository locale | I file restano leggibili, ordinati e facili da versionare |
| Connector GitHub | Issue, sub-issue, campi di stato e integrazione con GitHub Projects v2 | Le transizioni non perdono dati e il mapping con il board è chiaro |
| Board locale | Uso di archetipo view, lettura delle colonne e navigazione tra spec |
La board riflette davvero lo stato del progetto e non solo un caso ideale |
| Workflow states | Passaggi tra TODO, PLANNED, IN PROGRESS e REVIEW |
Le transizioni sono comprensibili, affidabili e facili da correggere se qualcosa va storto |
Lingua e output
ARchetipo è progettato per adattarsi alla lingua della conversazione. Se lavori in italiano o alterni italiano e inglese, ci interessa sapere se gli artefatti restano consistenti e se il testo prodotto è adatto a essere letto da un team, non solo da un modello.
- Verifica se backlog, piani e note restano nella lingua giusta.
- Controlla se i nomi tecnici e gli stati rimangono chiari.
- Segnala output troppo verbosi, troppo vaghi o difficili da rivedere velocemente.
Cosa ci aspettiamo dai beta tester
Non ci serve un test "pulito". Ci serve un test vero. Il feedback migliore arriva quando ARchetipo entra in un contesto reale e incontra vincoli reali.
- Usa un progetto concreto. Meglio ancora se lo fai su un flusso che abbia già contesto, vincoli e passaggi da coordinare.
- Dicci dove il metodo aiuta davvero. Non solo dove fallisce, ma anche dove rende il lavoro più ordinato o più veloce.
- Mandaci feedback riproducibili. Più il contesto è chiaro, più riusciamo a correggere in fretta.
- Se ARchetipo ti è piaciuto, lascia una ⭐ al repository su GitHub.
In pratica, per noi è molto utile se vorrai condividere con noi queste informazioni:
- Tool AI utilizzato: Claude Code / Codex / Gemini CLI / OpenCode / Copilot / Pi
- Sistema operativo: Windows / macOS / Linux
- Connector scelto: file / github
- Comando eseguito: archetipo init | archetipo view | /archetipo-plan US-001 | ...
- Cosa ti aspettavi:
- Cosa è successo davvero:
- Eventuale screenshot / log / file coinvolto:
Come inviarci feedback
Il canale più diretto è il nostro server Discord. È il posto giusto per dubbi rapidi, piccoli attriti di setup, screenshot e osservazioni "a caldo" mentre stai testando.
Noi di Tech Reloaded saremo a disposizione per chat vocali, sessioni di supporto immediate, chat dirette e raccolta feedback durante la beta.
Se preferisci, puoi scriverci anche su LinkedIn o dal form in fondo alla pagina.
Checklist veloce per iniziare
- Apri la documentazione tecnica.
- Installa la CLI.
- Inizializza un progetto con
archetipo init. - Crea o scegli una spec reale da lavorare.
- Mandaci feedback con contesto, comando e risultato.
Approfondisci
La documentazione tecnica raccoglie installazione, prerequisiti, quickstart, glossario, CLI, connector e configurazione per usare ARchetipo con un AI coding agent.
La pagina prodotto presenta ARchetipo come un team AI al tuo fianco, dall'idea al codice: un processo completo di sviluppo prodotto con ruoli specializzati e artefatti persistenti.