Modernize repository configuration following template consistency review

.cspell.json

@@ -4,6 +4,7 @@
   "words": [
     "Anson",
     "Blockquotes",
+    "buildnotes",
     "camelcase",
     "CodeQL",
     "copilot",

.gitignore

@@ -1,7 +1,23 @@
-.vs
-*.bak
+# Visual Studio
+.vs/
+*.suo
 *.user
+*.userosscache
+*.sln.docstates
+*.userprefs
+
+# Visual Studio Code
+.vscode/*
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/settings.json
+
+# JetBrains Rider
+.idea/
+*.sln.iml
 
+# Build results
 bin/
 obj/
 TestResults/
@@ -17,12 +33,17 @@ coverage/
 
 # Temporary files
 *.tmp
+*.bak
 .DS_Store
+*~
 
 # Node.js dependencies
 node_modules/
 package-lock.json
 
+# Agent communication files
+AGENT_REPORT_*.md
+
 # Generated documentation
 docs/*.pdf
 docs/guide/*.html

.markdownlint-cli2.jsonc

@@ -0,0 +1,16 @@
+{
+  // Markdown linting configuration for markdownlint-cli2
+  "config": {
+    "default": true,
+    "MD003": { "style": "atx" },
+    "MD007": { "indent": 2 },
+    "MD013": { "line_length": 120 },
+    "MD033": false,
+    "MD041": false
+  },
+  // Ignore patterns
+  "ignores": [
+    "node_modules",
+    "AGENT_REPORT_*.md"
+  ]
+}

.vscode/tasks.json

@@ -9,7 +9,7 @@
         "build",
         "--configuration",
         "Release",
-        "${workspaceFolder}/DemaConsulting.SonarMark.sln"
+        "${workspaceFolder}/DemaConsulting.SonarMark.slnx"
       ],
       "problemMatcher": "$msCompile",
       "group": {
@@ -29,7 +29,7 @@
         "test",
         "--configuration",
         "Release",
-        "${workspaceFolder}/DemaConsulting.SonarMark.sln"
+        "${workspaceFolder}/DemaConsulting.SonarMark.slnx"
       ],
       "problemMatcher": "$msCompile",
       "group": {
@@ -136,7 +136,7 @@
         "Release",
         "--collect",
         "XPlat Code Coverage",
-        "${workspaceFolder}/DemaConsulting.SonarMark.sln"
+        "${workspaceFolder}/DemaConsulting.SonarMark.slnx"
       ],
       "problemMatcher": "$msCompile",
       "presentation": {

CONTRIBUTING.md

@@ -172,6 +172,8 @@ All markdown files must follow these rules (enforced by markdownlint):
 - Lists must be surrounded by blank lines
 - Use reference-style links: `[text][ref]` with `[ref]: url` at document end
 - **Exception**: `README.md` uses absolute URLs (it's included in the NuGet package)
+- **Exception**: Agent markdown files in `.github/agents/*.md` use inline links `[text](url)` for visibility in agent
+  context
 
 ### Spell Checking
 
@@ -204,7 +206,7 @@ Run all linters to ensure code quality and consistency:
 
 ```bash
 # Markdown linting
-npx markdownlint-cli2 "**/*.md" "#node_modules"
+npx markdownlint-cli2
 
 # Spell checking
 npx cspell "**/*.{md,cs}" --no-progress

DemaConsulting.SonarMark.slnx

@@ -0,0 +1,4 @@
+<Solution>
+  <Project Path="src/DemaConsulting.SonarMark/DemaConsulting.SonarMark.csproj" />
+  <Project Path="test/DemaConsulting.SonarMark.Tests/DemaConsulting.SonarMark.Tests.csproj" />
+</Solution>

lint.bat

@@ -2,7 +2,7 @@
 REM Run all linters for SonarMark (Windows)
 
 echo Checking markdown...
-call npx markdownlint-cli2 "**/*.md" "#node_modules"
+call npx markdownlint-cli2
 if %errorlevel% neq 0 exit /b %errorlevel%
 
 echo Checking spelling...

lint.sh

@@ -4,7 +4,7 @@
 set -e  # Exit on error
 
 echo "📝 Checking markdown..."
-npx markdownlint-cli2 "**/*.md" "#node_modules"
+npx markdownlint-cli2
 
 echo "🔤 Checking spelling..."
 npx cspell "**/*.{cs,md,json,yaml,yml}" --no-progress