Claude Code로 개발

Claude Code는 Anthropic의 AI 코딩 에이전트입니다. IronFlock은 Claude Code용 플러그인을 제공하며, 이 플러그인에 포함된 ironflock-templates 스킬은 IronFlock 앱이 어떻게 구축되고 플랫폼에 어떻게 연결되는지를 에이전트에게 가르칩니다. 이 스킬을 사용하면 Claude Code가 앱 블루프린트를 따르는 새 앱을 만들고, 앱의 .ironflock/ 폴더에 있는 파일을 플랫폼이 기대하는 방식대로 작성하며, 릴리스하기 전에 검사합니다:

플러그인은 GitHub에 공개되어 있습니다: IronFlock/agent-skills.

스킬에 포함된 내용

• 앱 블루프린트: 상태를 담는 테이블부터 디바이스가 제공하는 웹 UI까지, 앱의 구성 요소가 함께 작동하는 방식.
• 이 블루프린트를 따르는 스타터 앱 — Claude Code는 이 앱을 바탕으로 새 앱을 만듭니다: 모든 디바이스에서 기계의 데이터를 읽고, 각 디바이스의 상태와 판독값을 테이블에 보관하며, 사용자가 보드에서 설정한 한계값을 적용하고, 보드가 임베드하는 라이브 뷰를 제공하는 프로그램입니다.
• 다섯 가지 템플릿 전체의 JSON 스키마 — https://ironflock.com/schemas/에 게시된 것과 동일한 스키마입니다.
• 보드 템플릿 가이드: 데이터 바인딩, 필터, 집계, 페이지, 내비게이션, 레이아웃.
• 각 위젯이 어떤 데이터에 적합한지 설명하는 전체 보드 위젯 카탈로그.
• 보드가 사용하는 바로 그 위젯 버전의 구성 스키마를 읽어 오는 도구.
• 모든 템플릿을 해당 스키마와 대조할 뿐 아니라, 평소에는 플랫폼이 설치 시점에야 알려 주는 규칙까지 검사하는 검증기 — 예를 들어 존재하지 않는 컬럼에 위젯이 바인딩된 경우.

요구 사항

• Claude Code — Anthropic의 설치 가이드를 참조하십시오.
• Python 3.9 이상 — 검증기에 필요합니다. uv 사용을 권장합니다: uv가 있으면 검증기가 자체 의존성을 직접 설치합니다. uv가 없으면 python3 -m pip install pyyaml jsonschema를 한 번 실행하십시오.
• 인터넷 접근 — 위젯 스키마가 게시되는 registry.npmjs.org 및 cdn.jsdelivr.net에 접속할 수 있어야 합니다.

스킬 설치

IronFlock 플러그인 마켓플레이스를 추가한 다음 해당 마켓플레이스에서 플러그인을 설치합니다 — Claude Code 안에서 또는 터미널에서 할 수 있습니다:

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

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

플러그인은 사용자 계정 단위로 설치되므로 Claude Code가 모든 프로젝트에서 사용할 수 있습니다. 플러그인은 새 세션에서 로드되며, 이미 실행 중인 세션에서는 /reload-plugins를 입력하십시오. 설치를 확인하려면 claude plugin list를 실행하십시오 — 목록에 ironflock@ironflock이 표시됩니다.

최신 상태 유지

Claude Code는 서드파티 마켓플레이스의 플러그인을 자동 업데이트가 켜져 있을 때만 업데이트합니다. 한 번만 켜 두면 됩니다: Claude Code에서 /plugin을 실행하고 Marketplaces를 연 다음 ironflock을 선택하고 Enable auto-update를 선택하십시오. 또는 수동으로 업데이트하십시오:

claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

팀을 위한 설정

앱에서 작업하는 모든 사람이 플러그인을 사용할 수 있게 하려면 다음 파일을 앱 저장소에 .claude/settings.json으로 커밋하십시오:

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

팀원이 해당 폴더를 신뢰하면 Claude Code가 이 파일을 적용합니다.

스킬 사용

스킬을 직접 호출할 필요는 없습니다. IronFlock 앱에서 작업하면 Claude Code가 알아서 스킬을 사용합니다 — 예를 들어 다음과 같이 요청할 때:

• “이 앱에 모든 기계의 현재 온도를 게이지와 24시간 트렌드로 보여 주는 보드를 추가해 주세요.”
• “샘플링 간격을 디바이스별로 1초에서 60초 사이로 설정할 수 있게 해 주세요.”
• “포트 8080의 웹 UI에 원격으로 접근할 수 있게 해 주세요.”
• “각 IPC에서 탱크의 수위를 읽고, 운영자가 한곳에서 모든 탱크에 일괄 설정하는 저수위 알람 한계값을 갖춘 새 앱을 만들어 주세요.”

스킬을 명시적으로 시작하려면 /ironflock:ironflock-templates를 입력하십시오.

Claude Code는 먼저 앱의 코드를 읽어 테이블이 코드가 발행하는 데이터와 일치하도록 합니다. 그런 다음 템플릿을 작성하고 오류가 남지 않을 때까지 검증기를 실행합니다. 이후 UI Builder에서 보드를 열어 시각적으로 조정할 수 있습니다 — UI Builder는 같은 board-template.yml을 읽고 씁니다.

스킬은 앱 저장소의 파일만 변경합니다. 변경 사항을 앱을 사용하는 프로젝트에 반영하려면 앱의 새 버전을 릴리스하십시오 — 릴리스 및 App Store를 참조하십시오.

에이전트 없이 템플릿 검증

검증기는 에이전트 없이 단독으로도 실행되므로, 예를 들어 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

검증기는 발견 사항마다 파일, 줄 번호, 경로를 담은 한 줄을 출력하며, 오류를 발견하면 종료 코드 1을 반환합니다.

제거

claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock