MAF Migration Agent

MAF Migration Agent is an agent for Claude Code from joslat/maf-doctor. It costs 78 tokens per session (3,449 once invoked), scanned A, original, MIT.

A guided tool for moving a .NET codebase to Microsoft Agent Framework (MAF) version 1.3.0, a framework for building AI agents and workflows.

In plain words
What is it for?
Use it to update a .NET project’s packages, namespaces, executors, sessions, workflows, streaming, events, and DevUI safeguards, then validate the changes.
Why use it?
It helps prevent missed breaking changes, obsolete APIs, package updates, and other migration errors that may not be obvious from the compiler alone.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: Copilot chat-mode frontmatter (tools: vscode/*).

Good fit Use it to update a .NET project’s packages, namespaces, executors, sessions, workflows, streaming, events, and DevUI safeguards, then validate the changes.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/joslat/maf-doctor/maf-migration
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/joslat/maf-doctor

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for MAF Migration Agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/joslat/maf-doctor/maf-migration.svg)](https://agentmods.dev/agents/joslat/maf-doctor/maf-migration)
Your own site
<a href="https://agentmods.dev/agents/joslat/maf-doctor/maf-migration"><img src="https://agentmods.dev/badge/agents/joslat/maf-doctor/maf-migration.svg" alt="Measured on agentmods" height="20"></a>
Per session 78 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,449 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00078 $0.03449
Opus 5 $0.00039 $0.01724
Sonnet 5 $0.00016 $0.00690
Haiku 4.5 $0.00008 $0.00345

Measured 8d ago against content hash 0e4b3eddda5c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

MAF Migration Agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/agents/maf-migration.agent.md · 189 lines

How it starts

The opening of the file, as written. The whole thing — 189 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a specialist migration agent for Microsoft Agent Framework (MAF) 1.3.0. Your only job is to migrate .NET codebases to MAF 1.3.0 correctly, build-verified, and with zero silent failures.

Authoritative References (READ FIRST)

Before starting any work, read both documents:

  1. src/docs/migration-plan.md — Project-specific tracking table, before/after patterns, file-by-file breakdown. This is your work order.
  2. Load the maf-migration-guide skill — full API patterns, breaking changes, and Known Misalignments.

Constraints and breaking changes are in maf-constraints.instructions.md (auto-loaded). Do not repeat them here — they are always in context.


MCP Tool Shortcuts (prefer these — they replace manual procedures)

The maf-autopilot MCP server is running in this workspace. Use its executable tools for the heavy lifting instead of "load skill and run by hand". Tool names are PascalCase:

When you need to… Call MCP tool Replaces
Check if a MAF API name is safe in 1.3.0 MafApiSafety(apiName) (new capability)
Look up full fix for a known CS0618 entry MafRegistryLookup(entryId) maf-obsolete-api-registry skill
List all registry entries MafRegistryList() (new capability)
Run CS0618 / CS0246 hunt across a project MafRunCs0618Hunt(projectPath) cs0618-hunter skill manual loop
Validate fan-out / fan-in executor topology (Roslyn) MafValidateFanOut(repoPath) maf-fan-out-validator skill manual walk
Diff two NuGet versions of a package MafDiffPackage(packageId, oldVersion, newVersion) nuget-diff-analyzer skill manual dnx call
Scan repo for security/concurrency/observability bad code MafScanAntiPatterns(repoPath) (new capability)
Simulate workflow topology (Mermaid + completion forecast) MafSimulateWorkflow(repoPath) (new capability)
Explain a MAF code snippet inline MafExplain(snippet) (new capability)
Scaffold a new MAF agent class + smoke test MafNewAgent(projectPath, agentName, instructions?) (new capability)
Scaffold a new workflow executor (fan-out-safe) MafNewExecutor(projectPath, name, inputType, outputType) (new capability)

Read the full file on GitHub · 189 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 189 lines · 78 tokens per session scan A 0e4b3eddda5c

Subscribe to this mod's changes

MAF Migration Agent is an agent published in the GitHub repository joslat/maf-doctor (14 stars, last pushed 21d ago), licensed MIT. It adds 78 tokens to every session and 3,449 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

winui-dev

Builds WinUI 3 desktop applications using Windows App SDK, XAML, and C#. Use for creating new apps, adding features, converting from WPF/Electron/web, fixing bugs, or any WinUI 3 / WinAppSDK / XAML task.

microsoft/win-dev-skills · 58 tokens

cli

Use as the primary implementation agent for this .NET repository. It defines project structure, engineering conventions, ownership boundaries, localization, testing policy, and when to use the cli, blazor, dotnet, codegen, docs, and test skills.

AterDev/Perigon.CLI · 52 tokens

dotnet-explore

Locates the C# symbols, references, and files a task touches, and reports the blast radius — before any code is written. Use when about to modify code, when assessing how a new feature lands in the existing codebase, or when navigating dependencies to find what a change would break. Returns symbolIds and file:line…

Attemainio/dotnet-toolkit · 105 tokens

dotnet-perf-full-probe

Benchmark-only instrument for dotnet-performance. Answers a stated C#-navigation question with BOTH tool families available at once — this repo's dotnet-toolkit MCP tools AND Read/Grep/Glob/Bash — under the plugin's shipped default guard state (advisory, not suspended, not forced-block). Plays a real, unrestricted…

Attemainio/dotnet-toolkit · 232 tokens

fluent-validation

Cria validators FluentValidation consistentes para DTOs do — regras, mensagens em português e integração com ASP.NET Core.

JAXTech-Labs/claude-code-template · 33 tokens

razor-frontend

Constrói Views Razor, ViewModels, layouts e partial views para o .Web — consumindo a API REST sem lógica de negócio.

JAXTech-Labs/claude-code-template · 37 tokens