Istruzioni operative

Una guida utente completa. Per i concetti, vedi Introduzione.

Account

Registrazione e accesso

Registrati su eastagiletracker.com/register con email e password, oppure continua con GitHub se preferisci OAuth. Verifica la tua email dal link che ti inviamo; fino ad allora puoi accedere ma alcune funzionalità sono limitate.

Se sei stato invitato a un progetto o a un’organizzazione, segui il link nell’email di invito — il tuo account viene creato (o effettui l’accesso) e atterri direttamente sulla board corrispondente.

Hai dimenticato la password? Usa Forgot Password nella pagina di accesso; ti inviamo via email un link di reimpostazione.

Impostazioni account

Dall’avatar in alto a destra → Account Settings:

• Profilo — Nome visualizzato, iniziali (usate negli avatar degli owner), email.
• Bio — Una breve descrizione di te stesso (fino a 4 KiB). Appare su /me e negli elenchi dei membri dell’organizzazione, così un agente (o un compagno di squadra) può individuare la persona giusta a cui rivolgersi. Lasciala vuota per non comparire.
• Password — Cambiala quando vuoi.
• Avatar — Carica un’immagine, oppure ricadi sulle tue iniziali.
• API Keys — Crea token API personali; vedi Guida API.
• Theme — Agile, Labs, Dark o Light (commutabile anche dalla sidebar).
• Delete Account — Una conferma in due passaggi. Ti rimuove da tutte le organizzazioni e i progetti.

Sicurezza

Dall’avatar in alto a destra → Security:

• Autenticazione a due fattori (TOTP) — Configura un codice da una qualsiasi app authenticator (1Password, Authy, Google Authenticator, …). Ottieni 10 codici di recupero monouso — vengono mostrati una sola volta, quindi salvali. Disattivala in seguito con un codice corrente oppure un codice di recupero.
• Passkey — Aggiungi una passkey WebAuthn vincolata al dispositivo (Touch ID, Windows Hello, chiave di sicurezza hardware). Da quel momento accedi senza password. Aggiungi, rinomina e rimuovi le chiavi dalla stessa pagina.

Sessioni e refresh token

Un accesso riuscito genera due token: un access JWT a breve durata e un refresh token a lunga durata (30 giorni, ruotato a ogni utilizzo). La SPA aggiorna automaticamente l’access token quando scade; resti connesso finché il refresh token non scade o finché non effettui il logout. Il logout revoca il refresh token lato server, così una copia rubata non può essere riutilizzata.

Fatturazione

La maggior parte degli account è Free Forever per uso personale. Se il tuo account ha un saldo di crediti a consumo, lo trovi sotto Account → Billing — ricarica tramite il checkout Paddle, consulta la cronologia delle transazioni.

Organizzazioni

Ogni account appartiene a una o più organizzazioni. Una nuova registrazione ottiene un’organizzazione personale (“<Nome> Org”) creata automaticamente, alla maniera di Linear/Vercel. I progetti vivono dentro le organizzazioni, e l’appartenenza all’organizzazione regola l’appartenenza ai progetti.

Cambiare organizzazione

Clicca sul selettore di organizzazione nella topbar per passare tra le organizzazioni a cui appartieni. L’organizzazione attiva colora la sidebar, delimita l’elenco “Projects” e viene preselezionata quando crei un nuovo progetto.

Gestire un’organizzazione (admin)

Clicca sul blocco dell’organizzazione nella sidebar → Manage organization → atterri su /organization/{id}/projects. La sidebar mostra tre schede di amministrazione:

• Projects — Tutti i progetti di questa organizzazione.
• Members — Membri attuali, ruoli e inviti in sospeso. Invita via email; l’invito è vincolato all’indirizzo email con un token a TTL e un limite massimo di ruolo (i membri non possono invitare admin).
• Settings (solo owner) — Nome dell’organizzazione, slug, piano. Da qui trasferisci la proprietà a un altro membro.

Rimuovere un membro

Rimuovere un membro da un’organizzazione si propaga a cascata: le sue appartenenze ai singoli progetti di quell’organizzazione vengono revocate nella stessa transazione. Gli URL delle board salvati nei segnalibri smettono di funzionare nel momento in cui perde l’accesso all’organizzazione — nessuna traccia orfana.

