Vai al contenuto principale

​
Panoramica

Gli epic sono il livello strategico nella gerarchia di lavoro di Apollo: 
Project -> Epic -> Release -> Task
Un epic raggruppa release correlate sotto un’unica iniziativa. Il CLI ti permette di elencare gli epic, esplorare le loro release e attività, monitorare il completamento e gestire il ciclo di vita degli epic — tutto dal terminale.
Le attività si collegano agli epic indirettamente attraverso le release. Quando esegui apollo epic tasks, il CLI recupera tutte le release dell’epic, poi recupera in blocco le attività di quelle release.

​
Stati degli Epic

StatoSignificato
draftFase di pianificazione, non ancora attivo
activeAttualmente in corso
completedTutto il lavoro completato
archivedNon più rilevante

​
Elencare gli Epic

# List epics in a project
apollo epic list -p "Apollo"

# Filter by status
apollo epic list -p "Apollo" -s active

# Limit results
apollo epic list -p "Apollo" --limit 20
Opzioni:
FlagDescrizione
-p, --project <name>Nome o ID del progetto (obbligatorio)
-s, --status <status>Filtrare per stato (draft, active, completed, archived)
--limit <n>Massimo risultati (predefinito: 50)

​
Visualizzare i Dettagli dell’Epic

Mostra i metadati dell’epic, la barra di avanzamento, la distribuzione delle release e le statistiche delle attività: 
apollo epic view "Authentication Overhaul"

Authentication Overhaul
────────────────────────────────────────────────────────────
  Status:  active
  Project: Apollo
  Quarter: Q2 2026
  ID:      550e8400-...

  Progress
  ████████████░░░░░░░░ 60%  12/20 tasks done
  Releases: 1/3 completed
  In Progress: 4 | Todo: 3 | Blocked: 1

  Releases (3)
  completed      Auth v1.0       12/12 tasks
  in_progress    Auth v1.1       0/5 tasks
  planned        Auth v2.0       0/3 tasks
L’output JSON include l’oggetto epic completo, l’array delle release e le task_stats calcolate: 
apollo epic view "Authentication Overhaul" --json

{
  "id": "550e8400-...",
  "title": "Authentication Overhaul",
  "status": "active",
  "releases": [...],
  "task_stats": {
    "total": 20,
    "done": 12,
    "in_progress": 4,
    "todo": 3,
    "blocked": 1,
    "backlog": 0,
    "completed_releases": 1,
    "total_releases": 3,
    "progress_pct": 60
  }
}

​
Creare un Epic

apollo epic create \
  -t "Authentication Overhaul" \
  -p "Apollo" \
  --status active \
  --quarter "Q2 2026" \
  --description "Migrate from session-based to JWT auth"
Opzioni:
FlagDescrizione
-t, --title <title>Titolo dell’epic (obbligatorio)
-p, --project <name>Nome o ID del progetto (obbligatorio)
-s, --status <status>Stato iniziale (predefinito: draft)
--description <desc>Descrizione dell’epic
--quarter <text>Trimestre obiettivo (es: Q2 2026)
--color <hex>Codice colore esadecimale (predefinito: #6366f1)

​
Aggiornare un Epic

Aggiorna qualsiasi campo dell’epic dopo la creazione: 
# Change status
apollo epic update "Auth Overhaul" -s active

# Update quarter and description
apollo epic update "Auth Overhaul" --quarter "Q3 2026" --description "Scope expanded"

# Rename
apollo epic update "Auth Overhaul" -t "Auth & SSO Overhaul"
Opzioni:
FlagDescrizione
-t, --title <title>Nuovo titolo
-s, --status <status>Nuovo stato (draft, active, completed, archived)
--description <desc>Nuova descrizione
--quarter <text>Nuovo trimestre obiettivo
--color <hex>Nuovo codice colore esadecimale

​
Completare un Epic

Scorciatoia per impostare lo stato su completed: 
apollo epic complete "Auth Overhaul"

​
Archiviare un Epic

Scorciatoia per impostare lo stato su archived: 
apollo epic archive "Auth Overhaul"

​
Elencare le Attività dell’Epic

Recupera tutte le attività di tutte le release appartenenti all’epic. Questa è la vista dettagliata ricorsiva: 
apollo epic tasks "Auth Overhaul"

 ID       Title                        Status       Release      Assignee
─────────┼────────────────────────────┼────────────┼────────────┼──────────
 550e8400 Implement JWT middleware     done         Auth v1.0    Ian Soares
 7a3b1c2d Add refresh token rotation  in_progress  Auth v1.1    Ana Lima
 9e4f2a8b Fix token expiry edge case  blocked      Auth v1.1    Ian Soares
 ...

12 task(s) across 3 release(s)
L’output JSON restituisce l’array completo delle attività: 
apollo epic tasks "Auth Overhaul" --json
Opzioni:
FlagDescrizione
--limit <n>Massimo attività per release (predefinito: 200)