development-plugin-for-avalonia
무엇인가
Development Plugin for Avalonia는 Avalonia 데스크톱 애플리케이션을 만들고 검토하고 설계하고 다른 UI 스택에서 옮겨 오는 작업을 에이전트가 수행할 때 따를 절차와 API 지식을 주입하는 플러그인이다. 하나의 거대한 규칙 파일 대신 부트스트랩·바인딩·스레딩·스타일·템플릿·입력·컨트롤·레이아웃·렌더링·플랫폼 서비스·접근성·테스트 진단이라는 초점 영역별 스킬로 나뉜다.
어떻게 동작하나
루트 SKILL.md가 우산 워크플로의 정본이고, 저장소 안에서 작업할 때는 .agents/skills/development-plugin-for-avalonia/SKILL.md가 얇은 진입점으로 동작해 넓은 요청을 초점 스킬과 공유 참조로 넘긴다. 플러그인 검색은 .codex-plugin/plugin.json이 skills/ 아래 스킬들을 노출하고, .agents/plugins/marketplace.json이 저장소 루트를 플러그인 디렉터리로 가리킨다. 규칙 내용은 Avalonia 11.3.12를 기본 구현 기준으로 고정하고, 문서가 명시적으로 예외를 선언하지 않는 한 master 전용 API에 의존하지 않도록 지시한다.
무엇과 다른가
프롬프트에 Avalonia 규칙을 직접 적어 넣거나 단일 CLAUDE.md·AGENTS.md에 모두 몰아넣는 방식과 달리, 라우팅 계층과 초점 스킬, 공유 참조 코퍼스를 분리한다. 참조 문서는 references/compendium.md를 정점으로 한 하나의 코퍼스를 모든 스킬이 공유하므로 같은 내용이 스킬마다 중복되지 않는다. 마이그레이션 계열 스킬은 HTML/CSS·WinForms·WPF·WinUI 각각의 멘털 모델 차이를 별도 레인으로 다루고, Avalonia 12 전환도 독립 레인으로 분리한다.
어떻게 쓰나
저장소를 체크아웃하면 .agents/plugins/marketplace.json을 통해 로컬 마켓플레이스로 바로 읽히고, 개인 설치에는 플러그인을 ~/.codex/plugins/로 복사한 뒤 ~/.agents/plugins/marketplace.json에 항목을 추가한다. 저장소 루트 자체가 플러그인 루트이므로 source.path는 ./를 유지한다. 첫 사용은 Avalonia 빌드·리뷰·이식 요청을 던지면 우산 스킬이 해당 초점 스킬로 넘기는 방식이다.
전제와 한계
Codex의 스킬·플러그인 검색 경로를 읽는 런타임을 전제로 하며, Claude Code에 붙일 때도 같은 파일 구조를 따른다. 기본 안내는 Avalonia 11.3.12에 맞춰져 있고 Avalonia 12는 references/68-avalonia-12-migration-guide.md, references/69-avalonia-12-breaking-changes-and-new-api-catalog.md, references/api-index-12.0.0-rc1-generated.md로만 다룬다. README에 별도 설치 명령이 없고, Avalonia 외 스택의 구현 지침은 제공하지 않는다.