Progetti

Creare un progetto

Dalla pagina Projects, clicca New Project. Il modulo di creazione chiede solo due cose:

• Titolo — Obbligatorio.
• Descrizione — Opzionale; visibile a tutti i membri.

Tutto il resto — durata dell’iterazione, giorno di inizio, velocity iniziale, scala di stima, done state, attivazione dei task — viene impostato dopo in Project Settings ed è precompilato con valori di default sensati.

Impostazioni del progetto

Sotto il menu Settings del progetto, quattro schede:

• Project — Modifica titolo, descrizione, durata e giorno di inizio dell’iterazione, strategia di velocity (media delle ultime 3 / 5 / 10), done state, scala di stima, attivazione dei task.
• Member — Invita, promuovi/declassa e rimuovi membri umani (vedi Membri e inviti, più sotto).
• Agent — Genera e revoca chiavi API agente per questo progetto (vedi Agenti, più sotto). Solo owner.
• Import — Porta storie da un altro tracker (vedi Importare da altri tracker, più sotto).

Membri e inviti

Nella scheda Member di Project Settings, invita persone via email. Gli inviti in sospeso restano in un contenitore separato finché non vengono accettati; vedi chi è stato invitato e puoi reinviare o revocare. I membri attivi possono essere promossi/declassati tra viewer, member e owner. Gli owner possono modificare le impostazioni del progetto; i viewer possono leggere ma non scrivere.

La cronologia del progetto è in una sua pagina dedicata — ogni modifica alle impostazioni del progetto, ogni cambio di appartenenza, con l’attore (umano o agente).

Storie

Creare una storia

Usa l’affordance + Add story su qualsiasi pannello della board (Current, Backlog, Icebox o uno personalizzato) — scrivi un titolo e premi Invio.

Le nuove storie create in Current hanno per default current_state = 'unstarted'. È la parità con PT: un’iterazione Current è un piano di lavoro, non una partizione per stato. L’owner avvia esplicitamente la storia quando inizia il lavoro — il cronometro del cycle time non parte fino a quel momento.

Obbligatorio: il titolo. Scegli un tipo (default feature). Aggiungi descrizione, stima (solo feature), label, owner, follower, blocker — qualsiasi di questi può essere compilato in seguito dal pannello di dettaglio.

Premi Invio due volte rapidamente? Nessun problema — il pulsante è protetto; ottieni esattamente una storia.

Stimare le feature

Le feature sono l’unico tipo che prende punti. Clicca sul cerchio dei punti su una card (o nel pannello di dettaglio) e scegli dalla scala. Le feature non stimate mostrano un cerchio vuoto.

• Scala Fibonacci — 0, 1, 2, 3, 5, 8, 13. XP standard. Qualsiasi cosa più grande di 13 dovrebbe essere suddivisa in storie più piccole.
• Scala East Agile — 0, 1, 2, 3. Più stretta. Un 3 significa un’intera iterazione del tempo di una persona. Niente sta oltre il 3.
• Scala 3 punti — 1, 2, 3 (Small / Medium / Large). Dimensionamento a taglie di magliette rigoroso — nessuna opzione zero, nessun mezzo punto.

Scegli la scala una volta in Project Settings; puoi cambiarla in seguito (le stime esistenti vengono mappate).

Far avanzare lo stato

Tre modi per far muovere una storia lungo il ciclo di vita:

1. Clicca il pulsante d’azione inline sulla card — Start, Finish, Deliver, Accept, Reject. Il testo del pulsante riflette il prossimo stato valido per il tipo della storia.
2. Trascina la card in una colonna diversa. Il sistema applica la transizione implicata dall’attraversamento di quella colonna. I movimenti all’indietro richiedono conferma.
3. Transizione in blocco — Seleziona più storie, Transition all — ogni storia transita indipendentemente. Se una è illegale, le altre passano comunque.

Pannello di dettaglio

Clicca in un punto qualsiasi della riga di una storia per espanderla inline. Il pannello di dettaglio mostra:

• Titolo (modificabile), descrizione (Markdown), tipo, stima, requestor.
• Owner (aggiungi/rimuovi membri o agenti), follower, label.
• Task (se abilitati), commenti, allegati, blocker, link, review.
• Un menu a 3 puntini per duplicare, eliminare e altre azioni meno comuni.

