Comandi, subagent e skill

Il repository porta con sé gli strumenti che insegnano a Claude Code a lavorare secondo le regole del progetto. Sono di tre tipi:

• Comandi — li invochi tu, scrivendo /nome in Claude Code. Guidano un'attività precisa, come lo scaffold di un processo.
• Subagent — lavorano in un contesto separato e con strumenti limitati. Claude li usa da solo quando il compito corrisponde alla loro descrizione, oppure glieli chiedi per nome. Quasi tutti sono in sola lettura: rivedono, non modificano.
• Skill — conoscenza che Claude carica quando serve: come si costruisce un grafo su questo framework, con le sue regole.

I tre revisori hanno confini netti: graph-auditor guarda la struttura del grafo, etl-reviewer la correttezza del dato, schema-contract-auditor i contratti.

Cerca uno strumento

13 strumenti

• Comando
  /doc-sync

  Verifica che codice e documentazione siano allineati e segnala le derive

  .claude/commands/doc-sync.md
• Comando
  /etl-review

  Review specifica per pipeline dati — idempotenza, contratti, errori, performance

  .claude/commands/etl-review.md
• Comando
  /new-connector <nome> [source|sink]

  Scaffold di un connettore (Source o Sink) verso un sistema reale, con contratto e test

  .claude/commands/new-connector.md
• Comando
  /new-pipeline <nome-pipeline-kebab-case>

  Scaffold completo di una nuova pipeline ETL (schema, definizione, run, test, doc)

  .claude/commands/new-pipeline.md
• Comando
  /new-transform <nome>

  Scaffold di una trasformazione ETL riusabile con test

  .claude/commands/new-transform.md
• Subagentsola lettura
  doc-syncer

  Verifica l'allineamento tra codice e documentazione (schede pipeline, ADR, .env.example, link) e segnala le derive.

  Dettagli

  Verifica l'allineamento tra codice e documentazione (schede pipeline, ADR, .env.example, link) e segnala le derive. Usalo OBBLIGATORIAMENTE a fine lavoro ogni volta che una funzionalità è stata aggiunta, modificata o rimossa (pipeline, connettore, transform, core, CLI, endpoint, env), e prima di una PR per garantire "doc e codice nello stesso commit". Read-only di default: applica correzioni solo se richiesto.

  Tool:ReadGrepGlobBash

  .claude/agents/doc-syncer.md
• Subagentsola lettura
  etl-reviewer

  Esegue una review specifica ETL/dati sulle modifiche correnti (diff) in contesto isolato.

  Dettagli

  Esegue una review specifica ETL/dati sulle modifiche correnti (diff) in contesto isolato. Usalo PROATTIVAMENTE prima di aprire una PR o dopo aver completato una pipeline/connettore/transform, e ogni volta che serve un parere sulla correttezza dati senza saturare il contesto principale con diff lunghi. Read-only: non modifica file.

  Tool:ReadGrepGlobBash

  .claude/agents/etl-reviewer.md
• Subagentsola lettura
  graph-auditor

  Audita la struttura di un grafo ETL e il suo cablaggio: topologia (nodi, porte, guard, fan-out), registrazione in PIPELINES, coerenza getSpec() ↔ run(), e metadati per la UI del DAG…

  Dettagli

  Audita la struttura di un grafo ETL e il suo cablaggio: topologia (nodi, porte, guard, fan-out), registrazione in PIPELINES, coerenza getSpec() ↔ run(), e metadati per la UI del DAG (descriptor, columns, sync col submodule noeva-etl-ui). Usalo dopo aver scritto o modificato una pipeline a grafo, prima di una PR, o quando una pipeline "non si vede" in CLI/UI o il DAG mostrato non corrisponde a quello eseguito. Read-only: non modifica file.

  Tool:ReadGrepGlobBash

  .claude/agents/graph-auditor.md
