Repo del giorno: claude-code-workflows, dal requisito al commit con agenti specializzati

💡 Cos'è: un marketplace, quattro plugin

Il repository di shinpr non è un singolo plugin ma un marketplace per Claude Code: lo aggiungi una volta e installi il pezzo che ti serve. dev-workflows copre backend, API e CLI; dev-workflows-frontend aggiunge agenti React/TypeScript; dev-workflows-fullstack unisce i due mondi in un plugin solo; dev-skills è la variante minimale, solo regole e best practice, per chi ha già una propria orchestrazione.

La promessa è concreta: il codice prodotto è allineato ai design doc e passa i suoi test, perché ogni fase — requisiti, design, implementazione, quality check — è gestita da un agente dedicato che lavora in un contesto fresco. Le fasi non si inquinano a vicenda, che è il difetto tipico delle sessioni lunghe con un agente solo.

# 1. aggiungi il marketplace
/plugin marketplace add shinpr/claude-code-workflows

# 2. installa il plugin per il tuo stack
/plugin install dev-workflows@claude-code-workflows
/reload-plugins

# 3. costruisci una feature end-to-end
/recipe-implement "autenticazione utenti con JWT"

🧭 Come funziona: il lavoro viene instradato per dimensione

Il cuore del sistema è il requirement-analyzer: valuta quanto è grande la richiesta e sceglie il percorso. Un task piccolo (1-2 file) va dritto in implementazione; uno medio passa dall'analisi del codebase; uno grande (6+ file) attraversa l'intera pipeline con PRD, design doc, review dei documenti e piano di lavoro spezzato in task committabili.

È la parte più intelligente del progetto: niente burocrazia sui fix da due righe, niente improvvisazione sulle feature grosse. La cerimonia è proporzionale al rischio, decisa da un agente e non dalla fretta del momento.

🤖 Gli agenti specializzati: un team, non un tuttofare

Sotto il cofano ci sono più di venti agenti con ruoli precisi. Alcuni sono condivisi fra i plugin, altri specifici per backend o frontend. La divisione dei ruoli ricalca un team vero: chi analizza non implementa, chi implementa non si autopromuove in reviewer.

Tre esempi rendono l'idea del livello di dettaglio raggiunto dal progetto:

• task-executor implementa con TDD e produce chunk pronti al commit, mentre quality-fixer fa girare test, type check e lint e corregge quello che trova.
• investigator, verifier e solver formano il flusso di diagnosi: mappano i percorsi di esecuzione, validano i punti di failure con metodo Devil's Advocate e propongono soluzioni con analisi dei trade-off.
• security-reviewer passa l'implementazione al setaccio a fine lavoro, e design-sync verifica la coerenza fra più design doc — prezioso sul fullstack, dove backend e frontend hanno documenti separati.

🍳 Le recipe: un comando per ogni scenario

L'interfaccia utente del sistema sono le recipe, slash command con prefisso comune: digiti la barra e il completamento ti mostra tutti i flussi disponibili. Le tre che usiamo di più nei nostri test: recipe-implement per la feature completa, recipe-diagnose per investigare un bug prima di toccare il codice, recipe-task per la modifica chirurgica con quality check.

La più sorprendente è recipe-reverse-engineer: parte dal codice esistente e genera PRD e design doc verificati contro l'implementazione reale. Per chi ha un legacy non documentato è un acceleratore serio: rende il codebase leggibile agli agenti AI prima ancora che alle persone.

/recipe-implement "nuova feature end-to-end"
/recipe-task "fix puntuale con quality check"
/recipe-diagnose "la API risponde 500 al login"
/recipe-reverse-engineer "src/auth"

# fullstack (plugin dedicato)
/recipe-fullstack-implement "JWT + form di login"

⚖️ Con o senza orchestrazione: dev-workflows vs dev-skills

Una scelta di design che apprezziamo: il progetto non impone la sua orchestrazione. Se hai già i tuoi prompt, i tuoi script o un loop guidato dalla CI, installi dev-skills e prendi solo le regole — coding principles, testing principles, standard di documentazione — che gli agenti caricano quando servono.

Attenzione a un dettaglio documentato bene nel README: i plugin condividono le stesse skill, quindi non vanno installati insieme. Claude Code riserva alle descrizioni delle skill circa il 2% della finestra di contesto: superarlo fa ignorare silenziosamente delle skill.

🏢 Perché è interessante per sviluppatori e PMI

Per lo sviluppatore il valore è immediato: pattern di orchestrazione già rodati da studiare o rubare — contesti freschi per fase, routing per complessità, quality gate prima del commit. Sono le stesse idee che applichiamo nei nostri progetti di vibe coding strutturato, e trovarle impacchettate in un plugin MIT accorcia la curva a chiunque parta oggi.

Per una PMI il punto è un altro: la differenza fra «abbiamo provato l'AI» e «l'AI è nel processo» sta esattamente qui. Un flusso dove ogni feature nasce con requisiti scritti, design doc verificati contro il codice e test che passano è un flusso auditabile, dove il lavoro dell'agente si controlla come quello di un fornitore. L'ecosistema intorno — metronome contro le scorciatoie dell'agente, pr-review per le review sui PR GitHub, il gemello codex-workflows per chi usa Codex CLI — dice che il progetto è vivo: ultimo push il 6 luglio, versione 0.22.x, oltre 140 PR mergiate.

repo      shinpr/claude-code-workflows
stelle    ~500 · licenza MIT
attività  ultimo push 06-07-2026 · v0.22.3
contenuto 4 plugin · 20+ agenti · recipe-*
extra     metronome · pr-review · codex-workflows

🗺️ Da dove partire

Il percorso che suggeriamo: aggiungi il marketplace, installa dev-workflows su un progetto secondario e lancia una recipe-implement su una feature vera ma non critica. Guarda i documenti che genera in docs/prd e docs/design prima ancora del codice: è lì che capisci se il metodo fa per te. Ricorda di ignorare docs/plans nel gitignore — è stato di lavoro effimero, non documentazione.

Se il tuo team vuole portare questo tipo di disciplina nei processi di sviluppo — con Claude Code, Codex o strumenti su misura — è esattamente il terreno su cui lavoriamo ogni giorno: parlane con noi e costruiamo il workflow adatto al tuo contesto.

Altri articoli del blog