diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..34482eb82
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,15 @@
+# Agent entry point
+
+Start at the [Knowledge Bundle Index](okf-bundle/index.md).
+
+**Before editing documentation:** read the [Documentation Policy](okf-bundle/documentation-policy.md).
+
+For testing or module work, also read:
+
+* [Change Authoring Workflow](okf-bundle/testing/change-authoring-workflow.md): verified change loop
+* [Agent Command Policy](okf-bundle/testing/agent-command-policy.md): allowlisted shell commands
+* [Validation Checklist](okf-bundle/testing/validation-checklist.md): assemble, checkstyle, unit tests, e2e
+
+Human onboarding (JDK, Android Studio, `./scripts/build.sh`): [CONTRIBUTING.md](CONTRIBUTING.md) owns that content; do not duplicate here.
+
+User-facing product behavior: [README.md](README.md) and [GETTING_STARTED.md](GETTING_STARTED.md) own that content; do not duplicate here.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..3023b3d51
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+Read [AGENTS.md](AGENTS.md) first. Follow it for this repository.