🇰🇷 한국어

✨ Highlights

MVVM Composition Style: wpf-dev-pack enforces a single matching path per MVVM framework, both with Stateful ViewModel:

• CommunityToolkit.Mvvm (default) → ViewModel First Composition via Mappings.xaml + implicit DataTemplate.
• Prism 9 (alternative) → View First Composition via RegisterForNavigation + IRegionManager.RequestNavigate.

Prism ViewModelLocator.AutoWireViewModel, code-behind DataContext = new VM(), inline XAML DataContext, and Stateless-VM patterns are prohibited (see wpf-rule-prohibitions and docs/TERMINOLOGY.md).

Pre-v1.6.4 docs labeled this uniformly as "View First MVVM" — that label conflicted with Microsoft's official definition (lookup key for Mappings.xaml is the ViewModel type → ViewModel First). v1.6.4 corrects the labels per path; the enforced code rules are unchanged.

🤖 AI-Powered Development 10 Specialized Agents for different WPF tasks Session-model agnostic — agents inherit your current model MCP-served knowledge — search-before-answer via WpfDevPackMcp Prism 9 companion files for dual-framework support	🛠️ Complete Toolkit 19 command Skills (+ 9 internal rule-skills preloaded into agents) + on-demand WPF knowledge via MCP Best practices built-in
📚 Smart Documentation Microsoft Learn plugin (install from marketplace) Context7 for up-to-date docs (external) Semantic code analysis with Serena (external)	⚡ High Performance DrawingContext rendering patterns Virtualization strategies Memory optimization techniques

---

📦 Installation

From Marketplace (Recommended)

# Step 1: Add the marketplace (one-time)
/plugin marketplace add christian289/dotnet-with-claudecode

# Step 2: Install the plugin
/plugin install wpf-dev-pack@dotnet-claude-plugins

Local Installation

claude --plugin-dir ./wpf-dev-pack

Updating

# Manual update
claude plugin update wpf-dev-pack@dotnet-claude-plugins

# Or enable auto-updates for this marketplace
/plugin → Marketplaces → dotnet-claude-plugins → Enable auto-update

Note: Third-party marketplaces have auto-update disabled by default.

Requirements

Requirement	Version	Notes
.NET SDK	10.0.300+	Required for file-based app hooks
Claude Code	Latest	-
uv	Latest	For Serena MCP

Target Framework vs SDK: .NET SDK 10.0.300+ is required to run wpf-dev-pack (hooks use file-based apps). Generated WPF projects can target .NET 8+ — install the corresponding SDK alongside .NET 10 if needed.

Required Plugin Dependencies

wpf-dev-pack agents require the following Claude Code plugins to be installed separately:

Plugin	MCP Server	Purpose
context7	context7	Up-to-date library/framework documentation
microsoft-docs	microsoft-learn	Official Microsoft documentation and code samples
csharp-lsp	csharp	C# Language Server Protocol (definition, references, diagnostics)

Required MCPs

The following MCP server is required by wpf-dev-pack agents but must NOT be installed as a Claude Code plugin — install it directly as an MCP server via uv instead.

MCP Server	Purpose	Installation
serena	Semantic code analysis, symbol navigation	Install directly via uv per the Quick Start. Do not use a Claude Code plugin path — see the Attention note in the Serena Claude Code docs for the rationale (Claude Code's built-in tool descriptions strongly bias the model away from invoking Serena's tools when registered through the plugin path).

Note: wpf-dev-pack checks Claude Code plugin availability at runtime and warns if missing. The Serena MCP must be set up separately as described above.

Install via Claude Code marketplace or /install-plugin command.

---

🚀 Quick Start

Create a New WPF Project

# With CommunityToolkit.Mvvm (Recommended)
/wpf-dev-pack:make-wpf-project MyApp

# With Prism Framework
/wpf-dev-pack:make-wpf-project MyApp --prism

Generate Components

# CustomControl
/wpf-dev-pack:make-wpf-custom-control MyButton Button

# UserControl
/wpf-dev-pack:make-wpf-usercontrol SearchBox

# Converter
/wpf-dev-pack:make-wpf-converter BoolToVisibility

# Behavior
/wpf-dev-pack:make-wpf-behavior SelectAllOnFocus TextBox

Ask for Help

"How do I create a high-performance chart control?"
"Review this ViewModel from MVVM perspective"
"Optimize this rendering code for large datasets"

