From a1b4e381e68be1e8ea49c7ef1aea5dd698635fb2 Mon Sep 17 00:00:00 2001
From: Alan Agius <17563226+alan-agius4@users.noreply.github.com>
Date: Sat, 25 Oct 2025 10:01:28 +0000
Subject: [PATCH] build: refactor location of best-practices.md

This commit moves the best-practices.md file from adev/src/context to packages/core/resources. The BUILD.bazel files and other configuration files have been updated to reflect this change.

(cherry picked from commit 25e8bcbdf6363b0dcc64d5a6d26b4ec3005da021)
---
 adev/src/assets/BUILD.bazel                       |  1 +
 adev/src/content/ai/BUILD.bazel                   |  1 +
 adev/src/content/ai/develop-with-ai.md            |  2 +-
 packages/core/BUILD.bazel                         |  1 +
 packages/core/package.json                        |  6 ++++++
 packages/core/resources/BUILD.bazel               | 15 +++++++++++++++
 .../core/resources}/best-practices.md             |  0
 7 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 packages/core/resources/BUILD.bazel
 rename {adev/src/context => packages/core/resources}/best-practices.md (100%)

diff --git a/adev/src/assets/BUILD.bazel b/adev/src/assets/BUILD.bazel
index c87a1f0aaed..d1f07ab7984 100644
--- a/adev/src/assets/BUILD.bazel
+++ b/adev/src/assets/BUILD.bazel
@@ -134,6 +134,7 @@ copy_to_directory(
     srcs = [
         "//adev/src/context",
         "//adev/src/context:llms_full",
+        "//packages/core/resources:best-practices.md",
     ],
     replace_prefixes = {
         "**/": "",
diff --git a/adev/src/content/ai/BUILD.bazel b/adev/src/content/ai/BUILD.bazel
index 3c1ce7ede22..0ed43c77fbe 100644
--- a/adev/src/content/ai/BUILD.bazel
+++ b/adev/src/content/ai/BUILD.bazel
@@ -9,6 +9,7 @@ generate_guides(
     data = [
         "//adev/src/assets/images:what_is_angular.svg",
         "//adev/src/context",
+        "//packages/core/resources:best-practices.md",
     ],
     visibility = ["//adev:__subpackages__"],
 )
diff --git a/adev/src/content/ai/develop-with-ai.md b/adev/src/content/ai/develop-with-ai.md
index f3567aad313..67caa036f7e 100644
--- a/adev/src/content/ai/develop-with-ai.md
+++ b/adev/src/content/ai/develop-with-ai.md
@@ -10,7 +10,7 @@ NOTE: These files will be updated on a regular basis staying up to date with Ang
 
 Here is a set of instructions to help LLMs generate correct code that follows Angular best practices. This file can be included as system instructions to your AI tooling or included along with your prompt as context.
 
-<docs-code language="md" path="adev/src/context/best-practices.md" class="compact"/>
+<docs-code language="md" path="packages/core/resources/best-practices.md" class="compact"/>
 
 <a download href="/assets/context/best-practices.md" target="_blank">Click here to download the best-practices.md file.</a>
 
diff --git a/packages/core/BUILD.bazel b/packages/core/BUILD.bazel
index 8a3049419b5..cbae25a6d81 100644
--- a/packages/core/BUILD.bazel
+++ b/packages/core/BUILD.bazel
@@ -58,6 +58,7 @@ ng_package(
     srcs = [
         "package.json",
         ":event_dispatch_contract_binary",
+        "//packages/core/resources",
     ],
     nested_packages = [
         "//packages/core/schematics:npm_package",
diff --git a/packages/core/package.json b/packages/core/package.json
index da833ff95b9..c23d43b6a95 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -40,6 +40,12 @@
     "migrations": "./schematics/migrations.json",
     "packageGroup": "NG_UPDATE_PACKAGE_GROUP"
   },
+  "angular": {
+    "bestPractices": {
+      "format": "markdown",
+      "path": "./resources/best-practices.md"
+    }
+  },
   "schematics": "./schematics/collection.json",
   "sideEffects": false
 }
diff --git a/packages/core/resources/BUILD.bazel b/packages/core/resources/BUILD.bazel
new file mode 100644
index 00000000000..4fabaefae64
--- /dev/null
+++ b/packages/core/resources/BUILD.bazel
@@ -0,0 +1,15 @@
+exports_files(
+    srcs = ["best-practices.md"],
+    visibility = [
+        "//adev/src/assets:__pkg__",
+        "//adev/src/content/ai:__pkg__",
+    ],
+)
+
+filegroup(
+    name = "resources",
+    srcs = ["best-practices.md"],
+    visibility = [
+        "//packages/core:__pkg__",
+    ],
+)
diff --git a/adev/src/context/best-practices.md b/packages/core/resources/best-practices.md
similarity index 100%
rename from adev/src/context/best-practices.md
rename to packages/core/resources/best-practices.md