Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: cheenamalhotra

.github/instructions/documentation.instructions.md

@@ -216,7 +216,9 @@ When creating samples for external documentation:
 
 ## Changelog Documentation
 
-When adding features, update CHANGELOG.md:
+Do not edit `CHANGELOG.md` directly. The changelog is updated as part of the release workflow based on the contents of `release-notes/` and the `release-notes` prompt.
+
+When adding features, fixes, or breaking changes, create or update the appropriate entry under `release-notes/` instead. For example:
 ```markdown
 ## [Unreleased]
 

.github/prompts/update-build-pipelines.prompt.md

@@ -56,7 +56,7 @@ Follow this workflow step-by-step:
 ## 5. Validate
 - Verify YAML syntax is valid.
 - Ensure no hardcoded values that should be parameterized.
-- Check that variable references use the correct syntax (`$(variable)` for compile-time, `${{ parameters.param }}` for template parameters).
+- Check that variable and parameter references use the correct syntax (`$(variable)` for runtime/macro variables, `${{ parameters.param }}` for compile-time/template parameters).
 - Confirm template references use correct relative paths.
 
 ## 6. Checklist

AGENTS.md

@@ -69,7 +69,7 @@ This repository provides reusable prompts in `.github/prompts/` for common maint
 3. Update reference assemblies if adding public APIs
 4. Implement with tests
 5. Add samples to `doc/samples/`
-6. Update CHANGELOG.md
+6. Do not edit `CHANGELOG.md` directly; instead, add a suggested release-note entry (per `.github/copilot-instructions.md`) in the PR description or via the release-notes workflow/prompt.
 
 ### Adding Connection String Keywords
 1. Add to `SqlConnectionStringBuilder`