---

🎯 Requirements Interview System

When you invoke wpf-architect, an adaptive path-based interview identifies your exact needs:

How It Works

Step 1: Task Type Selection
   ├─→ Path A: Create new project (7 steps)
   ├─→ Path B: Analyze/improve existing (5 steps)
   ├─→ Path C: Implement feature (5 steps)
   └─→ Path D: Debug/fix (4 steps)

Each path asks targeted questions with keyword analysis on free-input steps to auto-configure subsequent defaults.

Interview Paths

Path	Task Type	Steps	Focus
A	Create new project	7	Concept → Architecture → Scale → Complexity → Libraries → Feature areas
B	Analyze/improve	5	Goal → Analysis mode → Scope → Output format
C	Implement feature	5	Description → Approach → Libraries → Feature areas
D	Debug/fix	4	Symptoms → Problem type → Problem area

Example Flow (Path A)

User: "I want to build a chart app with WPF"

wpf-architect: [A-1] What kind of app? Describe the concept.
   → User: "Real-time stock chart dashboard"
   (Keywords detected: "chart", "real-time" → LiveCharts2, performance defaults)

wpf-architect: [A-2] Architecture pattern?
   → User selects: "MVVM + CommunityToolkit"

wpf-architect: [A-3] Project scale?
   → User selects: "Medium (5-15 Views)"

wpf-architect: [A-5] 3rd-party libraries?
   → Auto-suggested: LiveCharts2 ✓, WPF-UI (optional)

Result: Activates LiveCharts2 + DrawingContext skills + wpf-performance-optimizer

---

🧠 How Knowledge Is Served

wpf-dev-pack does not use a keyword-detection hook. WPF knowledge is served on demand by the WpfDevPackMcp MCP server — its own server instructions tell the agent to search the topic catalog before answering WPF/C#/.NET questions.

How It Works

1. You ask a WPF/C#/.NET question (or invoke a command skill / agent).
2. The agent searches the catalog with WpfDevPackMcp search_wpf_topics, then loads the best matches with get_wpf_topic.
3. Specialized agents handle complex, multi-step tasks.

The ~50 knowledge topics live as plain Markdown at knowledge/<id>/TOPIC.md in the repo and are fetched live — editing them needs no plugin rebuild or version bump. Run /wpf-dev-pack:set-repo-path once to point the server at your local clone.

Example Topics (served via MCP)

You ask about	Topic
Authoring a CustomControl	authoring-wpf-controls
MVVM with CommunityToolkit	implementing-communitytoolkit-mvvm
Rendering with DrawingContext	rendering-with-drawingcontext
High-performance rendering	rendering-wpf-high-performance

For complex tasks, a specialized agent is recommended (e.g. wpf-performance-optimizer for rendering, wpf-architect for architecture reviews).

Command Skills vs Knowledge

• Command skills (/wpf-dev-pack:<name>) — slash-invocable generators and plugin operations (19 bundled; see Skills & Knowledge below).
• Knowledge topics — reference content served by WpfDevPackMcp; kept out of the session skill listing (no per-session context cost).

---

🎯 Features

🤖 Specialized Agents

All agents inherit the current session model. Run /model to switch (e.g. Opus 1M ↔ Sonnet ↔ Haiku).

Agent	Specialty
🏗️ wpf-architect	Strategic architecture & design decisions
🎨 wpf-control-designer	CustomControl implementation
📐 wpf-xaml-designer	XAML styles & templates
🔄 wpf-mvvm-expert	MVVM pattern & CommunityToolkit
🔗 wpf-data-binding-expert	Complex bindings & validation
⚡ wpf-performance-optimizer	Rendering & performance
🔍 wpf-code-reviewer	Code quality analysis
🔎 wpf-code-auditor	Full-codebase pattern & consistency audit
📝 code-formatter	C# formatting & style
🔧 serena-initializer	Project setup

🔌 MCP Servers

Plugin	MCP Server	Purpose
HandMirrorMcp	HandMirrorMcp	.NET assembly/NuGet inspection (bundled)
WpfDevPackMcp	WpfDevPackMcp	WPF knowledge topics, served on demand from a local repo clone (bundled)
context7	context7	Library/framework documentation
(direct MCP via uv)	serena	Semantic code analysis
microsoft-docs	microsoft-learn	Official Microsoft documentation
csharp-lsp	csharp	C# LSP code intelligence

