Roslyn-Backed-MCP: Skill for Claude Code

Reconcile Remediation Plan

You are a plan-state reconciler. Your job is to walk a remediation plan's state.json and plan.md, query GitHub for every initiative whose PR is already open, apply merged / deferred status transitions to both files, and ship the reconciliation as a PR on a short-lived branch. The installed name /reconcile-backlog-sweep-plan is retained only for compatibility.

This skill does not pick new work and does not execute initiatives. It is a bookkeeping pass that runs between PR waves.

Server discovery

This skill edits repository files and shells out to gh + git. Roslyn MCP server_info / server_catalog are unrelated — no workspace loading, no analyzer calls. If you think you need Roslyn MCP, you are in the wrong skill.

Input

$ARGUMENTS optionally names the plan directory (relative to repo root, e.g. ai_docs/plans/20260417T120000Z_backlog-remediate). The _backlog-sweep directory suffix is a historical compatibility label. If omitted, enumerate the union of ai_docs/plans/*_backlog-remediate/ and legacy ai_docs/plans/*_backlog-sweep/ directories. Classify every candidate under one terminal rule (terminal = completed: true AND every initiative status in {merged, obsolete, deferred} — the canonical terminal set in ~/.claude/prompts/backlog-remediate-rules.md), then select the oldest non-terminal plan across the combined set (FIFO drain). This mirrors /backlog-remediate plan selection — do NOT prefer one suffix or default to newest-by-name, either of which can strand an older non-terminal plan whose in-review PRs never get reconciled.

Preconditions (HARD GATES — refuse if any fail)

1. state.json exists at {plan-dir}/state.json. If missing, refuse: "No state.json at {path}. Is this a remediation plan directory?".
2. plan.md exists at {plan-dir}/plan.md. If missing, refuse.
3. schemaVersion ∈ {2, 3, 4} in state.json (2 and 3 are legacy schemas produced by the retired /backlog-sweep:plan and /backlog-sweep:prepare routes; 4 is the current default — all three remain valid per the canonical field contract). v4 plans are reconciled by delegating to the blessed writer script (the Step 1.2 v4 fast path); 2/3 plans use the manual path below. If the value is outside {2,3,4} (or missing), refuse: "Plan uses schemaVersion {n}; this skill supports 2, 3, and 4. Re-run /backlog-remediate to regenerate.".
4. gh CLI is on PATH (gh --version exits 0). If not, refuse: "gh CLI not available — cannot query PR state. Install gh or run Step 1b manually.".
5. git CLI is on PATH (git --version exits 0). If not, refuse.
6. Working tree is clean (git status --porcelain is empty) OR the only dirty paths are the two files this skill will edit (state.json + plan.md). If dirtier, refuse: "Working tree has unrelated changes — commit or stash before reconciling.".
7. main is the default branch and up to date with origin/main. Run git fetch origin main first; then verify main exists locally (or create it tracking origin/main).