power-bi-agentic-development
무엇인가
Power BI와 Microsoft Fabric 아티팩트를 다루는 에이전트 작업을 규율하는 플러그인 마켓플레이스다. 시맨틱 모델, DAX, TMDL, PBIR 보고서, 페이지 지정 보고서, 사용자 지정 시각적 개체, ETL, Fabric CLI·관리 작업, Tabular Editor와 Power BI Desktop 조작 절차를 스킬 단위로 나눠 담는다. 에이전트가 도메인 산출물을 만들 때 참조할 규칙과 스크립트를 미리 고정하는 것이 목적이다.
어떻게 동작하나
Anthropic 형식 플러그인 마켓플레이스 구조를 따른다. 루트 `.claude-plugin/marketplace.json`은 카탈로그 역할만 하고, 실제 내용은 각 자식 플러그인 디렉터리에 있다. 플러그인마다 `skills/<이름>/SKILL.md`로 규칙을 두고, 에이전트 정의는 Copilot CLI 규약에 맞춘 `*.agent.md` 확장자를 쓰며 Claude Code는 `agents/` 아래 임의 `*.md`를 매칭하므로 양쪽에서 동일 파일이 로드된다. 훅은 `hooks.json`에 등록하고 스크립트 경로를 `${CLAUDE_PLUGIN_ROOT}`로 참조한다. 스킬은 세션에 자동 로드되고, `/plugin`, `/skills list`, `/skills info <이름>`, `/agent`로 확인한다.
무엇과 다른가
단일 규칙 파일과 달리 마켓플레이스 계층을 둔다. 프롬프트를 매번 직접 작성하는 방식과 비교하면, 도메인 지식이 파일로 고정되고 훅을 통해 특정 시점에 자동 발동하며 서브에이전트로 역할이 분리된다. 하나의 `CLAUDE.md`에 모든 규칙을 몰아넣는 방식과도 다르다. 플러그인 단위로 설치·해제가 가능하고, 저장소 쪽에서 주간 단위로 갱신되므로 사용자가 규칙 내용을 직접 관리하지 않는다.
어떻게 쓰나
Claude Code에서는 `claude plugin marketplace add data-goblin/power-bi-agentic-development`로 마켓플레이스를 등록한 뒤 `/plugin`에서 설치하거나 `claude plugin install <플러그인>@power-bi-agentic-development`를 실행한다. Copilot CLI는 같은 `marketplace.json`을 읽으므로 `copilot plugin marketplace add` 후 `copilot plugin install <플러그인>@power-bi-agentic-development`로 설치하거나, 마켓플레이스 등록 없이 `copilot plugin install data-goblin/power-bi-agentic-development:plugins/pbip`처럼 하위 디렉터리를 직접 지정한다. 루트를 qualifier 없이 설치하면 카탈로그만 받아 아무것도 설치되지 않는다.
전제와 한계
Claude Code와 Copilot CLI를 대상으로 한다. 훅은 Copilot CLI 1.0.26 이상에서만 `CLAUDE_PLUGIN_ROOT`가 설정되므로 그 이전 빌드에서는 경로가 깨진다. 현재 플러그인들은 MCP 서버를 포함하지 않는다. TMDL 파일은 저장소 상대 경로가 260자를 넘으면 Windows MAX_PATH에 걸려 `git clone`과 `copilot plugin install`이 `Filename too long`으로 중단되므로 OS와 git 양쪽에서 long path를 켜야 한다. 주간 릴리스로 이름과 구조가 바뀌며, 26.26~26.38 구간은 의도적 파괴 전환이라 이전 구조가 필요하면 26.25 이하를 고정해야 한다.