Premi Escape per chiudere la storia aperta più di recente (ricorda lo stack — chiudi una alla volta).

Commenti

Fino a 10.000 caratteri, renderizzati in Markdown. Modifica ed elimina i tuoi commenti; l’audit log conserva la cronologia. Usa @ per menzionare i membri e l’autocompletamento li individua.

Allegati

Trascina un file sul pannello di dettaglio, oppure usa il pulsante di upload. Fino a 2 GB per file — sì, abbastanza grande per video walk-through registrati dallo schermo. Usa il player video inline.

Label

Dalla pagina Labels nella sidebar: crea label con nomi e colori, archivia quelle obsolete (le label archiviate spariscono dalla board ma restano ricercabili). Aggiungi label per storia nel pannello di dettaglio.

Blocker, link, review

• Blocker — Una nota testuale “questo è bloccato da X”. Contrassegnala come risolta/non risolta. Filtra la board con has:blocker.
• Link — Sei tipi di relazione: relates to, duplicates, blocks, is blocked by, pull request, branch. Incolla un URL GitHub e il tipo viene rilevato automaticamente.
• Review — Assegna un revisore (umano o agente) con uno stato (pending, approved, rejected) e un commento opzionale.

Task

Se abilitati in Project Settings, le storie ottengono sotto-task — una checklist all’interno della storia. Spuntali man mano che procedi; il conteggio appare sulla card.

Riferimento dei campi della storia

Ogni variabile di scelta sulla superficie del dettaglio storia porta una piccola icona [?] accanto alla propria etichetta. Cliccala nell’app per vedere la stessa guida riassunta qui sotto. I traduttori rilasciano il testo in-app insieme al resto dell’interfaccia; questa sezione è il riferimento canonico in forma estesa.

I campi sono elencati nell’ordine in cui appaiono nella scheda Overview.

Status

Il posto della storia nel ciclo di vita: Unstarted → Started → Finished → Delivered → Accepted (o Rejected di nuovo verso Started).

Lo stato critico è Delivered: l’ingegnere la segna come delivered, ma non è done finché il product owner non la accetta esplicitamente rispetto ai criteri di accettazione — oppure la rifiuta, rimandandola indietro. Questo incorpora un ciclo di feedback dal cliente in ogni storia, invece di rinviare l’accettazione a una demo di fine sprint.

Se le storie si accumulano in Delivered, è un segnale che il ciclo accetta/rifiuta si è bloccato. Guarda il conteggio dei Delivered alla fine di ogni iterazione — se sta crescendo, è il tuo segnale che il product owner è sotto organico o che i criteri di accettazione non sono abbastanza chiari in anticipo.

Iteration

In quale iterazione è pianificata la storia. Lasciala su None per tenere la storia nel Backlog, dove il sistema la raggrupperà automaticamente sotto un’iterazione futura in base alla velocity.

L’override manuale qui è utile quando vuoi fissare una storia a un’iterazione specifica indipendentemente dall’ordine — ad es. legare una storia di release a una data fissa. Altrimenti, lascia che sia l’ordine nel Backlog a guidare l’assegnazione delle iterazioni; è questo che mantiene onesta la proiezione della velocity.

Owners

Chi sta facendo il lavoro. Gli owner possono essere umani o agenti — entrambi vengono resi come partecipanti con nome nell’audit log, nella paternità dei commenti e nelle analisi. Non c’è modo di camuffare un owner agente da umano.

Più owner sono l’espressione visibile del pair programming (o del pair con agente). Aggiungi l’agente che ha preso in carico la storia e l’umano che la sta revisionando — entrambi i nomi appaiono sulla card. Questo mantiene basso il lavoro in corso; finire prima di iniziare la storia successiva è la singola leva più importante sul cycle time.

Gli owner non sono la stessa cosa dei Follower (un campo separato sulla card). I follower sono persone a cui interessa la storia ma che non stanno facendo il lavoro — tipicamente abbonati alle notifiche.

Story type

I quattro tipi non sono intercambiabili — la distinzione è tutto il punto del modello dei dati.