See Required Plugin Dependencies and Required MCPs for installation. Serena is not a Claude Code plugin — install it directly as an MCP server via uv.

📚 Skills & Knowledge

As of v1.7.0, the ~50 WPF knowledge topics (MVVM, rendering, threading, styling, 3rd-party libraries, .NET common, Prism 9 companions, testing, …) are no longer bundled as plugin skills. They are served on demand by the WpfDevPackMcp MCP server via get_wpf_topic / search_wpf_topics; the server's own instructions tell the agent to search before answering. This keeps them out of the session's skill listing (no per-session context cost) while remaining editable as plain Markdown. See mcp/README.md and /wpf-dev-pack:set-repo-path.

The plugin bundles 19 command skills (slash-invocable), plus 9 internal wpf-rule-* skills (user-invocable: false) that are preloaded into the specialized agents — 28 skill folders in total:

🏗️ Scaffolding (7 skills)

Skill	Description
make-wpf-project	WPF project scaffolding with MVVM/DI
make-wpf-custom-control	CustomControl generation
make-wpf-usercontrol	UserControl generation
make-wpf-converter	IValueConverter generation
make-wpf-behavior	Behavior generation
make-wpf-viewmodel	ViewModel + View + DI + DataTemplate mapping generation
make-wpf-service	Service interface + implementation + DI registration

💬 LLM Chat (5 skills)

Skill	Description
make-wpf-chatclient	One-button streaming LLM chat client (full surface)
make-wpf-chatclient-factory	Provider-agnostic IChatClient factory (shared SocketsHttpHandler) + MockChatClient
make-wpf-chat-orchestrator	Streaming chat orchestrator (UI-agnostic events) + MCP tool acquisition
make-wpf-chat-bubble-template	Role-differentiated chat bubble templates
make-wpf-markdown-presenter	Markdig → selectable FlowDocument markdown presenter

🎨 Code Quality (1 skill)

Skill	Description
formatting-wpf-csharp-code	C# / XAML formatting & style (auto-applied on edits by the CodeFormatter hook)

🔧 Plugin Operations (6 skills)

Skill	Description
collecting-wpf-dev-pack-feedback	Capture anonymized feedback docs for later application
configuring-wpf-dev-pack-language	Set the per-project response language (.claude/wpf-dev-pack.local.md)
set-repo-path	Configure the local repo-clone path WpfDevPackMcp reads knowledge from
set-repo-branch	Set the git branch WpfDevPackMcp tracks (config.json)
set-repo-managed	Set the server-managed flag (state.json) — destructive vs non-destructive refresh
show-wpf-dev-pack-config	Show the WpfDevPackMcp config.json / state.json paths and values

---

📁 Plugin Structure

wpf-dev-pack/
├── 📁 .claude-plugin/
│   └── plugin.json           # Plugin manifest
├── 📁 agents/                 # 10 Specialized agents
│   ├── wpf-architect.md
│   ├── wpf-code-auditor.md
│   ├── wpf-code-reviewer.md
│   ├── wpf-control-designer.md
│   ├── wpf-xaml-designer.md
│   ├── wpf-mvvm-expert.md
│   ├── wpf-data-binding-expert.md
│   ├── wpf-performance-optimizer.md
│   ├── code-formatter.md
│   └── serena-initializer.md
├── 📁 skills/                 # 19 command skills + 9 wpf-rule-* preload skills
├── 📁 hooks/                  # Event hooks
├── 📁 themes/                 # Color themes (experimental) — .NET Purple (dark)
├── 📁 monitors/               # Background monitors (experimental) — build watch
├── 📄 .mcp.json               # MCP config (HandMirrorMcp + WpfDevPackMcp)
├── 📄 README.md
└── 📄 LICENSE

---

🔧 Configuration

Serena MCP Setup

⚠️ Required: Install uv to use Serena.

# Test Serena locally
uvx --from git+https://github.com/oraios/serena serena start-mcp-server

C# LSP (Required for IntelliSense)

claude /install-plugin csharp-lsp

---

📖 Documentation

Official References

• 📘 WPF Samples (Microsoft)
• 📗 WPF Graphics & Multimedia
• 📙 Claude Code Plugin Spec

Architecture Reference

• oh-my-claudecode - Agent-based orchestration pattern

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📄 License

MIT License - see LICENSE for details.

---