• Subagentscrive file
  graph-builder

  Scaffolda una pipeline a grafo completa e cablata: schema.ts (contratti Zod), pipeline.ts (DSL graph()), run.ts (RunnablePipeline), registrazione in PIPELINES, test colocati e scheda doc.

  Dettagli

  Scaffolda una pipeline a grafo completa e cablata: schema.ts (contratti Zod), pipeline.ts (DSL graph()), run.ts (RunnablePipeline), registrazione in PIPELINES, test colocati e scheda doc. Usalo quando la forma della pipeline è già decisa (sorgenti, destinazioni, regole, strategia di errore) e serve materializzarla secondo le convenzioni del repo. SCRIVE file, solo dentro il perimetro dichiarato. Se una scelta di dominio non è specificata, si ferma e la chiede invece di inventarla.

  Tool:ReadGrepGlobEditWriteBash

  .claude/agents/graph-builder.md
• Subagentsola lettura
  project-pulse

  Il "braccio destro" del maintainer per la gestione del progetto su GitHub.

  Dettagli

  Il "braccio destro" del maintainer per la gestione del progetto su GitHub. Legge i dati reali via gh (PR, branch, commit, run CI, issue) e produce un briefing chiaro e prioritizzato: cosa richiede attenzione ora, stato delle PR, chi lavora dove, salute della CI, statistiche di progetto e colli di bottiglia. Usalo quando chiedi "come va il progetto?", "stato delle PR", "chi sta lavorando su cosa", "ci sono PR ferme?", "statistiche/velocità", o per un check periodico. Read-only: non fa merge/close/commenti se non glielo chiedi.

  Tool:ReadGrepGlobBash

  .claude/agents/project-pulse.md
• Subagentsola lettura
  schema-contract-auditor

  Audita i contratti dati del progetto: ogni Source/Sink/Pipeline deve avere uno schema Zod su input e output, e ogni record invalido un percorso esplicito (dead-letter o fail-fast), mai uno scarto…

  Dettagli

  Audita i contratti dati del progetto: ogni Source/Sink/Pipeline deve avere uno schema Zod su input e output, e ogni record invalido un percorso esplicito (dead-letter o fail-fast), mai uno scarto silenzioso. Usalo quando aggiungi o modifichi connettori, schema o pipeline e vuoi garantire la correttezza dati al confine. Read-only: non modifica file.

  Tool:ReadGrepGlobBash

  .claude/agents/schema-contract-auditor.md
• Subagentscrive file
  test-author

  Scrive o completa i test vitest per una Transform, Source, Sink o Pipeline secondo le regole del progetto (colocazione, casi di errore, dead-letter, metriche, test-first sui bug).

  Dettagli

  Scrive o completa i test vitest per una Transform, Source, Sink o Pipeline secondo le regole del progetto (colocazione, casi di errore, dead-letter, metriche, test-first sui bug). Usalo quando aggiungi/modifichi logica in src/ e mancano i test, o quando un bug fix richiede prima un test rosso. È l'unico agente che SCRIVE file (solo test).

  Tool:ReadGrepGlobEditWriteBash

  .claude/agents/test-author.md
• Skill
  etl-graph

  Costruisce, cabla e configura un grafo ETL su questo framework — DSL graph(), i sei tipi di nodo, porte e fan-out, gestione errori (dead-letter, try/catch, fail-fast), registrazione nel registry…

  Dettagli

  Costruisce, cabla e configura un grafo ETL su questo framework — DSL graph(), i sei tipi di nodo, porte e fan-out, gestione errori (dead-letter, try/catch, fail-fast), registrazione nel registry delle pipeline e in quello delle istanze connettore, metadati per la UI del DAG (descriptor, columns), e i pattern dato (idempotenza, incrementale, streaming). Usare quando si progetta, implementa o rivede una pipeline, un Source, un Sink o una Transform.

  .claude/skills/etl-graph/SKILL.md

Da dove viene questo catalogo

L'elenco è generato a ogni build dai file in .claude/ del repository: un comando nuovo, o una descrizione cambiata, compare qui senza che nessuno aggiorni questa pagina.

Quale usare, quando

Momento	Strumento
Parti da un bisogno	/new-pipeline <nome>, con la skill etl-graph
La forma del processo è già decisa	il subagent graph-builder
Serve un sistema che non è ancora supportato	/new-connector <nome>
Serve una trasformazione riusabile	/new-transform <nome>
Mancano test, o un bug va riprodotto	il subagent test-author
Prima della Pull Request	/etl-review, graph-auditor, schema-contract-auditor
Hai aggiunto, cambiato o tolto una funzionalità	/doc-sync o il subagent doc-syncer
Vuoi sapere com'è messo il progetto	il subagent project-pulse