Improve coding agents instructions (#13110)

.devcontainer/devcontainer.json

@@ -25,8 +25,6 @@
     },
     "vscode": {
       "extensions": [
-        "GitHub.copilot",
-        "GitHub.copilot-chat",
         "ms-dotnettools.csharp",
         "ms-dotnettools.csdevkit",
         "ms-azuretools.vscode-docker",

.github/copilot-instructions.md

@@ -46,13 +46,13 @@
 ## Rules
 
 **RULE 1:** If a task (question, code modification or review) involves the use of bit BlazorUI components (e.g., `BitButton`, `BitTooltip`, `BitTextField`),
-or refers to `bitplatform`, `bit Bswup`, `bit Butil`, `bit Besql`, or `bit Boilerplate`, or involves UI components without explicitly specifying their UI toolkit,
-you **MUST** use the deepwiki's `ask_question` mcp tool to find the correct implementation and usage patterns of `bitfoundation/bitplatform` deep wiki before writing or changing any code.
+or refers to `bitplatform`, `bit Bswup`, `bit Butil`, `bit Bmotion`, `bit Brouter`, or `bit Boilerplate`, or involves UI components without explicitly specifying their UI toolkit,
+you **MUST** use the `bitplatform` MCP server's tools - start with the matching `Search<Library>` tool (e.g. `SearchBitBlazorUI`, `SearchBswup`, `SearchButil`, `SearchBmotion`, `SearchBrouter`) and follow the calls it names - to find the correct implementation and usage patterns before writing or changing any code.
 
 **End of RULE 1**
 
 **RULE 2:** If a task (question, code modification, or review) involves Microsoft technologies such as C#, F#, ASP.NET Core, Microsoft.Extensions, NuGet, Entity Framework, Blazor or the `dotnet` runtime,
-you **MUST** use the `microsoft.docs.mcp` server to search Microsoft's latest official documentation for detailed and up-to-date information before responding to specific or narrowly defined questions.
+you **MUST** use the `microsoft_docs_search`, `microsoft_docs_fetch` and `microsoft_code_sample_search` tools of the `bitplatform` MCP server to search Microsoft's latest official documentation for detailed and up-to-date information before responding to specific or narrowly defined questions.
 
 **End of RULE 2**
 

.vscode/mcp.json

@@ -1,12 +1,8 @@
 {
     "servers": {
-        "DeepWiki": {
-            "type": "sse",
-            "url": "https://mcp.deepwiki.com/mcp"
-        },
-        "microsoft.docs.mcp": {
+        "bitplatform": {
             "type": "http",
-            "url": "https://learn.microsoft.com/api/mcp"
+            "url": "https://bitplatform.dev/mcp"
         },
         "github": {
             "type": "http",

src/Templates/Boilerplate/Bit.Boilerplate/.agents/skills/ai-dlc/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: ai-dlc
+description: Drives a feature end-to-end using the AI-Driven Development Lifecycle - requirements elaboration, planning and task decomposition, design, implementation, then validation - with explicit user approval before any code is written. Use when the user asks to build a feature properly/end-to-end, wants a structured dev cycle, asks for requirements-then-plan-then-implement, or says "run ai-dlc".
+---
+
+Read `.github/agents/ai-dlc.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.agents/skills/bitify-ui/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bitify-ui
+description: Modernizes Blazor pages by replacing raw HTML elements and custom CSS with Bit.BlazorUI components and theme-aware styling, using the bit BlazorUI MCP tools to discover components and verify their exact APIs. Use when the user asks to bitify a page, replace HTML/div/button/input markup with Bit components, remove hardcoded colors, make a page theme-aware or dark-mode ready, or says "run bitify".
+---
+
+Read `.github/agents/bitify-ui.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.agents/skills/code-reviewer/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: code-reviewer
+description: Reviews code changes against this project's conventions - Bit.BlazorUI usage, theming, enhanced lifecycle methods, WrapHandled, Mapperly, OData, structured logging, nullable awareness, security and concurrency. Reports findings only and never modifies code. Use when the user asks to review changes, review a diff or PR, check code against project conventions, or says "run code review".
+context: fork
+---
+
+Read `.github/agents/code-reviewer.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.agents/skills/localize-strings/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: localize-strings
+description: Moves hardcoded user-facing strings out of Razor/C# files into AppStrings.resx and rewrites the call sites to use IStringLocalizer with nameof(AppStrings.Key). Use when the user explicitly asks to localize a page or component, extract hardcoded text, apply translations, fix missing resource strings, or says "run resx" / "move these strings to resx".
+---
+
+Read `.github/agents/localize-strings.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.agents/skills/scaffold-entity/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: scaffold-entity
+description: Scaffolds a complete CRUD entity across every layer of the Boilerplate solution - entity model, EF Core configuration and migration, DTO, Mapperly mapper, API controller, IAppController interface, AppStrings resource entries, Blazor grid and add/edit pages, and navigation integration. Use when the user asks to add a new entity, add a new feature with CRUD, scaffold a table/model, or says "run scaffold" / "scaffold Product".
+---
+
+Read `.github/agents/scaffold-entity.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.claude/skills/ai-dlc/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: ai-dlc
+description: Drives a feature end-to-end using the AI-Driven Development Lifecycle - requirements elaboration, planning and task decomposition, design, implementation, then validation - with explicit user approval before any code is written. Use when the user asks to build a feature properly/end-to-end, wants a structured dev cycle, asks for requirements-then-plan-then-implement, or says "run ai-dlc".
+---
+
+Read `.github/agents/ai-dlc.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.claude/skills/bitify-ui/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bitify-ui
+description: Modernizes Blazor pages by replacing raw HTML elements and custom CSS with Bit.BlazorUI components and theme-aware styling, using the bit BlazorUI MCP tools to discover components and verify their exact APIs. Use when the user asks to bitify a page, replace HTML/div/button/input markup with Bit components, remove hardcoded colors, make a page theme-aware or dark-mode ready, or says "run bitify".
+---
+
+Read `.github/agents/bitify-ui.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.claude/skills/code-reviewer/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: code-reviewer
+description: Reviews code changes against this project's conventions - Bit.BlazorUI usage, theming, enhanced lifecycle methods, WrapHandled, Mapperly, OData, structured logging, nullable awareness, security and concurrency. Reports findings only and never modifies code. Use when the user asks to review changes, review a diff or PR, check code against project conventions, or says "run code review".
+context: fork
+---
+
+Read `.github/agents/code-reviewer.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.claude/skills/localize-strings/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: localize-strings
+description: Moves hardcoded user-facing strings out of Razor/C# files into AppStrings.resx and rewrites the call sites to use IStringLocalizer with nameof(AppStrings.Key). Use when the user explicitly asks to localize a page or component, extract hardcoded text, apply translations, fix missing resource strings, or says "run resx" / "move these strings to resx".
+---
+
+Read `.github/agents/localize-strings.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.claude/skills/scaffold-entity/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: scaffold-entity
+description: Scaffolds a complete CRUD entity across every layer of the Boilerplate solution - entity model, EF Core configuration and migration, DTO, Mapperly mapper, API controller, IAppController interface, AppStrings resource entries, Blazor grid and add/edit pages, and navigation integration. Use when the user asks to add a new entity, add a new feature with CRUD, scaffold a table/model, or says "run scaffold" / "scaffold Product".
+---
+
+Read `.github/agents/scaffold-entity.agent.md` (relative to the repository root) and follow it exactly.

src/Templates/Boilerplate/Bit.Boilerplate/.cursor/mcp.json

@@ -0,0 +1,25 @@
+{
+    "mcpServers": {
+        "bitplatform": {
+            "url": "https://bitplatform.dev/mcp"
+        },
+        "aspire": {
+            "command": "aspire",
+            "args": [
+                "agent",
+                "mcp"
+            ]
+        },
+        "playwright": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "@playwright/mcp@latest",
+                "--output-dir",
+                ".playwright-mcp",
+                "--output-max-size",
+                "52428800"
+            ]
+        }
+    }
+}

src/Templates/Boilerplate/Bit.Boilerplate/.devcontainer/devcontainer.json

@@ -4,7 +4,6 @@
     "hostRequirements": {
         "cpus": 4
     },
-    "onCreateCommand": "dotnet workload install wasm-tools",
     "waitFor": "onCreateCommand",
     "postCreateCommand": "dotnet dev-certs https --trust",
     "customizations": {
@@ -15,8 +14,6 @@
         },
         "vscode": {
             "extensions": [
-                "GitHub.copilot",
-                "GitHub.copilot-chat",
                 "ms-dotnettools.csharp",
                 "Anthropic.claude-code",
                 "ms-dotnettools.csdevkit",
@@ -38,10 +35,11 @@
     ],
     "features": {
         "ghcr.io/microsoft/aspire-devcontainer-feature/aspire:2": {},
-        "ghcr.io/devcontainers/features/python:1": {},
         "ghcr.io/devcontainers/features/powershell:2": {},
         "ghcr.io/devcontainers/features/docker-in-docker:4": {},
-        "ghcr.io/devcontainers/features/node:2": { "version": "24" },
+        "ghcr.io/devcontainers/features/node:2": {
+            "version": "24"
+        },
         "ghcr.io/devcontainers/features/kubectl-helm-minikube:1": {
             "version": "1",
             "helm": "3",

src/Templates/Boilerplate/Bit.Boilerplate/.docs/00- Wiki.md

@@ -10,12 +10,12 @@ This project includes **25 comprehensive documentation files** in the `.docs/` f
 
 If you have questions or need assistance:
 
-### 1. 🤖 **GitHub Copilot (Agent Mode)**
-   - Ask questions directly in your IDE using GitHub Copilot in Agent Mode
+### 1. 🤖 **Your AI Coding Agent**
+   - Ask questions directly in your IDE using GitHub Copilot (Agent Mode), Claude Code, Cursor, Gemini, Antigravity, Codex, Junie or Windsurf - this project ships shared instructions (`AGENTS.md`) and Agent Skills (`.agents/skills/`) that all of them understand
    - Get instant, context-aware answers about the project
 
-### 2. 🌐 **Interactive Wiki**
-   - Visit: **[https://wiki.bitplatform.dev](https://wiki.bitplatform.dev)**
+### 2. 🌐 **Ask AI on bitplatform.dev**
+   - Visit: **[https://bitplatform.dev/ask](https://bitplatform.dev/ask)**
    - Ask questions and get AI-powered answers
 
 ### 3. 🐛 **GitHub Issues**

src/Templates/Boilerplate/Bit.Boilerplate/.docs/01- Entity Framework Core.md

@@ -476,6 +476,8 @@ For comprehensive information about the client-side offline database, including:
 
 ---
 
-Ask your question [here](https://wiki.bitplatform.dev)
+### AI Wiki
 
----
+Ask your own question [here](https://bitplatform.dev/ask)
+
+---

src/Templates/Boilerplate/Bit.Boilerplate/.docs/02- DTOs, Mappers, and Mapperly.md

@@ -366,3 +366,9 @@ private async Task SaveProfile()
 ```
 
 ---
+
+### AI Wiki
+
+Ask your own question [here](https://bitplatform.dev/ask)
+
+---

src/Templates/Boilerplate/Bit.Boilerplate/.docs/03- API Controllers and OData.md

@@ -895,3 +895,9 @@ While the architecture is simple, the backend still includes many advanced featu
 Feel free to restructure the backend however you see fit. The template provides a solid foundation and advanced features, but you're in control of the architecture.
 
 ---
+
+### AI Wiki
+
+Ask your own question [here](https://bitplatform.dev/ask)
+
+---

src/Templates/Boilerplate/Bit.Boilerplate/.docs/04- Background Jobs and CancellationToken Management.md

@@ -448,6 +448,8 @@ The job runner is registered as a scoped service so it has access to all the sam
 
 ---
 
-Ask your own question [here](https://wiki.bitplatform.dev)
+### AI Wiki
+
+Ask your own question [here](https://bitplatform.dev/ask)
 
 ---

src/Templates/Boilerplate/Bit.Boilerplate/.docs/05- Localization and Multi-language Support.md

@@ -696,3 +696,9 @@ from the URL first, then the stored preference, then the OS/browser settings (se
 `AppClientCoordinator.ConfigureUISetup`).
 
 ---
+
+### AI Wiki
+
+Ask your own question [here](https://bitplatform.dev/ask)
+
+---

src/Templates/Boilerplate/Bit.Boilerplate/.docs/06- Exception Handling and Error Management.md

@@ -610,8 +610,8 @@ and pre-rendering.
 
 ---
 
-### AI Wiki: Answered Questions
+### AI Wiki
 
-Ask your own question [here](https://wiki.bitplatform.dev)
+Ask your own question [here](https://bitplatform.dev/ask)
 
 ---

src/Templates/Boilerplate/Bit.Boilerplate/.docs/07- ASP.NET Core Identity - Authentication & Authorization.md

@@ -362,8 +362,8 @@ Run the project and walk through these - it is faster than reading:
 password and OTP sign-in, 2FA, session management and revocation, password reset, roles and permissions, external
 providers, privileged sessions and elevated access.
 
-### AI Wiki: answered questions
+### AI Wiki
 
-Ask your own question [here](https://wiki.bitplatform.dev).
+Ask your own question [here](https://bitplatform.dev/ask)
 
 ---