Développer avec Claude Code

Claude Code est l’agent de codage IA d’Anthropic. IronFlock publie pour cet agent un plugin contenant la skill ironflock-templates, qui lui apprend comment une application s’intègre à IronFlock. Grâce à elle, Claude Code écrit les fichiers du répertoire .ironflock/ de votre application sous la forme attendue par la plateforme, et les vérifie avant la publication d’une version :

Fichier	Ce que l’agent peut faire
`board-template.yml`	Créer le board de l’application : choisir les widgets, les lier à vos tables, organiser les pages et la navigation
`data-template.yml`	Définir les tables et les transformations qui correspondent à ce que publie votre code
`env-template.yml`	Ajouter des paramètres d’application
`port-template.yml`	Déclarer les ports pour l’accès à distance
`ai-template.yml`	Définir les agents IA de l’application et leurs outils

Le plugin est public sur GitHub : IronFlock/agent-skills.

Contenu de la skill

Les schémas JSON des cinq templates — les mêmes que ceux publiés sur https://ironflock.com/schemas/.
Un guide du template de board : liaisons de données, filtres, agrégation, pages, navigation et mise en page.
Un catalogue de tous les widgets de board, qui précise à quelles données chaque widget est destiné.
Un outil qui lit le schéma de configuration d’un widget pour la version exacte de ce widget utilisée par un board.
Un validateur qui vérifie chaque template par rapport à son schéma et aux règles que la plateforme ne signale sinon qu’au moment de l’installation — par exemple un widget lié à une colonne qui n’existe pas.

Prérequis

Claude Code — voir le guide d’installation d’Anthropic.
Python 3.9 ou version ultérieure pour le validateur. uv est recommandé : avec uv, le validateur installe lui-même ses dépendances. Sans uv, exécutez une fois python3 -m pip install pyyaml jsonschema.
Accès Internet à registry.npmjs.org et cdn.jsdelivr.net, où sont publiés les schémas des widgets.

Installer la skill

Ajoutez la marketplace de plugins IronFlock, puis installez le plugin à partir de celle-ci — soit dans Claude Code, soit depuis un terminal :

Dans Claude Code


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

Le plugin est installé pour votre compte utilisateur : Claude Code peut donc l’utiliser dans tous vos projets. Il se charge dans les nouvelles sessions ; dans une session déjà en cours, entrez /reload-plugins. Pour vérifier l’installation, exécutez claude plugin list — la commande affiche ironflock@ironflock.

Maintenir la skill à jour

Claude Code ne met à jour les plugins des marketplaces tierces que si vous activez la mise à jour automatique. Il suffit de l’activer une fois : exécutez /plugin dans Claude Code, ouvrez Marketplaces, sélectionnez ironflock et choisissez Enable auto-update. Ou mettez à jour manuellement :


claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

Configurer la skill pour votre équipe

Pour mettre le plugin à la disposition de toutes les personnes qui travaillent sur une application, commitez ce fichier dans le dépôt de l’application sous le nom .claude/settings.json :


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

Claude Code applique le fichier dès qu’un membre de l’équipe fait confiance au dossier.

Utiliser la skill

Vous n’avez pas besoin d’appeler la skill. Claude Code l’utilise de lui-même lorsque vous travaillez sur une application IronFlock — par exemple lorsque vous demandez :

“Ajoutez à cette application un board qui affiche, pour chaque machine, la température actuelle sous forme de jauge et sa tendance sur 24 heures.”
“Rendez l’intervalle d’échantillonnage configurable par appareil, entre 1 et 60 secondes.”
“Rendez l’interface web du port 8080 accessible à distance.”

Pour lancer explicitement la skill, entrez /ironflock:ironflock-templates.

Claude Code lit d’abord le code de votre application, afin que les tables correspondent à ce que publie le code. Il écrit ensuite les templates et exécute le validateur jusqu’à ce qu’il ne reste plus aucune erreur. Vous pouvez alors ouvrir le board dans l’UI Builder pour l’ajuster visuellement — l’UI Builder lit et écrit le même fichier board-template.yml.

La skill ne modifie que les fichiers du dépôt de votre application. Publiez une nouvelle version de votre application pour que les modifications parviennent aux projets qui l’utilisent — voir Versions et l’App Store.

Valider les templates sans l’agent

Le validateur fonctionne aussi de manière autonome, par exemple dans un 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

Il affiche une ligne par problème détecté, avec le fichier, la ligne et le chemin, et se termine avec le code de sortie 1 s’il a trouvé une erreur.

Désinstaller


claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock