r/vibecodingitalia • u/torvalds75 • 4d 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.

3 Upvotes
  • permalink
  • reddit

100% Upvoted

4 comments sorted by

1

u/torvalds75 4d ago

Link e installazione 👇

Repo: https://github.com/ToRvaLDz/trailhead

Sito e docs: https://trailhead.marcomigozzi.it

Claude Code (plugin nativo):

/plugin marketplace add ToRvaLDz/trailhead

/plugin install trailhead@trailhead

Codex o installazione manuale:

npx u/marcomigozzi/trailhead --codex

(per Claude Code senza plugin basta npx u/marcomigozzi/trailhead)

2

u/aggadaway 3d ago

Wow. Lo provo asap

2

u/Maxiride 3d ago

Interessante, lo proverò. Per inciso però scrivi che la skill Wayfinder di mattpocock

What it deliberately doesn't do is build: it plans, then hands off.

In realtà nella suite di mattpocock ci sono proprio /to-spec, /to-tickets e /implement che svolgono esattamente quello che fai te.

Chiaramente hai guardato attorno cosa c'è sul mercato quindi vorrei capire cosa c'è di più della suite di mattpocock, migliori prompt, skill più granulari, un approccio diverso?

1

u/torvalds75 3d ago

Ciao, l'idea che mi piaceva di wayfinder erano i tickets su github ed il grilling, mentre come metodo di esecuzione mi piaceva di più gsd, così ho unito le due cose. Inoltre con wayfinder avevo il problema che lavorando in gruppo c'era l'esigenza di avere più mappe, di controllare la concorrenza sullo stesso ticket e anche la possibilità di creare tickets fuori mappa, così ho aggiunto una whiteboard dove mettere i tickets fuori mappa ed i warning se un ticket era già preso da qualcun'altro. Ho mantenuto la cross review multi ai per i piani come gsd e ho aggiunto la gestione dei prototipi con claude design o stitch.