Sviluppare con Claude Code

Claude Code è l’agente AI di Anthropic per la programmazione. IronFlock pubblica per Claude Code un plugin con la skill ironflock-templates, che insegna all’agente come è costruita un’app IronFlock e come si integra nella piattaforma. Con questa skill, Claude Code crea nuove app che seguono il Blueprint dell’App, scrive i file nella cartella .ironflock/ della tua app nel modo in cui la piattaforma se li aspetta, e li verifica prima della release:

File	Cosa può fare l’agente
`board-template.yml`	Creare la board dell’app: scegliere i widget, collegarli alle tue tabelle, organizzare pagine e navigazione
`data-template.yml`	Definire tabelle e trasformazioni che corrispondano a ciò che pubblica il tuo codice
`env-template.yml`	Aggiungere parametri dell’app
`port-template.yml`	Dichiarare le porte per l’accesso remoto
`ai-template.yml`	Definire gli agenti AI dell’app e i loro strumenti

Il plugin è pubblico su GitHub: IronFlock/agent-skills.

Cosa Contiene la Skill

Il Blueprint dell’App: come lavorano insieme le parti di un’app, dalle tabelle che ne contengono lo stato alle web UI servite dai dispositivi.
Un’app di partenza che lo segue, da cui Claude Code crea una nuova app: un programma che su ogni dispositivo legge i dati di una macchina, mantiene nelle tabelle lo stato e le letture di ciascun dispositivo, applica un limite che gli utenti impostano sulla board e serve una vista live che la board incorpora.
Gli schemi JSON di tutti e cinque i template — gli stessi pubblicati su https://ironflock.com/schemas/.
Una guida al template della board: collegamenti ai dati, filtri, aggregazione, pagine, navigazione e layout.
Un catalogo di tutti i widget per le board, che descrive per quali dati è pensato ciascun widget.
Uno strumento che legge lo schema di configurazione di un widget per la versione esatta del widget usata da una board.
Un validatore che verifica ogni template rispetto al suo schema e alle regole che altrimenti la piattaforma segnala solo al momento dell’installazione — ad esempio un widget collegato a una colonna che non esiste.

Requisiti

Claude Code — vedi la guida all’installazione di Anthropic.
Python 3.9 o superiore per il validatore. uv è consigliato: con uv, il validatore installa da solo le proprie dipendenze. Senza uv, esegui una volta python3 -m pip install pyyaml jsonschema.
Accesso a internet verso registry.npmjs.org e cdn.jsdelivr.net, dove sono pubblicati gli schemi dei widget.

Installare la Skill

Aggiungi il marketplace di plugin di IronFlock, poi installa il plugin da lì — all’interno di Claude Code oppure da un terminale:

In Claude Code


/plugin marketplace add IronFlock/agent-skills
/plugin install ironflock@ironflock

Il plugin viene installato per il tuo account utente, quindi Claude Code può usarlo in ogni progetto. Viene caricato nelle nuove sessioni; in una sessione già in corso, digita /reload-plugins. Per verificare l’installazione, esegui claude plugin list — nell’elenco compare ironflock@ironflock.

Mantenerlo Aggiornato

Claude Code aggiorna i plugin dei marketplace di terze parti solo se attivi questa opzione. Attivala una volta sola: esegui /plugin in Claude Code, apri Marketplaces, seleziona ironflock e scegli Enable auto-update. Oppure aggiorna manualmente:


claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

Configurarlo per il Tuo Team

Per rendere il plugin disponibile a chiunque lavori su un’app, fai il commit di questo file nel repository dell’app come .claude/settings.json:


{
  "extraKnownMarketplaces": {
    "ironflock": {
      "source": { "source": "github", "repo": "IronFlock/agent-skills" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": { "ironflock@ironflock": true }
}

Claude Code applica il file non appena un membro del team considera attendibile la cartella.

Usare la Skill

Non è necessario richiamare la skill. Claude Code la usa di sua iniziativa quando lavori su un’app IronFlock — ad esempio quando chiedi:

“Aggiungi a questa app una board che mostri la temperatura attuale di ogni macchina come gauge e l’andamento delle ultime 24 ore.”
“Rendi l’intervallo di campionamento configurabile per dispositivo, tra 1 e 60 secondi.”
“Rendi la web UI sulla porta 8080 disponibile per l’accesso remoto.”
“Crea una nuova app che legga il livello di riempimento del serbatoio di ciascun IPC, con una soglia di allarme di livello basso che gli operatori impostano in un unico punto per tutti i serbatoi.”

Per avviare esplicitamente la skill, digita /ironflock:ironflock-templates.

Claude Code legge prima il codice della tua app, in modo che le tabelle corrispondano a ciò che il codice pubblica. Poi scrive i template ed esegue il validatore finché non resta più alcun errore. Successivamente puoi aprire la board in UI Builder per rifinirla visivamente — UI Builder legge e scrive lo stesso board-template.yml.

La skill modifica solo i file nel repository della tua app. Pubblica una nuova release della tua app per portare le modifiche nei progetti che la usano — vedi Release e App Store.

Validare i Template senza l’Agente

Il validatore funziona anche in modo autonomo, ad esempio in una pipeline CI:


git clone https://github.com/IronFlock/agent-skills
uv run agent-skills/plugins/ironflock/skills/ironflock-templates/scripts/validate.py path/to/your-app

Stampa una riga per ogni segnalazione, con file, riga e percorso, ed esce con codice 1 se ha trovato un errore.

Disinstallazione


claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock