diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
index 6085942..514ebd5 100644
--- a/.github/copilot-instructions.md
+++ b/.github/copilot-instructions.md
@@ -85,3 +85,10 @@ Custom xUnit attributes are sometimes used for conditional test execution:
 - All PRs must pass format validation
 - Tests must pass on all target frameworks
 - Follow existing patterns and conventions in the codebase
+
+## Documenting Work
+
+Project implemention details, design and key decisions should be documented in a top-level AGENTS.md file at the repo root. 
+Keep this file updated whenever you make change significant changes for future reference.
+
+User-facing features and APIs should be documented to highlight (not extensively, as an overview) key project features and capabilities, in the readme.md file at the repo root.
diff --git a/.netconfig b/.netconfig
index b10c4fe..972b0a5 100644
--- a/.netconfig
+++ b/.netconfig
@@ -158,6 +158,6 @@
 	weak
 [file ".github/copilot-instructions.md"]
 	url = https://github.com/devlooped/oss/blob/main/.github/copilot-instructions.md
-	sha = b9552b14bc75b7e1e03efbc3fb3519e80283dfa5
-	etag = 3a4d3034e7c2e8489e44b62b44ebb40f06b6400bf8cf633ebf99ab023fe38505
+	sha = e616d89d9537c4b8ccf1c20dd277ab82104167c4
+	etag = 6ee650d118a57494d3545d54718ccaa5257b09d54504e9c21514fe596edd9678
 	weak