docs(ai-team): Merge Bishop shim-first docs decision, add Coordinator CLI updates

Session: 2026-04-12-migration-toolkit-updates
Orchestration: Bishop (73c8efe) + Coordinator (e504d01)

Changes:
- Orchestration logs: Bishop shim-first update, Coordinator CLI tool references
- Session log: Migration toolkit updates summary
- Decisions merged: Bishop shim-first migration paradigm decision
- Cross-agent update: Coordinator CLI additions logged to Bishop history
- Inbox cleaned: bishop-shim-first-docs.md merged and deleted

Author: csharpfritz

.squad/agents/bishop/history.md

@@ -21,6 +21,8 @@ BlazorWebFormsComponents is a library providing Blazor components that emulate A
 
 📌 Team update (2026-04-12): All migration transforms pipeline infrastructure complete — 17 transforms (added 3: ConfigurationManager, RequestForm, ServerShim), 373/373 tests passing, expected files regenerated. WingtipToys analysis shows WebFormsPageBase enables 31 pages to eliminate manual shim wiring. — decided by Psylocke, Forge, Bishop
 
+📌 Team update (2026-04-12): CLI tool references were added by Coordinator to all 4 migration-toolkit docs missing them (METHODOLOGY.md, CHECKLIST.md, README.md), ensuring consistent tool naming and linking across all migration-toolkit documentation. — decided by Coordinator
+
 ### Shim Inventory & CLI Transform Update (2026-04-12)
 
 **Task**: Build a runtime parser that reads ASP.NET Web Forms .skin files and converts them into ThemeConfiguration objects.

.squad/decisions.md

@@ -4,6 +4,31 @@
 
 <!-- Decisions are appended below by the Scribe after merging from .ai-team/decisions/inbox/ -->
 
+### 2026-04-13: Shim-First Migration Documentation Update
+
+**By:** Bishop (Migration Tooling Dev)
+
+**Status:** Implemented
+
+## Context
+
+The BWFC shim infrastructure (WebFormsPageBase, ResponseShim, SessionShim, RequestShim, CacheShim, ServerShim, ClientScriptShim, ViewStateDictionary, PostBack, FormShim, ConfigurationManager, BundleConfig, RouteConfig) has matured to the point where many Web Forms API calls compile and run AS-IS in Blazor. The migration-toolkit documentation still described a "convert everything manually" approach for these items.
+
+## Decision
+
+Updated all 5 migration-toolkit docs to reflect a "shim-first" migration paradigm:
+
+1. **Pipeline percentages shifted**: L1 ~60% (was ~40%), L2 ~30% (was ~45%), L3 ~10% (was ~15%)
+2. **Session["key"] moved out of Layer 3**: SessionShim handles basic usage; persistent/distributed session remains an architecture decision
+3. **Response.Redirect, IsPostBack, Page.Title, Request.QueryString, Cache removed from Layer 2 manual work**: All handled AS-IS by shims
+4. **New "Optional: Refactor to Native Blazor" section**: Developers can choose to keep shims long-term or refactor incrementally
+
+## Impact
+
+- Psylocke: copilot-instructions-template.md already aligned (updated separately)
+- Cyclops/Rogue: Migration skills should reference shim-first approach when guiding developers
+- All agents: When migrating code-behind, check if the API is shim-handled before writing conversion transforms
+
 ### 2026-07-30: ClientScript Migration Strategy & Roadmap
 
 **By:** Beast (Technical Writer)

.squad/decisions/inbox/bishop-shim-first-docs.md

@@ -0,0 +1,26 @@
+# Orchestration: Bishop
+**Date:** 2026-04-12T23:28:55Z
+
+## Spawn
+- **Agent:** Bishop (general-purpose, background)
+- **Commit:** 73c8efe4
+
+## Work Completed
+Updated all 5 migration-toolkit docs to reflect shim-first migration paradigm:
+- METHODOLOGY.md: Updated L1/L2/L3 pipeline percentages (~60%/~30%/~10%)
+- CHECKLIST.md: Removed manual workarounds for shim-handled APIs
+- QUICKSTART.md: Emphasize shim-first approach for new developers
+- README.md: Re-scoped complexity from shim-based migration
+- CONTROL-COVERAGE.md: Noted shim coverage for core Web Forms APIs
+
+## Decisions Made
+- **Shim-First Migration Paradigm**: SessionShim handles basic usage (persistent/distributed session remains architectural choice); Response.Redirect, IsPostBack, Page.Title, Request.QueryString, Cache all handled AS-IS by shims
+- **Optional Refactor Section**: Developers can keep shims long-term or refactor incrementally to native Blazor
+
+## Impact
+- **Psylocke**: copilot-instructions-template.md already aligned (updated separately)
+- **Cyclops/Rogue**: Migration skills should reference shim-first approach when guiding developers
+- **All agents**: When migrating code-behind, check if the API is shim-handled before writing conversion transforms
+
+## Status
+✅ Complete. Decision merged to .squad/decisions.md by Scribe.

.squad/orchestration-log/2026-04-12T23-28-55Z-bishop.md

@@ -0,0 +1,16 @@
+# Orchestration: Coordinator
+**Date:** 2026-04-12T23:28:55Z
+
+## Spawn
+- **Agent:** Coordinator
+- **Commit:** e504d016
+
+## Work Completed
+Added CLI tool (`webforms-to-blazor`) references to all 4 docs that were missing them:
+- METHODOLOGY.md: Inserted CLI reference in Phase 1 automation section
+- CHECKLIST.md: Added CLI tool link for L1 script execution
+- README.md: Added CLI installation and usage section
+- Ensured consistent tool naming and linking across all migration-toolkit docs
+
+## Status
+✅ Complete. CLI references now consistent across all migration-toolkit documentation.