• Feature — Nuovo valore osservabile dall’utente. L’unico tipo che porta punti e conta verso la velocity. Questo ti costringe a suddividere il lavoro in valore che l’utente può vedere.
• Bug — Un difetto. Senza punti. I difetti non guadagnano credito di velocity, il che mantiene visibile il costo della rilavorazione anziché premiarlo.
• Chore — Lavoro necessario senza valore diretto per l’utente (refactoring, infra, setup). Senza punti. Il team è spinto a raggruppare i chore nelle feature ovunque possibile, così l’inquadramento del valore rimane onesto.
• Release — Un marcatore a zero punti per una milestone. Va dritto da Unstarted ad Accepted, ancorando una data per la proiezione.

Se ti ritrovi a voler assegnare punti a un bug o a un chore: non farlo. Questo spezza la proiezione che rende onesto l’intero sistema. La velocity è uno strumento di misura; non si manomette il proprio strumento.

Priority

Non usarla se puoi evitarlo. Il Backlog è la priorità — dall’alto al basso, a priorità singola, nessun pareggio. Il product owner possiede l’ordine.

Un campo “priorità” è il classico anti-pattern che converte silenziosamente un backlog empirico e ordinato di nuovo in pianificazione velleitaria. Se ti ritrovi con tre P1, non hai una priorità — hai un Backlog con l’ordine sbagliato. Sistema l’ordine; elimina il segnale di priorità.

Il campo esiste per compatibilità con le importazioni da tracker che ne usano uno (Jira, Asana, …) così le storie importate non perdono informazioni all’ingresso. Lascialo su “None” nel lavoro nuovo.

Points

Dimensione relativa della storia. Le feature prendono punti; bug, chore e release restano a zero.

La stima è una conversazione sul dimensionamento, non una promessa. Non tradurre i punti in ore; non gonfiare i punti per sembrare veloce. La velocity è uno strumento di misura — non si manomette il proprio strumento.

Sono incluse tre scale:

• Fibonacci — 0, 1, 2, 3, 5, 8, 13. La classica scala XP. Qualsiasi cosa più grande di 13 dovrebbe essere suddivisa.
• East Agile — 0, 1, 2, 3. Una scala più stretta. Un 3 significa un’intera iterazione del tempo di una persona.
• 3 punti — 1, 2, 3 (Small / Medium / Large). Dimensionamento a taglie di magliette rigoroso.

Se stimi spesso in 5, 8 o 13, le tue storie sono troppo grandi. Suddividi finché ciascuna è rilasciabile in modo indipendente (la S e la I di INVEST).

Requester

Chi ha richiesto la storia. Di solito una persona — il product owner, uno stakeholder o un agente che agisce per conto di qualcuno.

Il requester non è l’owner. L’owner è chiunque stia facendo il lavoro; il requester è chiunque tenga al risultato e (lo accetterà o no). Possono essere la stessa persona, ma sono ruoli separati. Registrare il requester è ciò che ti dà la risposta di audit a “chi ha chiesto questo?” sei mesi dopo.

Labels

Tag colorati. Le storie possono averne più d’uno. Usati per categorizzazione trasversale — mvp, tech-debt, security, un particolare nome di release — e per il filtraggio della board (label:mvp nella casella di ricerca, oppure salvalo come pannello di filtro personalizzato).

Le label hanno ambito di progetto. Gestiscile nella pagina Labels nella sidebar. Archivia le label obsolete invece di eliminarle; l’archivio mantiene la cronologia ricercabile pulendo la board.

Blockers

Note testuali che descrivono cosa impedisce alla storia di avanzare. Contrassegnale come risolte quando l’impedimento viene rimosso.

I blocker sono un segnale di flusso, non una coda. Usa il daily standup per farli emergere; risolvili fuori banda. Se hai più di uno o due blocker aperti per storia per più di un giorno, la pianificazione è sbagliata — suddividi la storia o cambia la dipendenza. L’obiettivo è che il pannello Blocked sia per lo più vuoto la maggior parte del tempo.

Description

Cosa è la storia e come riconoscere che è done. Markdown.

I criteri di accettazione vanno qui — idealmente in forma Given / When / Then così da mapparsi direttamente sui test di accettazione:

