Desenvolva com o Claude Code

O Claude Code é o agente de programação com IA da Anthropic. O IronFlock publica para ele um plugin com a skill ironflock-templates, que ensina ao agente como um app se integra ao IronFlock. Com ela, o Claude Code escreve os arquivos da pasta .ironflock/ do seu app no formato que a plataforma espera e os verifica antes de você criar um release:

Arquivo	O que o agente pode fazer
`board-template.yml`	Construir o board do app: escolher widgets, vinculá-los às suas tabelas, organizar as páginas e a navegação
`data-template.yml`	Definir tabelas e transformações que correspondem ao que o seu código publica
`env-template.yml`	Adicionar parâmetros do app
`port-template.yml`	Declarar portas para acesso remoto
`ai-template.yml`	Definir os agentes de IA do app e suas ferramentas

O plugin é público no GitHub: IronFlock/agent-skills.

O que a Skill Contém

Os JSON Schemas dos cinco templates — os mesmos publicados em https://ironflock.com/schemas/.
Um guia sobre o board template: vinculações de dados, filtros, agregação, páginas, navegação e layout.
Um catálogo de todos os widgets de board, que descreve para quais dados cada widget é indicado.
Uma ferramenta que lê o esquema de configuração de um widget na versão exata do widget que um board usa.
Um validador que verifica cada template com base no seu esquema e nas regras que, sem ele, a plataforma só apontaria no momento da instalação — por exemplo, um widget vinculado a uma coluna que não existe.

Requisitos

Claude Code — veja o guia de instalação da Anthropic.
Python 3.9 ou superior para o validador. O uv é recomendado: com ele, o validador instala as próprias dependências. Sem o uv, execute python3 -m pip install pyyaml jsonschema uma vez.
Acesso à internet para registry.npmjs.org e cdn.jsdelivr.net, onde os esquemas dos widgets são publicados.

Instale a Skill

Adicione o marketplace de plugins do IronFlock e depois instale o plugin a partir dele — dentro do Claude Code ou em um terminal:

No Claude Code


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

O plugin é instalado para a sua conta de usuário, então o Claude Code pode usá-lo em todos os projetos. Ele é carregado em novas sessões; em uma sessão que já está em andamento, digite /reload-plugins. Para verificar a instalação, execute claude plugin list — o comando lista ironflock@ironflock.

Mantenha o Plugin Atualizado

O Claude Code só atualiza plugins de marketplaces de terceiros quando você ativa essa opção. Ative-a uma vez: execute /plugin no Claude Code, abra Marketplaces, selecione ironflock e escolha Enable auto-update. Ou atualize manualmente:


claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

Configure o Plugin para a Sua Equipe

Para disponibilizar o plugin a todos que trabalham em um app, faça commit deste arquivo no repositório do app como .claude/settings.json:


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

O Claude Code aplica o arquivo assim que um membro da equipe marca a pasta como confiável.

Use a Skill

Você não precisa invocar a skill. O Claude Code a usa por conta própria quando você trabalha em um app IronFlock — por exemplo, quando você pede:

“Adicione a este app um board que mostre a temperatura atual de cada máquina em um medidor e em uma tendência de 24 horas.”
“Torne o intervalo de amostragem configurável por dispositivo, entre 1 e 60 segundos.”
“Disponibilize a interface web na porta 8080 para acesso remoto.”

Para iniciar a skill explicitamente, digite /ironflock:ironflock-templates.

Primeiro, o Claude Code lê o código do seu app, para que as tabelas correspondam ao que o código publica. Em seguida, escreve os templates e executa o validador até não restar nenhum erro. Depois, você pode abrir o board no UI Builder para ajustá-lo visualmente — o UI Builder lê e escreve o mesmo board-template.yml.

A skill só altera arquivos no repositório do seu app. Crie um novo release do seu app para levar as alterações aos projetos que o utilizam — veja Releases e a App Store.

Valide Templates sem o Agente

O validador também roda de forma independente, por exemplo, em um pipeline de 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

Ele imprime uma linha por ocorrência, com arquivo, linha e caminho, e termina com o código de saída 1 se tiver encontrado um erro.

Desinstalação


claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock