From c6924fa1e65147d60a1c2a6b7d3de67f7a44efa6 Mon Sep 17 00:00:00 2001
From: "Calvin A. Allen" <calvin@codingwithcalvin.net>
Date: Fri, 2 Jan 2026 22:10:04 -0500
Subject: [PATCH] chore(docs): sync CLAUDE.md with standardized template

- Add Microsoft coding guidelines reference (rule #8)
- Standardize VSIX Development Rules section
- Add perf and ci commit types to Conventional Commit Types table
- Update build commands to use dotnet build (VsixSdk)
- Update CI/CD section to reference correct workflow names
---
 CLAUDE.md | 65 ++++++++++++++++++++++++++++---------------------------
 1 file changed, 33 insertions(+), 32 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index fe9f804..ccc20e8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -13,7 +13,32 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 5. **Branch naming** - Use format: `type/scope/short-description` (e.g., `feat/ui/settings-dialog`)
 6. **Working an issue** - Always create a new branch from an updated main branch
 7. **Check branch status before pushing** - Verify the remote tracking branch still exists. If a PR was merged/deleted, create a new branch from main instead
-8. **WPF for all UI** - All UI must be implemented using WPF (XAML/C#). No web-based technologies (HTML, JavaScript, WebView)
+8. **Microsoft coding guidelines** - Follow [Microsoft C# coding conventions](https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/coding-style/coding-conventions) and [.NET library design guidelines](https://learn.microsoft.com/en-us/dotnet/standard/design-guidelines/)
+9. **WPF for all UI** - All UI must be implemented using WPF (XAML/C#). No web-based technologies (HTML, JavaScript, WebView)
+
+---
+
+### GitHub CLI Commands
+
+```bash
+gh issue list                    # List open issues
+gh issue view <number>           # View details
+gh issue create --title "type(scope): description" --body "..."
+gh issue close <number>
+```
+
+### Conventional Commit Types
+
+| Type | Description |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `docs` | Documentation only |
+| `refactor` | Code change that neither fixes a bug nor adds a feature |
+| `test` | Adding or updating tests |
+| `chore` | Maintenance tasks |
+| `perf` | Performance improvement |
+| `ci` | CI/CD changes |
 
 ### VSIX Development Rules
 
@@ -25,7 +50,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **Build Configuration:**
 - Configurations: Debug and Release
-- Platform: AnyCPU
+- Platform: AnyCPU (or x64 where required)
 - Build Tools: Latest 17.* release
 - VSSDK: Latest 17.* release
 
@@ -45,35 +70,13 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **Development Environment:**
 - Required extension: Extensibility Essentials 2022
-- Helper library: VsixCommunity Toolkit
+- Helper library: Community.VisualStudio.Toolkit (where applicable)
 
 **Documentation:**
 - README should be exciting and use emojis
 
 ---
 
-### GitHub CLI Commands
-
-```bash
-gh issue list                    # List open issues
-gh issue view <number>           # View details
-gh issue create --title "type(scope): description" --body "..."
-gh issue close <number>
-```
-
-### Conventional Commit Types
-
-| Type | Description |
-|------|-------------|
-| `feat` | New feature |
-| `fix` | Bug fix |
-| `docs` | Documentation only |
-| `refactor` | Code change that neither fixes a bug nor adds a feature |
-| `test` | Adding or updating tests |
-| `chore` | Maintenance tasks |
-
----
-
 ## Project Overview
 
 VS-CouchbaseExplorer is a Visual Studio 2022 extension for browsing and querying Couchbase Server and Capella databases. The extension is currently in preview/beta status.
@@ -81,15 +84,13 @@ VS-CouchbaseExplorer is a Visual Studio 2022 extension for browsing and querying
 ## Build Commands
 
 ```bash
-# Restore NuGet packages
-nuget restore src/CodingWithCalvin.CouchbaseExplorer.sln
+# Build the solution
+dotnet build src/CodingWithCalvin.CouchbaseExplorer/CodingWithCalvin.CouchbaseExplorer.csproj
 
-# Build (Release, x64)
-msbuild src/CodingWithCalvin.CouchbaseExplorer/CodingWithCalvin.CouchbaseExplorer.csproj /p:configuration=Release /p:platform=x64 /p:DeployExtension=False
+# Build Release
+dotnet build src/CodingWithCalvin.CouchbaseExplorer/CodingWithCalvin.CouchbaseExplorer.csproj -c Release
 ```
 
-The `/p:DeployExtension=False` flag prevents auto-deployment during CI builds. Remove it for local development to auto-deploy to the VS experimental instance.
-
 ## Architecture
 
 ### VS Extension Pattern
@@ -122,7 +123,7 @@ Uses **CouchbaseNetClient 3.5.2** for cluster connections, authentication, and N
 ## CI/CD
 
 GitHub Actions workflows in `.github/workflows/`:
-- `release_build_and_deploy.yml` - Builds on PR and main branch push, creates VSIX artifact
+- `build.yml` - Builds on PR and main branch push, creates VSIX artifact
 - `publish.yml` - Manual trigger to publish to VS Marketplace
 
 ## Development Prerequisites