Given I am signed in as a member
When I click "Add a story" in Current
Then the story is created in state "unstarted"

INVEST è il controllo di sanità su quanto una storia sia ben formata:

• Independent — può essere rilasciata senza altre storie.
• Negotiable — cattura l’intento, non una specifica congelata.
• Valuable — per un utente o uno stakeholder.
• Estimable — il team può dimensionarla.
• Small — sta comodamente in un’iterazione.
• Testable — ha criteri di accettazione che possono essere esercitati.

Una storia in cima al backlog con criteri di accettazione vaghi è un bug di pianificazione — non un problema futuro da ignorare. Sistemala prima di lasciarla avanzare.

Azioni in blocco

Seleziona più storie sulla board (shift-click per un intervallo, oppure Select all in panel). Poi:

• Transizione in blocco
• Eliminazione in blocco
• Duplicazione in blocco

La board

La board è la schermata principale di ogni progetto. Tre colonne per default:

• Current — Storie nell’iterazione attiva. Raggruppate per intestazione di iterazione (corrente, poi prossime, poi chiuse). Le card appaiono in ordine di sequenza temporale dell’iterazione con il loro stato visibile su ciascuna; la colonna non è suddivisa per stato — questo spezza la sequenza temporale dell’iterazione in cui il team pianifica.
• Backlog — Coda rigorosamente ordinata. Il sistema raggruppa automaticamente le iterazioni future in base alla velocity. Il product owner possiede l’ordine dall’alto al basso; alla chiarezza è consentito degradare man mano che scorri verso il basso, ma mai in cima.
• Icebox — Idee senza una data. Non ordinate, non stimate. È consentito che l’Icebox sia un cimitero.

Pannelli configurabili — checkbox nella sidebar

La sezione Board della sidebar elenca ogni colonna preset con una checkbox: spunta una casella per mostrare quella colonna, deselezionala per nasconderla. I toggle persistono per progetto e per utente (sono sincronizzati tramite GET/PUT /preferences). I preset sono:

• Current Iteration (attivo per default)
• Backlog (attivo per default)
• Icebox (attivo per default)
• Done — Storie accettate.
• My Work — Storie di cui sei owner.
• Blocked — Storie con blocker non risolti.
• Epics — Aggregazioni a livello di epic.
• Chat — Colonna di chat con ambito di progetto.

Pannelli di filtro personalizzati

Fissa una ricerca come pannello: incolla una query come type:feature label:mvp owner:claire, salvala. Ridimensiona le colonne a tuo piacimento; le larghezze persistono tra le sessioni.

Ricerca

La barra di ricerca accetta la sintassi di filtri descritta in Introduzione. I risultati della ricerca vivono in un pannello dedicato; clicca su uno qualsiasi per saltare ad esso sulla board.

Chip dell’iterazione corrente

La barra superiore mostra il numero dell’iterazione corrente, l’intervallo di date e i punti accettati rispetto a quelli pianificati. Clicca per saltare alla colonna Current.

Iterazioni

Il sistema crea le iterazioni automaticamente in base alla tua durata e al giorno di inizio. Non hai bisogno di “aprirle” o “chiuderle”.

Per pianificare in anticipo, trascina le storie dal Backlog nei gruppi delle iterazioni future. Il sistema segna i gruppi in rosso se superano la tua velocity. Per pianificare ancora più avanti, scorri il backlog — mostra tre o quattro iterazioni in avanti.

Per tornare indietro: clicca su una qualsiasi intestazione di iterazione passata nella colonna Current per approfondire il report dell’iterazione.

Release

Le release sono un tipo di storia, non un oggetto separato. Crea una release esattamente come creeresti una qualsiasi storia: scegli Release come tipo, dagli un nome (es. v2.4), trascinala nell’iterazione in cui intendi rilasciarla.

Le release saltano gli stati Started/Finished/Delivered/Rejected — vanno da Unstarted ad Accepted in un solo passaggio. Accetta una release quando rilasci; le viste di analisi mostrano il marcatore di release.

Analisi

La scheda Analytics (in alto nel progetto) ti offre sei report:

