diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 00000000..38846644
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1 @@
+Follow the instructions in [AGENTS.md](../AGENTS.md).
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..8f048f5d
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,19 @@
+# Agents
+
+This repository contains [Process-PSModule](https://msxorg.github.io/docs/Frameworks/Process-PSModule/), the PSModule automation workflow framework.
+
+## Start here
+
+1. Read this file, then [README.md](README.md) for repository purpose and scope.
+2. Read the [PSModule documentation](https://psmodule.io/docs) for framework-level standards.
+3. Read the [MSX documentation](https://msxorg.github.io/docs) for organization-level principles and guidance.
+
+## Working in this repository
+
+- Keep guidance and examples consistent with the documented framework behavior.
+- Prefer explicit, deterministic automation patterns in CI/CD changes.
+- Treat tests and sample repositories under `tests/` as contract coverage for workflow behavior.
+
+## The rule
+
+This file points; it never defines. Standards and process belong to canonical docs and should be linked, not restated.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..43c994c2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md