joshsmithxrm · joshsmithxrm · Feb 9, 2026 · Feb 8, 2026 · Feb 8, 2026 · Feb 8, 2026
diff --git a/.github/CODE_SCANNING.md b/.github/CODE_SCANNING.md
@@ -59,12 +59,12 @@ Compile-time enforcement of architectural patterns. Analyzers run during build a
 
 | ID | Name | Description | Source |
 |----|------|-------------|--------|
-| PPDS001 | NoDirectFileIoInUi | UI layer using File.Read/Write directly | ADR-0024 |
-| PPDS002 | NoConsoleInServices | Service using Console.WriteLine | ADR-0015 |
-| PPDS003 | NoUiFrameworkInServices | Service referencing Spectre/Terminal.Gui | ADR-0025 |
-| PPDS004 | UseStructuredExceptions | Service throwing raw Exception | ADR-0026 |
-| PPDS005 | NoSdkInPresentation | CLI command calling ServiceClient directly | ADR-0015 |
-| PPDS007 | PoolClientInParallel | Pool client acquired outside parallel loop | ADR-0002/0005 |
+| PPDS001 | NoDirectFileIoInUi | UI layer using File.Read/Write directly | Architecture |
+| PPDS002 | NoConsoleInServices | Service using Console.WriteLine | Architecture |
+| PPDS003 | NoUiFrameworkInServices | Service referencing Spectre/Terminal.Gui | Architecture |
+| PPDS004 | UseStructuredExceptions | Service throwing raw Exception | Architecture |
+| PPDS005 | NoSdkInPresentation | CLI command calling ServiceClient directly | Architecture |
+| PPDS007 | PoolClientInParallel | Pool client acquired outside parallel loop | Architecture |
 | PPDS008 | UseBulkOperations | Loop with single Delete/Update calls | Gemini PR#243 |
 | PPDS011 | PropagateCancellation | Async method not passing CancellationToken | Gemini PR#242 |
 
@@ -116,19 +116,8 @@ If a finding reveals a real bug:
 2. Reference the analyzer rule (e.g., "Found by PPDS012")
 3. Include the file and line number
 