• Project Overview — Andamento della velocity, KPI delle iterazioni recenti, burnup, burndown, cumulative flow.
• Iteration — Approfondisci una singola iterazione: KPI, burndown, flusso degli stati.
• Releases & Burndowns — Timeline delle release, burndown per release.
• Story Activity — Chi ha fatto cosa, filtrabile per attore, tipo, intervallo di date.
• Cycle Time — Media e distribuzione del tempo da Started al tuo done state.
• Projections — Previsione di quando il backlog sarà completato all’attuale velocity.

Agenti

Questa è la parte del prodotto che lo distingue. Un agente è un compagno di squadra con nome — ma è un’IA.

Aggiungere un agente a un progetto

Devi essere owner del progetto (o admin). Apri Project Settings → Agents:

1. Create new agent key.
2. Dai un nome all’agente (apparirà con quel nome negli audit log, nella paternità dei commenti e negli avatar degli owner).
3. Scegli un ruolo — viewer (sola lettura) o member (può scrivere). Il ruolo owner è riservato agli umani.
4. La chiave viene mostrata una sola volta — copiala; non la conserviamo in forma recuperabile. Il prefisso è ea_agent_….

Cosa possono fare gli agenti

Un agente con ruolo member può fare tutto ciò che può fare un membro umano:

• Creare, modificare, far transitare, eliminare storie
• Commentare, allegare file, aggiungere label, impostare owner
• Scegliere sé stesso come owner di una storia
• Leggere le attività, seguire gli eventi

L’audit log registra ogni scrittura con l’identità dell’agente. Non c’è modo di far sembrare umana l’azione di un agente.

Gestire le chiavi degli agenti

In Project Settings → Agents vedi tutte le chiavi attive, i loro nomi, i ruoli e il timestamp dell’ultimo utilizzo. Revoca una chiave in qualsiasi momento; l’agente perde immediatamente l’accesso. L’attività passata dell’agente resta nell’audit log per sempre.

Usare gli agenti con l’API

Vedi Guida API → Chiavi agente per esempi di codice.

Importare da altri tracker

Se arrivi da un altro strumento, abbiamo importatori per otto sorgenti:

• Pivotal Tracker
• Jira
• Asana
• GitLab
• Shortcut
• Trello
• Linear
• Plane

Da Project Settings → Import, carica un export (CSV dalla maggior parte, JSON da Plane). Storie, owner, commenti, label e stati vengono mappati automaticamente; alcune sorgenti portano anche le iterazioni.

Un’anteprima mostra cosa verrà importato. Le discrepanze (es. una label non presente nel tuo progetto) chiedono conferma — crea-o-salta, a tua scelta.

Temi

Quattro temi sono inclusi. Cambia nel piè di pagina della sidebar (o in Account Settings → Theme):

• Agile — La palette della landing page di marketing. Bianchi caldi, accento di brand blu intenso (#1f6f9f), icone dei tipi di storia saturate. Opzione principale nel selettore.
• Labs — La palette di Pivotal Tracker, conservata con affetto. Chrome scura, topbar blu, spaziature pastello tra le colonne. L’originale.
• Dark — Scuro neutro puro.
• Light — Chiaro neutro puro. Inchiostro su carta.

Il tuo tema persiste tra le sessioni.

Lingua

L’interfaccia è tradotta in 15 lingue: inglese, francese, tedesco, spagnolo, giapponese, cinese, coreano, portoghese, italiano, olandese, svedese, danese, ceco, finlandese, polacco. Cambia dal piè di pagina della sidebar — chrome, pagine di autenticazione, area account/sicurezza, elenco progetti e landing di marketing si localizzano immediatamente. La localizzazione di dettaglio storia / analisi / impostazioni seguirà.

Scorciatoie da tastiera

Alcune che si guadagnano il posto:

• Escape — Chiude la storia aperta più di recente.
• Enter in un input inline — Invia (non chiude la riga).
• Shift-click — Selezione a intervallo delle storie.

Altre vengono aggiunte nel tempo; vedi Help nella sidebar per l’elenco aggiornato.

Self-hosting

East Agile Tracker è open source. Il codice sorgente completo è su github.com/EastAgile/agile-tracker — clonalo, compilalo, eseguilo sulla tua infrastruttura. Stesso set di funzionalità della versione hosted.

Per il setup, vedi il README del progetto.