gstack è il set di skill che Garry Tan, presidente e CEO di Y Combinator, dichiara di usare ogni giorno: lo chiama la sua "fabbrica del software" open source. Sono comandi slash scritti in Markdown che fanno lavorare Claude Code come un piccolo team: un CEO che mette in discussione il prodotto, un responsabile tecnico, un designer, un revisore, un QA con un browser vero, un responsabile della sicurezza e un release manager.
Quante skill sono
Il conteggio dipende da dove si guarda: la descrizione del repository parla di 23 strumenti "principali", ma il README ne elenca oltre 40 nella tabella del flusso di lavoro e altri nella sezione "Power tools", e la documentazione ne aggiunge ancora. In ogni caso il progetto è grande e cresce in fretta. È tutto gratuito, con licenza MIT.
Il README organizza i comandi come uno sprint: Think → Plan → Build → Review → Test → Ship → Reflect.
Installazione
Requisiti: Claude Code, Git e Bun (il README indica la 1.4.2 come versione testata; Node.js serve in più su Windows). Il README suggerisce di incollare in Claude Code un prompt che esegue:
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack && cd ~/.claude/skills/gstack && ./setupLo stesso prompt aggiunge una sezione "gstack" al CLAUDE.md: leggila e adattala, perché tra l'altro indica all'agente di usare il browser di gstack al posto di altri strumenti.
Per un team c'è la modalità condivisa (./setup --team e gstack-team-init required oppure optional). Per altri agenti (Codex, Cursor, OpenCode, Gemini CLI, Copilot CLI…) si clona in ~/gstack e si lancia ./setup --host auto.
Su Windows il supporto è minimo: c'è .\setup.ps1 da PowerShell, ma il README segnala che Smart App Control di Windows 11 blocca i binari non firmati; le alternative sono WSL o Git Bash.
/office-hours: si parte da qui
È la simulazione di un incontro di "office hours" di Y Combinator, e il README lo indica come il punto di partenza di ogni progetto, prima di pianificare o scrivere codice. L'agente:
- chiede qual è il problema reale, con esempi concreti, e contesta come lo hai formulato;
- in modalità startup pone sei domande "obbliganti": domanda reale, status quo, specificità, il cuneo più stretto da cui entrare nel mercato, osservazioni e sorprese, tenuta nel futuro;
- in modalità builder (hackathon, progetti personali, studio) fa domande più generative;
- propone 2-3 approcci con stima dell'impegno;
- scrive un documento di design in
~/.gstack/projects/che gli altri comandi (/plan-ceo-review,/autoplan) leggono.
La documentazione riporta un esempio in cui un'idea di "app di briefing quotidiano" viene riformulata in un "capo di gabinetto AI personale": è questo il tipo di spinta che il comando cerca di dare.
/design-shotgun: fammi vedere delle alternative
Genera più varianti di design (il README parla di 4-6 mockup, la documentazione di 3 varianti generate con l'API GPT Image, quindi serve probabilmente una chiave OpenAI), apre una tavola di confronto nel browser e raccoglie il tuo giudizio: approva, remix o rigenera. Se nel progetto c'è un DESIGN.md ne rispetta i vincoli.
La variante approvata viene salvata in ~/.gstack/projects/<progetto>/designs/ e il comando impara i tuoi gusti tra una sessione e l'altra. Il passo successivo naturale è /design-html, che trasforma il mockup approvato in HTML funzionante.
/diagram: dall'italiano a un diagramma modificabile
"English in, editable diagram out": descrivi a parole un flusso o un'architettura e ottieni tre file:
- il sorgente Mermaid;
- un file .excalidraw modificabile su excalidraw.com, in stile disegnato a mano;
- il rendering in SVG/PNG.
Il rendering avviene in locale, senza servizi di rete, usando il browser incluso in gstack. Il sorgente Mermaid si può incorporare nel Markdown e /make-pdf lo rende come grafica vettoriale.
Gli altri comandi da conoscere
| Comando | Ruolo |
|---|---|
/plan-ceo-review | Revisione da fondatore: espandere, mantenere o ridurre il perimetro |
/autoplan | Esegue in sequenza le revisioni di prodotto, design e tecniche |
/review | Revisione del diff da staff engineer, con correzioni automatiche dei casi ovvi |
/qa | Apre un browser reale, prova i flussi e corregge i bug trovati |
/cso | Audit di sicurezza (OWASP + STRIDE) |
/ship | Sincronizza, esegue i test, pusha e apre la PR |
/careful, /freeze, /guard | Avvisi prima dei comandi distruttivi e modifiche limitate a una cartella |
/retro | Retrospettiva settimanale |
Privacy e consigli
- La telemetria è disattivata per impostazione predefinita; il controllo degli aggiornamenti si spegne con
gstack-config set update_check false. - Le revisioni "esterne" (inviare il codice a Codex per un secondo parere) sono attive di default: si disattivano con
gstack-config set codex_reviews disabled. - Non serve adottarlo tutto:
/office-hourse/diagramdanno valore anche da soli.
Per l'aspetto grafico delle interfacce gstack si combina bene con Unslop e Impeccable.