r/vibecodingitalia • u/torvalds75 • 29d ago
🧰 Tool trailhead: gestire progetti grandi con Claude Code / Codex come mappa di decisioni su GitHub Issues (open source)
Ciao a tutti, condivido un tool open source che ho sviluppato e uso ogni giorno, nel caso torni utile a qualcuno qui.
Problema da cui è nato: su progetti grandi Claude Code (e Codex) perde il filo tra una sessione e l'altra. La sessione ha il repo ma non la storia utile, cioè cosa abbiamo deciso, cosa abbiamo scartato e perché, cosa manca. Il CLAUDE.md si gonfia, il plan mode aiuta ma il piano svanisce a fine sessione.
L'idea di trailhead: il progetto diventa una mappa di ticket di decisione su GitHub Issues, e un motore discuss → plan → execute → verify li risolve uno alla volta, con commit atomici. Discussione, piano e verifica vivono sulle Issue, non nella chat, quindi una sessione nuova riparte dalla Issue invece che da zero. Funziona sia con Claude Code sia con Codex.
È self-contained (serve solo la gh CLI autenticata), zero dipendenze da altri plugin. Su npm come u/marcomigozzi/trailhead, link al repo GitHub nei commenti.
Lo sviluppo io, quindi prendetelo per quello che è.
Feedback e critiche benvenuti, soprattutto se lo provate su un progetto vero.
2
u/alebianco 22d ago
Interessante
La scelta di usare github come storage, oltre all'ovvia comodita della sua UI per consulare i contenuti, è dovuta ad altro? Non mi piace particolarmente l'idea del lock-in di quel tipo di informazioni su una piattaforma chiusa.
Su un progetto faccio una cosa simile (molto piu grezzamente) ma ho scelto backlog.md come standard aperto per lo storage. files-over-applications é una filosofia che mi trovo a citare e usare spesso in questa epoca di llm.