SETUP & HOW-TO

Configurazione e metodo d'uso globale

Installa una base + un framework + due file piccoli, e sei a posto. Con un po' di fortuna, 30 minuti bastano.

Cosa installare: solo tre livelli

Non spaventarti per l'«installazione». L'intero sistema è solo tre livelli: capito questo, non ti spaventa più niente.

Terzo livello

Competenze indipendenti

File singoli, basta copiarli dentro: competitor-watch (competitor) · prd-generator (scrivi PRD)

Secondo livello

Framework gstack

Installa una volta e hai oltre 70 competenze: office-hours / design-shotgun / design-html / qa / make-pdf …

Primo livello

Claude Code (il core)

L'app base, senza di essa tutto il resto è inutile.

Lista delle competenze essenziali

Le 7 core (obbligatorie, corrispondono alle cinque fasi)

CompetenzaUtilizzoOrigineFase
/competitor-watchAnalisi competitorIndipendenteScoprire
/office-hoursAffina idee, chiarisce requisitigstackDefinire
/prd-generatorGenera PRDIndipendenteDefinire
/design-shotgunGenera più varianti di design in una voltagstackProgettare
/design-htmlTrasforma il design in prototipo funzionantegstackSviluppare
/qaTest automatici per trovare buggstackValidare
/make-pdfConverti markdown in PDF elegantegstackSempre

Le 6 avanzate (usale dopo che hai padronanza, tutte da gstack)

CompetenzaUtilizzo
/design-consultationDefinisci un intero design system (colori/font/stile)
/plan-ceo-reviewSfida il tuo piano con la «prospettiva del CEO»
/plan-eng-reviewRivedi il tuo piano con la «prospettiva tecnica»
/investigateAnalisi sistematica della causa radice dei problemi
/context-save · /context-restoreSalva/ripristina lo stato di lavoro tra sessioni diverse
/learnCapitalizza e recupera le esperienze del team
Non serve impararle tutte subito. Padroneggia prima le 7 core, poi naturalmente vorrai usare quelle avanzate.

Passi di installazione

Modo A (consigliato): il team lead copia la configurazione già funzionante

Il più semplice, il meno soggetto a errori. Il lead manda in pacchetto l'intera directory .claude\skills\.

Per ogni membro:

1Installa il core Claude Code (vedi Modo B, passo ①)
2Decomprimi le skills ricevute in C:\Users\<tuo-nome>\.claude\skills\
3Entra nella directory gstack ed esegui ./setup
4Esegui la verifica (sezione successiva)

Modo B: installazione da zero

① Installa il core Claude Code

npm install -g @anthropic-ai/claude-code

Dopo l'installazione accedi con il tuo account (il team usa abbonamento Pro/Team condiviso). Se non hai Node/npm installa prima Node.js.

② Installa il framework gstack (una riga: clone + inizializzazione automatica)

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack \
  && cd ~/.claude/skills/gstack && ./setup

gstack si aggiorna da solo. Per aggiornare manualmente, nella conversazione digita /gstack-upgrade.

③ Aggiungi le competenze indipendenti

Copia le directory competitor-watch e prd-generator in ~/.claude/skills/.

Suggerimento: se competenze come /browse danno errore, entra nella directory gstack ed esegui bun install && bun run build per aggiungere le dipendenze.

Verifica: come confermare che tutto è installato

Dopo l'installazione non fretta a lavorare, prima dedica 2 minuti allo smoke test.

1

Conferma che il core funziona

Nel terminale digita claude, se entra nell'interfaccia di dialogo = primo livello OK.

claude
2

Conferma che le competenze ci sono tutte

Nella conversazione digita un /, se vedi un lungo elenco di competenze = framework e competenze OK.

/   (conferma che le 7 core ci sono tutte)
3

Prova una competenza vera

Se comincia a farti domande = tutto pronto, puoi lavorare.

/office-hours voglio creare uno strumento per raccogliere automaticamente i report settimanali del team

Metodo d'uso globale (flusso integrato)

Collega tutte le competenze in un flusso di lavoro completo. Ricorda questa linea e sai sempre quale competenza usare.

Scoprire
/competitor-
watch
Definire
/office-hours
/prd-generator
Progettare
/design-
shotgun
Prototipare
Dialogo +
/design-html
Validare
/qa

Azioni standard (seguile e basta)

StepCome fare
0 Crea progettoCrea una cartella in D:\PM\<nome-progetto>\, entra, di' «aiutami a inizializzare questo progetto»
1 Scoprire/competitor-watch analizza [URL competitor], focus su [punto di attenzione]
2 Definire/office-hours voglio fare [idea]/prd-generator scrivi PRD completo
3 Progettare/design-shotgun crea 3 varianti di stile per [una pagina]
4 Prototipare/design-html crea il prototipo, poi aggiungi una funzione alla volta, itera in dialogo (piccoli passi veloci)
5 Validare/qa testa questo prototipo, elenca i problemi
Non serve memorizzare i nomi delle competenze. Ricorda le cinque azioni «scoprire → definire → progettare → sviluppare → validare» e per ciascuna digita / per scegliere la competenza corrispondente. Per consegnare documenti usa /make-pdf.

Manutenzione ordinaria e onboarding nuovi membri

Manutenzione ordinaria (responsabilità del team lead)

AttivitàCome fare
Aggiorna frameworkNella conversazione di' /gstack-upgrade, oppure abilita l'aggiornamento automatico
Aggiungi nuove competenzeMetti la directory della competenza in ~/.claude/skills/, riavvia Claude Code
Standardizza le normeCondividi i vincoli di base, mettili nel CLAUDE.md di ogni progetto
Capitalizza le esperienzeAggiungi buone pratiche e problemi incontrati alla «Guida operativa standard»

Il percorso più rapido per i nuovi membri

  1. Configura l'ambiente (Modo A, chiedi il pacchetto al lead)
  2. Esegui lo smoke test
  3. Usa un piccolo requisito e percorri le cinque fasi
  4. Completato il percorso = sei operativo
Con un po' di fortuna 30 minuti bastano. Se ti blocchi non stare a perdere tempo da solo, chiedi al lead.
Realizzati con questo metodo Tutto creato con Claude Code