diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Application/G5e.AzureDevOpsServerMCP.Application.csproj b/dotnet/src/G5e.AzureDevOpsServerMCP.Application/G5e.AzureDevOpsServerMCP.Application.csproj
index e08e1b4a..0e78198a 100644
--- a/dotnet/src/G5e.AzureDevOpsServerMCP.Application/G5e.AzureDevOpsServerMCP.Application.csproj
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Application/G5e.AzureDevOpsServerMCP.Application.csproj
@@ -3,8 +3,13 @@
   <PropertyGroup>
     <PackageId>G5e.AzureDevOpsServerMCP.Application</PackageId>
     <Description>Application contracts and result models for the G5e Azure DevOps Server MCP packages.</Description>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\G5e.AzureDevOpsServerMCP.Domain\G5e.AzureDevOpsServerMCP.Domain.csproj" />
   </ItemGroup>
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Application/README.md b/dotnet/src/G5e.AzureDevOpsServerMCP.Application/README.md
new file mode 100644
index 00000000..66930bc7
--- /dev/null
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Application/README.md
@@ -0,0 +1,22 @@
+# G5e.AzureDevOpsServerMCP.Application
+
+Application contracts and result models for the **G5e Azure DevOps Server MCP** packages.
+
+This package defines the application-layer interfaces, use-case contracts, and result/DTO types consumed by the MCP tool implementations and infrastructure layers.
+
+## Part of the G5e.AzureDevOpsServerMCP family
+
+| Package | Description |
+|---|---|
+| `G5e.AzureDevOpsServerMCP.Domain` | Core domain abstractions |
+| `G5e.AzureDevOpsServerMCP.Application` | Application contracts and result models |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.Configuration` | Configuration types |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps` | Azure DevOps client implementations |
+| `G5e.AzureDevOpsServerMCP.Tools` | MCP tool implementations |
+| `G5e.AzureDevOpsServerMCP.AspNetCore` | ASP.NET Core integration package |
+
+## Background
+
+This project is part of a fork of [microsoft/azure-devops-mcp](https://github.com/microsoft/azure-devops-mcp), focused on making Azure DevOps MCP Server functionality available as reusable .NET/NuGet packages, with support for Azure DevOps Server (on-prem) scenarios.
+
+For more information, see the [fork notes](https://github.com/gadeynebram/AzureDevOpsServerMCP/blob/main/README_FORK.md).
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/G5e.AzureDevOpsServerMCP.Domain.csproj b/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/G5e.AzureDevOpsServerMCP.Domain.csproj
index d881b880..c61b845d 100644
--- a/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/G5e.AzureDevOpsServerMCP.Domain.csproj
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/G5e.AzureDevOpsServerMCP.Domain.csproj
@@ -1,10 +1,15 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
 	<PropertyGroup>
 		<PackageId>G5e.AzureDevOpsServerMCP.Domain</PackageId>
 		<Description>Domain abstractions for the G5e Azure DevOps Server MCP packages.</Description>
+		<PackageReadmeFile>README.md</PackageReadmeFile>
 	</PropertyGroup>
 
+	<ItemGroup>
+		<None Include="README.md" Pack="true" PackagePath="\" />
+	</ItemGroup>
+
 	<ItemGroup>
 		<PackageReference Include="MinVer" PrivateAssets="All" />
 	</ItemGroup>
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/README.md b/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/README.md
new file mode 100644
index 00000000..d3fbfcc2
--- /dev/null
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Domain/README.md
@@ -0,0 +1,22 @@
+# G5e.AzureDevOpsServerMCP.Domain
+
+Domain abstractions for the **G5e Azure DevOps Server MCP** packages.
+
+This package defines the core domain interfaces and models shared across all other G5e.AzureDevOpsServerMCP packages. It has no external runtime dependencies and is designed to be referenced by application and infrastructure layers.
+
+## Part of the G5e.AzureDevOpsServerMCP family
+
+| Package | Description |
+|---|---|
+| `G5e.AzureDevOpsServerMCP.Domain` | Core domain abstractions |
+| `G5e.AzureDevOpsServerMCP.Application` | Application contracts and result models |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.Configuration` | Configuration types |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps` | Azure DevOps client implementations |
+| `G5e.AzureDevOpsServerMCP.Tools` | MCP tool implementations |
+| `G5e.AzureDevOpsServerMCP.AspNetCore` | ASP.NET Core integration package |
+
+## Background
+
+This project is part of a fork of [microsoft/azure-devops-mcp](https://github.com/microsoft/azure-devops-mcp), focused on making Azure DevOps MCP Server functionality available as reusable .NET/NuGet packages, with support for Azure DevOps Server (on-prem) scenarios.
+
+For more information, see the [fork notes](https://github.com/gadeynebram/AzureDevOpsServerMCP/blob/main/README_FORK.md).
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps.csproj b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps.csproj
index 0a951941..0e7e88ce 100644
--- a/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps.csproj
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps.csproj
@@ -3,8 +3,13 @@
   <PropertyGroup>
     <PackageId>G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps</PackageId>
     <Description>Azure DevOps client implementations for the G5e Azure DevOps Server MCP packages.</Description>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\G5e.AzureDevOpsServerMCP.Application\G5e.AzureDevOpsServerMCP.Application.csproj" />
     <ProjectReference Include="..\G5e.AzureDevOpsServerMCP.Infrastructure.Configuration\G5e.AzureDevOpsServerMCP.Infrastructure.Configuration.csproj" />
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/README.md b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/README.md
new file mode 100644
index 00000000..ef61396c
--- /dev/null
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps/README.md
@@ -0,0 +1,22 @@
+# G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps
+
+Azure DevOps client implementations for the **G5e Azure DevOps Server MCP** packages.
+
+This package implements the application-layer interfaces using `Microsoft.TeamFoundationServer.Client` and `Microsoft.VisualStudio.Services.Client`, providing connectivity to both Azure DevOps Services and Azure DevOps Server (on-prem).
+
+## Part of the G5e.AzureDevOpsServerMCP family
+
+| Package | Description |
+|---|---|
+| `G5e.AzureDevOpsServerMCP.Domain` | Core domain abstractions |
+| `G5e.AzureDevOpsServerMCP.Application` | Application contracts and result models |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.Configuration` | Configuration types |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps` | Azure DevOps client implementations |
+| `G5e.AzureDevOpsServerMCP.Tools` | MCP tool implementations |
+| `G5e.AzureDevOpsServerMCP.AspNetCore` | ASP.NET Core integration package |
+
+## Background
+
+This project is part of a fork of [microsoft/azure-devops-mcp](https://github.com/microsoft/azure-devops-mcp), focused on making Azure DevOps MCP Server functionality available as reusable .NET/NuGet packages, with support for Azure DevOps Server (on-prem) scenarios.
+
+For more information, see the [fork notes](https://github.com/gadeynebram/AzureDevOpsServerMCP/blob/main/README_FORK.md).
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration.csproj b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration.csproj
index b91d5920..6158cb4e 100644
--- a/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration.csproj
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration.csproj
@@ -1,10 +1,15 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
     <PackageId>G5e.AzureDevOpsServerMCP.Infrastructure.Configuration</PackageId>
     <Description>Configuration types for the G5e Azure DevOps Server MCP packages.</Description>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.Configuration" />
     <PackageReference Include="MinVer" PrivateAssets="All" />
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/README.md b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/README.md
new file mode 100644
index 00000000..ca3cc995
--- /dev/null
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Infrastructure.Configuration/README.md
@@ -0,0 +1,22 @@
+# G5e.AzureDevOpsServerMCP.Infrastructure.Configuration
+
+Configuration types for the **G5e Azure DevOps Server MCP** packages.
+
+This package provides the strongly-typed configuration models (e.g. connection settings) used to configure the Azure DevOps infrastructure layer. It integrates with `Microsoft.Extensions.Configuration`.
+
+## Part of the G5e.AzureDevOpsServerMCP family
+
+| Package | Description |
+|---|---|
+| `G5e.AzureDevOpsServerMCP.Domain` | Core domain abstractions |
+| `G5e.AzureDevOpsServerMCP.Application` | Application contracts and result models |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.Configuration` | Configuration types |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps` | Azure DevOps client implementations |
+| `G5e.AzureDevOpsServerMCP.Tools` | MCP tool implementations |
+| `G5e.AzureDevOpsServerMCP.AspNetCore` | ASP.NET Core integration package |
+
+## Background
+
+This project is part of a fork of [microsoft/azure-devops-mcp](https://github.com/microsoft/azure-devops-mcp), focused on making Azure DevOps MCP Server functionality available as reusable .NET/NuGet packages, with support for Azure DevOps Server (on-prem) scenarios.
+
+For more information, see the [fork notes](https://github.com/gadeynebram/AzureDevOpsServerMCP/blob/main/README_FORK.md).
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/G5e.AzureDevOpsServerMCP.Tools.csproj b/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/G5e.AzureDevOpsServerMCP.Tools.csproj
index 312a1b3b..a50c8702 100644
--- a/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/G5e.AzureDevOpsServerMCP.Tools.csproj
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/G5e.AzureDevOpsServerMCP.Tools.csproj
@@ -3,8 +3,13 @@
   <PropertyGroup>
     <PackageId>G5e.AzureDevOpsServerMCP.Tools</PackageId>
     <Description>MCP tool implementations for the G5e Azure DevOps Server MCP packages.</Description>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="README.md" Pack="true" PackagePath="\" />
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\G5e.AzureDevOpsServerMCP.Application\G5e.AzureDevOpsServerMCP.Application.csproj" />
   </ItemGroup>
diff --git a/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/README.md b/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/README.md
new file mode 100644
index 00000000..5542fc78
--- /dev/null
+++ b/dotnet/src/G5e.AzureDevOpsServerMCP.Tools/README.md
@@ -0,0 +1,22 @@
+# G5e.AzureDevOpsServerMCP.Tools
+
+MCP tool implementations for the **G5e Azure DevOps Server MCP** packages.
+
+This package contains the `[McpServerTool]`-annotated tool classes that expose Azure DevOps operations (work items, repositories, pipelines, etc.) as MCP tools via the `ModelContextProtocol` runtime.
+
+## Part of the G5e.AzureDevOpsServerMCP family
+
+| Package | Description |
+|---|---|
+| `G5e.AzureDevOpsServerMCP.Domain` | Core domain abstractions |
+| `G5e.AzureDevOpsServerMCP.Application` | Application contracts and result models |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.Configuration` | Configuration types |
+| `G5e.AzureDevOpsServerMCP.Infrastructure.AzureDevOps` | Azure DevOps client implementations |
+| `G5e.AzureDevOpsServerMCP.Tools` | MCP tool implementations |
+| `G5e.AzureDevOpsServerMCP.AspNetCore` | ASP.NET Core integration package |
+
+## Background
+
+This project is part of a fork of [microsoft/azure-devops-mcp](https://github.com/microsoft/azure-devops-mcp), focused on making Azure DevOps MCP Server functionality available as reusable .NET/NuGet packages, with support for Azure DevOps Server (on-prem) scenarios.
+
+For more information, see the [fork notes](https://github.com/gadeynebram/AzureDevOpsServerMCP/blob/main/README_FORK.md).