Vai al contenuto

Lo stato nel tracker

Wayloop non ha uno stato proprio. Il piano, l'avanzamento, le decisioni e le domande vivono nell'issue tracker; le specifiche vivono nel repository; in locale restano solo i checkpoint delle sessioni.

Stato

Questa pagina descrive il progetto registrato nell'ADR 0002. Oggi il motore non ha un adattatore per il tracker. Questo repository applica il progetto a mano: il piano è roadmap/roadmap.yaml, e scripts/roadmap.py sync vi copia da GitHub lo stato di ogni issue. Ciò che viene dopo è nella roadmap.

Cosa Dove vive Perché
Roadmap, epic, story, task Issue, sotto-issue, dipendenze, tipi di issue, milestone Visibile al team e a qualunque strumento; sopravvive alla rimozione di Wayloop
Avanzamento, domande, decisioni, esiti dei gate Campi e commenti delle issue I gate diventano asincroni: si può decidere anche dal telefono
Specifiche vive e modifiche a delta Il repository, collegato dall'issue Cambiano insieme al codice e si revisionano nelle pull request
Checkpoint di sessione La macchina locale, mai committati Servono solo a riprendere un lavoro interrotto
Cache del tracker La macchina locale, ricostruibile Velocità e determinismo; mai una fonte di verità

Dove il progetto è sotto sforzo, e come regge

  • Velocità. Le API remote sono lente e hanno limiti di frequenza. Il motore lavora su una cache locale aggiornata in modo incrementale, che si può cancellare e ricostruire in qualunque momento.
  • Testo libero. Anche le persone modificano il corpo delle issue. Il motore usa i campi nativi (sotto-issue, dipendenze "blocked by", tipi di issue) e un blocco strutturato validato da uno schema; ciò che non valida diventa una domanda, mai un errore silenzioso.
  • Storia del piano. Ogni proposta di modifica è un commento con la differenza e un'etichetta di gate; l'approvazione resta nella cronologia dell'issue.
  • Concorrenza. Un'issue viene presa in carico con un assegnatario e un'etichetta, e scritta solo se non è cambiata dall'ultima lettura.
  • Tracker senza relazioni native. Sul piano gratuito di GitLab le relazioni "blocks" e le epic non sono disponibili; le porta invece il blocco strutturato.
  • Eventi a catena. Un merge riavvia la riconciliazione tramite un workflow. Gli eventi prodotti dal bot creano solo proposte, sono idempotenti e vengono raggruppati, così il loop non si alimenta da solo.

La prova della rimozione

L'impostazione è giusta solo se un progetto resta leggibile dopo la rimozione di Wayloop: issue, specifiche e commenti di passaggio devono raccontare tutta la storia da soli.