-## Architecture (ADRs)
-
-Bot instructions reference these Architecture Decision Records:
-
-| ADR | Summary |
-|-----|---------|
-| [0015](../docs/adr/0015_APPLICATION_SERVICE_LAYER.md) | Application Services for CLI/TUI/Daemon |
-| [0024](../docs/adr/0024_SHARED_LOCAL_STATE.md) | Shared local state architecture |
-| [0025](../docs/adr/0025_UI_AGNOSTIC_PROGRESS.md) | UI-agnostic progress reporting |
-| [0026](../docs/adr/0026_STRUCTURED_ERROR_MODEL.md) | Structured error model |
-
 ## Related Issues
 
 - [#231](https://github.com/joshsmithxrm/power-platform-developer-suite/issues/231) - Tune code scanning tools to reduce noise
-- [#232](https://github.com/joshsmithxrm/power-platform-developer-suite/issues/232) - ADR-0024 (style) - Prefer foreach over LINQ
+- [#232](https://github.com/joshsmithxrm/power-platform-developer-suite/issues/232) - Prefer foreach over LINQ
 - [#246](https://github.com/joshsmithxrm/power-platform-developer-suite/issues/246) - Analyzer triage process and PPDS013 refinement
diff --git a/.github/codeql/codeql-config.yml b/.github/codeql/codeql-config.yml
@@ -18,7 +18,7 @@ queries:
 query-filters:
   - exclude:
       id:
-        # LINQ style suggestions - conflicts with ADR-0024 (prefer explicit foreach)
+        # LINQ style suggestions - prefer explicit foreach
         - cs/linq/missed-where
         - cs/linq/missed-select
         # Style preferences - not quality issues

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -10,20 +10,20 @@ This file guides GitHub Copilot's code review behavior for the PPDS repository.
 - Application Services own all business logic
 - Services are UI-agnostic - no `Console.WriteLine`, no Spectre/Terminal.Gui references
 
-### File I/O (ADR-0024: Shared Local State)
+### File I/O
 
 - UIs never read/write files directly
 - All file access through Application Services
 - WRONG: `File.ReadAllText` in command handler
 - CORRECT: `await _profileService.GetProfilesAsync()`
 
-### Progress Reporting (ADR-0025: UI-Agnostic Progress)
+### Progress Reporting
 
 - Services accept `IProgressReporter`, not write to console
 - UIs implement adapters for their display medium
 - Services return data, presentation layers format it
 
-### Error Handling (ADR-0026: Structured Error Model)
+### Error Handling
 
 - Services throw `PpdsException` with `ErrorCode` and `UserMessage`
 - Never expose technical details (GUIDs, stack traces) in `UserMessage`

diff --git a/.gitignore b/.gitignore
@@ -81,3 +81,4 @@ states.json
 
 # Git worktrees
 .worktrees/
+.muse/
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -6,17 +6,17 @@ SDK, CLI, TUI, VS Code Extension, and MCP server for Power Platform development.
 
 - Regenerate `PPDS.Plugins.snk` - breaks strong naming for all assemblies
 - Create new `ServiceClient` per request - 42,000x slower than pool; use `IDataverseConnectionPool`
-- Hold single pooled client for multiple queries - defeats pool parallelism; see ADR-0002
+- Hold single pooled client for multiple queries - defeats pool parallelism
 - Write CLI status messages to stdout - use `Console.Error.WriteLine`; stdout is for data
 - Throw raw exceptions from Application Services - wrap in `PpdsException` with ErrorCode
 
 ## ALWAYS
 
-- Use connection pool for multi-request scenarios - see ADR-0002, ADR-0005
+- Use connection pool for multi-request scenarios
 - Use bulk APIs (`CreateMultiple`, `UpdateMultiple`) - 5x faster than `ExecuteMultiple`
-- Use Application Services for all persistent state - single code path for CLI/TUI/RPC (ADR-0024)
-- Accept `IProgressReporter` for operations >1 second - all UIs need feedback (ADR-0025)
-- Include ErrorCode in `PpdsException` - enables programmatic handling (ADR-0026)
+- Use Application Services for all persistent state - single code path for CLI/TUI/RPC
+- Accept `IProgressReporter` for operations >1 second - all UIs need feedback
+- Include ErrorCode in `PpdsException` - enables programmatic handling
 
 ## Tech Stack
 
@@ -27,10 +27,9 @@ SDK, CLI, TUI, VS Code Extension, and MCP server for Power Platform development.
 
 ## Key Files
 
-- `src/PPDS.Cli/Services/` - Application Services (ADR-0015)
+- `src/PPDS.Cli/Services/` - Application Services
 - `src/PPDS.Dataverse/Generated/` - Early-bound entities (DO NOT edit)
-- `docs/adr/` - Architecture Decision Records
-- `docs/patterns/` - Canonical code patterns
+- `docs/specs/` - Feature specifications
 
 ## Commands
 
@@ -47,9 +46,6 @@ SDK, CLI, TUI, VS Code Extension, and MCP server for Power Platform development.
 - Integration (live): `--filter Category=Integration`
 - TUI: `--filter Category=TuiUnit`
 
-See ADR-0028 (TUI testing), ADR-0029 (full strategy).
-
 ## Architecture
 
 TUI-first multi-interface platform. All business logic in Application Services, never in UI code.
-See `docs/patterns/architecture.md` for diagrams.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -97,10 +97,10 @@ The pre-commit hook automatically runs unit tests (~10s).
 
 | Pattern | Reference |
 |---------|-----------|
-| Connection pooling | ADR-0002, `ServiceClientPool.cs` |
-| Bulk operations | ADR-0005, `BulkOperationExecutor.cs` |
-| CLI output | ADR-0008 |
-| Application services | ADR-0015 |
+| Connection pooling | `ServiceClientPool.cs` |
+| Bulk operations | `BulkOperationExecutor.cs` |
+| CLI output | `src/PPDS.Cli/Services/` |
+| Application services | `src/PPDS.Cli/Services/` |
 
 ### What to Avoid
 
@@ -122,15 +122,15 @@ power-platform-developer-suite/
 │   └── PPDS.Mcp/            # MCP server
 ├── extension/               # VS Code extension
 ├── tests/                   # Test projects
-├── docs/adr/               # Architecture Decision Records
+├── docs/specs/             # Feature specifications
 └── templates/claude/       # Claude Code integration
 ```
 
 ## Getting Help
 
 - **Questions**: Open a [Discussion](https://github.com/joshsmithxrm/power-platform-developer-suite/discussions)
 - **Bugs**: Open an [Issue](https://github.com/joshsmithxrm/power-platform-developer-suite/issues)
-- **Architecture**: Check [ADRs](docs/adr/README.md) for design decisions
+- **Architecture**: Check `docs/specs/` for design decisions
 
 ## License
 

diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -6,6 +6,7 @@
   <ItemGroup Label="Azure and Identity">
     <PackageVersion Include="Azure.Identity" Version="1.17.1" />
     <PackageVersion Include="Devlooped.CredentialManager" Version="2.6.1.1" />
+    <PackageVersion Include="Microsoft.Data.SqlClient" Version="5.2.2" />
     <PackageVersion Include="Microsoft.Identity.Client" Version="4.81.0" />
     <PackageVersion Include="Microsoft.Identity.Client.Extensions.Msal" Version="4.81.0" />
     <PackageVersion Include="Microsoft.PowerPlatform.Dataverse.Client" Version="1.2.10" />

diff --git a/README.md b/README.md
@@ -271,16 +271,6 @@ dotnet test --filter Category=TuiUnit
 
 ---
 
-## Architecture Decisions
-
-Key design decisions are documented as ADRs in [docs/adr/](docs/adr/README.md):
-
-- [ADR-0002: Multi-Connection Pooling](docs/adr/0002_MULTI_CONNECTION_POOLING.md)
-- [ADR-0005: DOP-Based Parallelism](docs/adr/0005_DOP_BASED_PARALLELISM.md)
-- [ADR-0007: Unified CLI and Shared Authentication](docs/adr/0007_UNIFIED_CLI_AND_AUTH.md)
-- [ADR-0008: CLI Output Architecture](docs/adr/0008_CLI_OUTPUT_ARCHITECTURE.md)
-- [ADR-0015: Application Service Layer](docs/adr/0015_APPLICATION_SERVICE_LAYER.md)
-
 ## Patterns
 
 - [Connection Pooling](docs/architecture/CONNECTION_POOLING_PATTERNS.md) - When and how to use connection pooling

diff --git a/docs/FEATURE_ROADMAP.md b/docs/FEATURE_ROADMAP.md
@@ -45,7 +45,7 @@
 - Power Apps Admin API for connections (different from Dataverse)
 - Orphaned connection reference detection (port from extension)
 - Deployment settings sync with value preservation and deterministic sorting
-- PAC-compatible format (see [ADR-0011](adr/0011_DEPLOYMENT_SETTINGS_FORMAT.md))
+- PAC-compatible format
 
 ---
 
@@ -55,7 +55,7 @@
 
 **Scope:**
 - Full filtering (25 fields, 11 operators, 8 quick filters)
-- Hybrid filter approach: inline flags + filter file (see [ADR-0012](adr/0012_HYBRID_FILTER_DESIGN.md))
+- Hybrid filter approach: inline flags + filter file
 - Timeline correlation view
 - Trace level management (off/exception/all)
 - Export/delete operations
@@ -67,7 +67,7 @@
 **Design Session:** 2026-01-04 - Completed
 
 **Scope:**
-- Published vs unpublished content (default: published per [ADR-0010](adr/0010_PUBLISHED_UNPUBLISHED_DEFAULT.md))
+- Published vs unpublished content (default: published, `--unpublished` flag)
 - Conflict detection on push (timestamp-based with hash tracking)
 - Efficient filtering for 60K+ resources
 - Hierarchical pull with `--strip-prefix` option
@@ -90,17 +90,6 @@ Full plugin lifecycle: assemblies, packages, steps, images, service endpoints, w
 
 ---
 
-## Architecture Decision Records
-
-| ADR | Decision |
-|-----|----------|
-| [ADR-0009](adr/0009_CLI_COMMAND_TAXONOMY.md) | Use `ppds plugintraces` (not `traces` or `plugins traces`) |
-| [ADR-0010](adr/0010_PUBLISHED_UNPUBLISHED_DEFAULT.md) | Default to published, `--unpublished` flag |
-| [ADR-0011](adr/0011_DEPLOYMENT_SETTINGS_FORMAT.md) | Use PAC-compatible deployment settings format |
-| [ADR-0012](adr/0012_HYBRID_FILTER_DESIGN.md) | Hybrid filter design: inline flags + filter file |
-
----
-
 ## Key Design Decisions
 
 ### JSON Output Strategy
@@ -120,5 +109,4 @@ Every command serves Extension (JSON-RPC), Humans (tables), AI/Tooling (structur
 
 ## References
 
-- [CLI Output Architecture (ADR-0008)](adr/0008_CLI_OUTPUT_ARCHITECTURE.md)
 - [Extension CLI Migration Issues](https://github.com/joshsmithxrm/power-platform-developer-suite/issues?q=is%3Aissue+label%3Aepic%3Acli-daemon)
diff --git a/docs/adr/0017_GIT_BRANCHING_STRATEGY.md b/docs/adr/0017_GIT_BRANCHING_STRATEGY.md
Original file line number	Diff line number	Diff line change
Expand Up		@@ -81,3 +81,4 @@ states.json

		# Git worktrees
		.worktrees/
		.muse/